winsound —— Windows 系统的声音播放接口— Python 3.9.14 ...
文章推薦指數: 80 %
duration 参数则指定了声音应持续的毫秒数。
若系统无法让扬声器发声,则会触发 RuntimeError 。
winsound. PlaySound ( ...
瀏覽
索引
模組|
下一頁|
上一頁|
Python»
3.9.14Documentation»
Python標準函式庫(StandardLibrary)»
Windows系统相关模块»
|
winsound——Windows系统的声音播放接口¶
通过winsound模块可访问Windows平台的基础音频播放机制。
包括一些函数和几个常量。
winsound.Beep(frequency,duration)¶
让PC的扬声器发出提示音。
frequency参数可指定声音的频率,单位是赫兹,必须位于37到32,767之间。
duration参数则指定了声音应持续的毫秒数。
若系统无法让扬声器发声,则会触发RuntimeError。
winsound.PlaySound(sound,flags)¶
由平台API调用底层的PlaySound()函数。
参数sound可以是文件名、系统音频的别名、bytes-likeobject的音频数据或``None``。
如何解释取决于flags的值,可为以下常数的二进制OR组合。
如果sound参数为None,则当前播放的波形音频会全部停止。
如果系统报错,则会触发RuntimeError。
winsound.MessageBeep(type=MB_OK)¶
由平台API调用底层的MessageBeep()函数。
用于播放注册表中指定的音频。
type参数指定播放的音频;可能的值是-1、MB_ICONASTERISK、MB_ICONEXCLAMATION、MB_ICONHAND、MB_ICONQUESTION和MB_OK,下面会介绍。
值-1会生成一个"简单的嘀声";若其他的音频无法播放,这是最后的退路。
如果系统报错,则会触发RuntimeError。
winsound.SND_FILENAME¶
参数sound指明WAV文件名。
不要与SND_ALIAS一起使用。
winsound.SND_ALIAS¶
参数sound是注册表内关联的音频名称。
如果注册表中无此名称,则播放系统默认的声音,除非同时设定了SND_NODEFAULT。
如果没有注册默认声音,则会触发RuntimeError。
请勿与SND_FILENAME一起使用。
所有的Win32系统至少支持以下音频名称;大多数系统支持的音频都多于这些:
'SystemAsterisk'
星号
'SystemExclamation'
叹息声
'SystemExit'
退出Windows
'SystemHand'
关键性停止音
'SystemQuestion'
问题
例如:
importwinsound
#PlayWindowsexitsound.
winsound.PlaySound("SystemExit",winsound.SND_ALIAS)
#ProbablyplayWindowsdefaultsound,ifanyisregistered(because
#"*"probablyisn'ttheregisterednameofanysound).
winsound.PlaySound("*",winsound.SND_ALIAS)
winsound.SND_LOOP¶
循环播放音频。
为避免阻塞,必须同时使用SND_ASYNC标志。
不能与SND_MEMORY一起使用。
winsound.SND_MEMORY¶
PlaySound()的sound形参是一个WAV文件的内存镜像,作为一个bytes-likeobject。
備註
本模块不支持异步播放音频的内存镜像,所以该标志和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专有服务
本頁
回報錯誤
顯示原始碼
瀏覽
索引
模組|
下一頁|
上一頁|
Python»
3.9.14Documentation»
Python標準函式庫(StandardLibrary)»
Windows系统相关模块»
|
延伸文章資訊
- 1Play sound in Python - GeeksforGeeks
Play sound in Python · The playsound module contains only a single function named playsound(). · ...
- 2Play sound in Python
The playsound module is a cross platform module that can play audio files. This doesn't have any ...
- 3playsound - PyPI
Pure Python, cross platform, single function module with no dependencies for playing sounds.
- 4Python playsound - play mp3 sound files - CodersLegacy
The Python playsound library offers an easy and simple way to play sound files in Python. From al...
- 5playsound的简介、安装、使用方法之详细攻略 - CSDN博客
playsound的简介. 纯Python,跨平台,单功能模块,不依赖播放声音。 播放声音模块只包含一个东西——函数(也 ...