winsound — Windows 声音播放接口

The winsound 模块提供对由 Windows 平台提供的基本声音播放机制的访问。它包括一些函数和几个常量。

winsound. Beep ( frequency , duration )

哔哔 PC 扬声器。 frequency 参数指定声音的频率 (以赫兹为单位)，且必须在 37 到 32,767 范围内。 duration 参数指定声音应该持续的毫秒数。若系统无法蜂鸣扬声器， RuntimeError 被引发。

winsound. PlaySound ( sound , flags )

调用底层 PlaySound() 函数从平台 API。 sound 参数可以是文件名、系统声音别名、音频数据如 像字节对象 ，或 None 。其解释从属值对于 flags ，其可以是下文描述常量的按位 OR (或) 组合。若 sound 参数为 None ，停止目前播放的任何波形声音。若系统指示出错， RuntimeError 被引发。

winsound. MessageBeep ( type = MB_OK )

调用底层 MessageBeep() 函数从平台 API。这播放如注册表中的指定声音。 type 自变量指定要播放的声音；可能的值包括 -1 , MB_ICONASTERISK , MB_ICONEXCLAMATION , MB_ICONHAND , MB_ICONQUESTION ，和 MB_OK ，所有的描述见下文。值 -1 产生 "简单蜂鸣声"；这是最后回退，若声音无法以其它方式播放。若系统指示出错， RuntimeError 被引发。

winsound. SND_FILENAME

The sound 参数是 WAV 文件的名称。不要使用同 SND_ALIAS .

winsound. SND_ALIAS

The sound 参数是来自注册表的声音关联名称。若注册表未包含这样的名称，播放系统默认声音，除非 SND_NODEFAULT 也有指定。若默认声音未注册，引发 RuntimeError 。不要使用同 SND_FILENAME .

所有 Win32 系统至少支持以下；大多数系统支持更多：

PlaySound() name

相应的控制面板声音名称

'SystemAsterisk'

星号

'SystemExclamation'

感叹号

'SystemExit'

退出 Windows

'SystemHand'

严重错误停止

'SystemQuestion'

询问

例如： 

import winsound
# Play Windows exit sound.
winsound.PlaySound("SystemExit", winsound.SND_ALIAS)
# Probably play Windows default sound, if any is registered (because
# "*" probably isn't the registered name of any sound).
winsound.PlaySound("*", winsound.SND_ALIAS)