winsound
— Windows 声音播放接口
¶
winsound
模块提供对由 Windows 平台提供的基本声音播放机制的访问。它包括一些函数和几个常量。
winsound.
Beep
(
frequency
,
duration
)
¶
哔哔 PC 扬声器。
frequency
参数指定声音的频率 (以赫兹为单位)，且必须在 37 到 32,767 范围内。
duration
参数指定声音应该持续的毫秒数。若系统不能哔哔扬声器，
RuntimeError
被引发。
winsound.
PlaySound
(
sound
,
flags
)
¶
调用底层
PlaySound()
函数从平台 API。
sound
参数可以是文件名、系统声音别名、音频数据如
像字节对象
，或
None
。其解释从属值对于
flags
，可以是下文描述的常量的按位或组合。若
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_ALIAS
¶
sound
参数是来自注册表的声音关联名称。若注册表未包含这样的名称，播放系统默认声音，除非
SND_NODEFAULT
也有指定。若默认声音未注册，引发
RuntimeError
。不要使用同
SND_FILENAME
.
所有 Win32 系统至少支持以下；大多数系统支持更多：
|
|
相应的控制面板声音名称 |
|---|---|
|
|
星号 |
|
|
感叹号 |
|
|
退出 Windows |
|
|
严重错误停止 |
|
|
询问 |
例如：
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
¶
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
声音。