winsound —— Windows 系统的声音播放接口— Python 3.9.14 ...

文章推薦指數: 80 %
投票人數:10人

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系统相关模块» |



請為這篇文章評分?