萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python PyGame 播放音訊:MIDI、MP3、WAV 跨格式播放器

PyGame 音訊模組

pygame.mixer 提供音訊播放功能,支援 WAV、OGG、MP3 (需系統編解碼器)、MIDI (需 timidity 或 FluidSynth 後端)。

通用播放函式


import pygame as pg
import sys

def play_music(music_file, volume=0.8):
    """阻塞式播放音訊檔案"""
    # 初始化混音器 (頻率、位元深度、聲道、緩衝區)
    pg.mixer.init(frequency=44100, size=-16, channels=2, buffer=2048)
    pg.mixer.music.set_volume(volume)
    
    clock = pg.time.Clock()
    try:
        pg.mixer.music.load(music_file)
        print(f"載入: {music_file}")
    except pg.error as e:
        print(f"載入失敗: {music_file} - {e}")
        return
    
    pg.mixer.music.play()
    print("播放中... (Ctrl+C 停止)")
    
    try:
        while pg.mixer.music.get_busy():
            clock.tick(30)  # 限制輪詢頻率
    except KeyboardInterrupt:
        print("\n使用者中斷,淡出停止...")
        pg.mixer.music.fadeout(1000)
        pg.mixer.music.stop()
    finally:
        pg.mixer.quit()

if __name__ == '__main__':
    if len(sys.argv) < 2:
        print("用法: python play_audio.py <音訊檔案>")
        sys.exit(1)
    play_music(sys.argv[1])

混音器初始化參數詳解

參數預設值說明
frequency44100取樣率 (Hz),CD 品質 44100
size-16位元深度:正數=無號,負數=有號,16-bit 標準
channels21=單聲道,2=立體聲
buffer4096緩衝區大小 (樣本數),越小延遲越低但易斷音

多音效同時播放 (Sound 物件)


pg.mixer.init()
# 音效短小、需疊加播放用 Sound
shoot_sound = pg.mixer.Sound('shoot.wav')
explosion_sound = pg.mixer.Sound('explosion.ogg')

# 播放 (非阻塞)
shoot_sound.play()
explosion_sound.play()

# 音量控制
shoot_sound.set_volume(0.5)

# 等待播放結束 (可選)
while pg.mixer.get_busy():
    pg.time.wait(100)

MIDI 播放注意事項

  • Windows 內建 MIDI 合成器通常可直接播放 .mid。
  • Linux 需安裝 timidity 或 fluidsynth:sudo apt-get install timidity。
  • macOS 核心音訊支援 MIDI,但品質依賴音色庫。

常見問題排查

  • 無聲音:檢查系統音量、混音器初始化參數、檔案路徑。
  • MP3 不支援:確認 pygame 編譯時包含 MP3 支援,或轉碼為 OGG/WAV。
  • 阻塞主線程:遊戲主迴圈中勿使用 while get_busy() 阻塞,改用事件驅動或非阻塞檢查。
  • 資源釋放:程式結束前呼叫 pg.mixer.quit()。
copyright © 萬盛學電腦網 all rights reserved