上一话题

`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)

winsound. SND_LOOP ¶: 重复播放声音。 SND_ASYNC 标志还必须被使用以避免阻塞。无法使用同 SND_MEMORY .

winsound. SND_MEMORY ¶

The sound 参数用于 PlaySound() 是 WAV 文件的内存映像，作为像字节对象 .

注意

此模块不支持从内存映像异步播放，因此组合此标志和 SND_ASYNC 会引发 RuntimeError .

winsound. SND_PURGE ¶

停止播放指定声音的所有实例。

注意

现代 Windows 平台不支持此标志。

winsound. SND_ASYNC ¶: 立即返回，允许异步播放声音。

winsound. SND_NODEFAULT ¶: 若找不到指定声音，不播放系统默认声音。

winsound. SND_NOSTOP ¶: 不中断目前播放的声音。

winsound. SND_NOWAIT ¶

立即返回，若声音驱动程序繁忙。

注意

现代 Windows 平台不支持此标志。

winsound. MB_ICONASTERISK ¶: 播放 SystemDefault 声音。

winsound. MB_ICONEXCLAMATION ¶: 播放 SystemExclamation 声音。

winsound. MB_ICONHAND ¶: 播放 SystemHand 声音。

winsound. MB_ICONQUESTION ¶: 播放 SystemQuestion 声音。

winsound. MB_OK ¶: 播放 SystemDefault 声音。

上一话题

winreg — Windows 注册表访问

下一话题

Unix 特定服务