โมดูล winsound เฉพาะสำหรับการติดตั้ง Python บนระบบปฏิบัติการ Windows โมดูลนี้กำหนดฟังก์ชันต่อไปนี้:
Beep()
เมื่อเรียกฟังก์ชันนี้ จะได้ยินเสียงบี๊บจากสปีกเกอร์ของ PC ฟังก์ชันต้องการสองพารามิเตอร์ พารามิเตอร์ frequency ระบุความถี่ของเสียง ต้องอยู่ในช่วง 37 ถึง 32,767 เฮิรตซ์ พารามิเตอร์ duration ระบุระยะเวลาของเสียงในมิลลิวินาที
>> import winsound >>> winsound.Beep(1000, 500)
MessageBeep()
ฟังก์ชันนี้เล่นเสียงตามที่ระบุในรีจิสทรี อาร์กิวเมนต์ type ระบุเสียงที่จะเล่น ค่าที่เป็นไปได้คือ:
-1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION, และ MB_OK (ค่าเริ่มต้น)
ค่า -1 สร้าง "simple beep"
>> winsound.MessageBeep()
PlaySound()
ฟังก์ชันนี้เรียกฟังก์ชัน PlaySound() ที่อยู่เบื้องล่างจาก Platform API ฟังก์ชันต้องการสองพารามิเตอร์ พารามิเตอร์ sound อาจเป็นชื่อไฟล์, อีลิแอสเสียงระบบ, หรือข้อมูลเสียงเป็นออบเจกต์คล้ายไบต์ การตีความขึ้นอยู่กับค่าของ flags flags กำหนดดังนี้:
| SND_FILENAME | พารามิเตอร์ sound คือชื่อไฟล์ WAV |
| SND_LOOP | เล่นเสียงซ้ำๆ |
| SND_MEMORY | พารามิเตอร์ sound ของ PlaySound() คือภาพหน่วยความจำของไฟล์ WAV เป็นออบเจกต์คล้ายไบต์ |
| SND_ASYNC | คืนค่าทันที อนุญาตให้เล่นเสียงแบบอะซิงโครนัส |
| SND_NODEFAULT | หากไม่พบเสียงที่ระบุ อย่าเล่นเสียงเริ่มต้นของระบบ |
| SND_NOSTOP | อย่าหยุดเสียงที่กำลังเล่นอยู่ |
คำสั่งต่อไปนี้เล่นไฟล์ WAV ที่กำหนด:
>> winsound.PlaySound('sample.wav', winsound.SND_FILENAME | winsound.SND_NOWAIT)
SND_ALIAS
คีย์รีจิสทรีของ Windows เชื่อมโยงกับชื่อเสียง หากรีจิสทรีไม่มีชื่อดังกล่าว ให้เล่นเสียงเริ่มต้นของระบบ เว้นแต่ SND_NODEFAULT ระบบ Win32 ทั้งหมดรองรับต่อไปนี้:
| PlaySound() name | Corresponding Control Panel Sound name |
|---|---|
| 'SystemAsterisk' | Asterisk |
| 'SystemExclamation' | Exclamation |
| 'SystemExit' | Exit Windows |
| 'SystemHand' | Critical Stop |
| 'SystemQuestion' | Question |
ตัวอย่าง คำสั่งต่อไปนี้เล่นเสียง Exit ของ Windows:
>> winsound.PlaySound("SystemExit", winsound.SND_ALIAS)
โมดูล winsound ยังกำหนดเสียงต่อไปนี้:
| MB_ICONASTERISK | เล่นเสียง SystemDefault |
| MB_ICONEXCLAMATION | เล่นเสียง SystemExclamation |
| MB_ICONHAND | เล่นเสียง SystemHand |
| MB_ICONQUESTION | เล่นเสียง SystemQuestion |
| MB_OK | เล่นเสียง SystemDefault |
