import pygame
pygame.init()
pygame.mixer.music.load("sound_file.ogg")
pygame.mixer.music.play()
pygame.event.wait() # 阻塞主線程,等待播放結束或用戶關閉
pygame.init():初始化所有 PyGame 子模組(音頻、視頻、事件等)。mixer.music.load():載入音頻檔(支援 OGG、MP3、WAV、MOD 等),流式播放,適合大檔案。mixer.music.play():開始播放,非阻塞立即返回。event.wait():阻塞等待事件(如播放結束 MUSIC_END、關閉視窗),防止主線程結束導致聲音中斷。| 方法 | 功能 |
|---|---|
play(loops=0, start=0.0) | loops=-1 循環播放,start 指定起始秒數 |
stop() | 立即停止 |
pause() / unpause() | 暫停/繼續 |
set_volume(0.0~1.0) | 音量控制 |
get_pos() | 獲取播放位置(毫秒) |
queue(file) | 排隊下一首(無縫切換) |
mixer.music:流式,適合長背景音樂,同一時間只能播一個。mixer.Sound(file):全載入記憶體,適合短音效(槍聲、UI 音),可同時多聲道播放。
shot = pygame.mixer.Sound('gunshot.wav')
shot.play() # 可同時多次 play()
pygame.mixer.music 而非 Sound)。event.wait()、time.sleep()、主迴圈)。PyGame mixer.music 以 5 行代碼實現音頻播放:初始化 → 載入 → 播放 → 阻塞等待。理解「音樂流式 vs 音效全載入」區別,即可覆蓋 90% Python 音頻播放場景。