winsound —— Windows 系統(tǒng)的音頻播放接口

---

通過 winsound 模塊可訪問 Windows 平臺的基礎(chǔ)音頻播放機(jī)制。包括一些函數(shù)和幾個常量。

為丹鳳等地區(qū)用戶提供了全套網(wǎng)頁設(shè)計制作服務(wù)，及丹鳳網(wǎng)站建設(shè)行業(yè)解決方案。主營業(yè)務(wù)為成都網(wǎng)站設(shè)計、網(wǎng)站制作、外貿(mào)營銷網(wǎng)站建設(shè)、丹鳳網(wǎng)站設(shè)計，以傳統(tǒng)方式定制建設(shè)網(wǎng)站，并提供域名空間備案等一條龍服務(wù)，秉承以專業(yè)、用心的態(tài)度為用戶提供真誠的服務(wù)。我們深信只要達(dá)到每一位用戶的要求，就會得到認(rèn)可，從而選擇與我們長期合作。這樣，我們也可以走得更遠(yuǎn)！

winsound.Beep(frequency, duration)

讓 PC 的揚(yáng)聲器發(fā)出提示音。frequency 參數(shù)可指定聲音的頻率，單位是赫茲，必須位于 37 到 32,767 之間。duration 參數(shù)則指定了聲音應(yīng)持續(xù)的毫秒數(shù)。若系統(tǒng)無法讓揚(yáng)聲器發(fā)聲，則會觸發(fā) RuntimeError。

winsound.PlaySound(sound, flags)

由平臺 API 調(diào)用底層的 PlaySound() 函數(shù)。 參數(shù) sound 可以是文件名、系統(tǒng)音頻的別名、bytes-like object 的音頻數(shù)據(jù)或``None``。 如何解釋取決于 flags 的值，可為以下常數(shù)的二進(jìn)制 OR 組合。 如果 sound 參數(shù)為 None，則當(dāng)前播放的波形音頻會全部停止。如果系統(tǒng)報錯， 則會觸發(fā) RuntimeError。

winsound.MessageBeep(type=MB_OK)

由平臺 API 調(diào)用底層的 MessageBeep() 函數(shù)。用于播放注冊表中指定的音頻。 type 參數(shù)指定播放的音頻；可能的值是 -1、MB_ICONASTERISK、MB_ICONEXCLAMATION、MB_ICONHAND、MB_ICONQUESTION 和 MB_OK，下面會介紹。值 -1 會生成一個 “簡單的嘀聲”；若其他的音頻無法播放，這是最后的退路。如果系統(tǒng)報錯，則會觸發(fā) RuntimeError 。

winsound.SND_FILENAME

參數(shù) sound 指明 WAV 文件名。不要與 SND_ALIAS 一起使用。

winsound.SND_ALIAS

參數(shù) sound 是注冊表內(nèi)關(guān)聯(lián)的音頻名稱。 如果注冊表中無此名稱，則播放系統(tǒng)默認(rèn)的聲音，除非同時設(shè)定了 SND_NODEFAULT 。 如果沒有注冊默認(rèn)聲音，則會觸發(fā) RuntimeError。 請勿與 SND_FILENAME 一起使用。

所有的 Win32 系統(tǒng)至少支持以下音頻名稱；大多數(shù)系統(tǒng)支持的音頻都多于這些：

PlaySound() name 參數(shù)	對應(yīng)的控制面板音頻名
‘SystemAsterisk’	星號
‘SystemExclamation’	感嘆號
‘SystemExit’	退出 Windows
‘SystemHand’	關(guān)鍵性停止
‘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

循環(huán)播放音頻。為避免阻塞，必須同時使用 SND_ASYNC 標(biāo)志。不能與 SND_MEMORY 一起使用。

winsound.SND_MEMORY

PlaySound() 的 sound 形參是一個 WAV 文件的內(nèi)存鏡像，作為一個 bytes-like object。

備注

本模塊不支持異步播放音頻的內(nèi)存鏡像，所以該標(biāo)志和 SND_ASYNC 的組合將觸發(fā) RuntimeError。

winsound.SND_PURGE

停止播放指定音頻的所有實(shí)例。

備注

新版 Windows 平臺不支持本標(biāo)志。

winsound.SND_ASYNC

立即返回，允許異步播放音頻。

winsound.SND_NODEFAULT

即便找不到指定的音頻，也不播放系統(tǒng)默認(rèn)音頻。

winsound.SND_NOSTOP

不打斷正在播放的音頻。

winsound.SND_NOWAIT

如果音頻驅(qū)動程序忙，則立即返回。

備注

新版 Windows 平臺不支持本標(biāo)志。

winsound.MB_ICONASTERISK

播放 SystemDefault 音頻。

winsound.MB_ICONEXCLAMATION

播放 SystemExclamation 音頻。

winsound.MB_ICONHAND

播放 SystemHand 音頻。

winsound.MB_ICONQUESTION

播放 SystemQuestion 音頻。

winsound.MB_OK

播放 SystemDefault 音頻。

新聞名稱：創(chuàng)新互聯(lián)Python教程：winsound——Windows系統(tǒng)的音頻播放接口
瀏覽地址：http://www.5511xx.com/article/dpscpos.html