核心代碼
import winsound
# 頻率 600Hz,持續 1000ms (1秒)
winsound.Beep(600, 1000)
參數詳解
- frequency (Hz):37 ~ 32767,超出範圍拋
ValueError
- duration (ms):毫秒數,
1000 = 1秒
進階:播放音樂音階
import winsound, time
NOTES = {
'C4': 262, 'D4': 294, 'E4': 330, 'F4': 349,
'G4': 392, 'A4': 440, 'B4': 494, 'C5': 523
}
def play(melody, tempo=120):
"""melody: [(note, beat), ...], beat=1 為四分音符"""
beat_ms = 60000 / tempo # 每拍毫秒數
for note, beats in melody:
freq = NOTES.get(note, 0)
if freq:
winsound.Beep(freq, int(beat_ms * beats * 0.9)) # 0.9 留間隙
else:
time.sleep(beat_ms * beats * 0.9) # 休止符
# 小星星
twinkle = [
('C4',1),('C4',1),('G4',1),('G4',1),('A4',1),('A4',1),('G4',2),
('F4',1),('F4',1),('E4',1),('E4',1),('D4',1),('D4',1),('C4',2)
]
play(twinkle, 100)
平台限制與替代方案
| 平台 | winsound.Beep | 替代方案 |
| Windows | ✅ 原生支持 | — |
| Linux/macOS | ❌ 無模塊 | os.system('beep -f 600 -l 1000') 需安裝 beep 包
print('\a') 終端蜂鳴
pygame.mixer/simpleaudio 播放 WAV |
常見錯誤
RuntimeError: Beep failed — 無蜂鳴器/主板蜂鳴器被禁用/遠程桌面會話無聲音設備
- 頻率/時長超出範圍 — 捕獲
ValueError