萬盛學電腦網

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

Python PyGame 播放音頻最小範例:三行代碼實現音樂播放

最小可行代碼


import pygame
pygame.init()
pygame.mixer.music.load("sound_file.ogg")
pygame.mixer.music.play()
pygame.event.wait()  # 阻塞主線程,等待播放結束或用戶關閉

關鍵步驟解析

  1. pygame.init():初始化所有 PyGame 子模組(音頻、視頻、事件等)。
  2. mixer.music.load():載入音頻檔(支援 OGG、MP3、WAV、MOD 等),流式播放,適合大檔案。
  3. mixer.music.play():開始播放,非阻塞立即返回。
  4. event.wait():阻塞等待事件(如播放結束 MUSIC_END、關閉視窗),防止主線程結束導致聲音中斷。

進階控制 API

方法功能
play(loops=0, start=0.0)loops=-1 循環播放,start 指定起始秒數
stop()立即停止
pause() / unpause()暫停/繼續
set_volume(0.0~1.0)音量控制
get_pos()獲取播放位置(毫秒)
queue(file)排隊下一首(無縫切換)

音效 vs 音樂

  • mixer.music:流式,適合長背景音樂,同一時間只能播一個。
  • mixer.Sound(file):全載入記憶體,適合短音效(槍聲、UI 音),可同時多聲道播放。
    
    shot = pygame.mixer.Sound('gunshot.wav')
    shot.play()  # 可同時多次 play()
        

常見問題

  • 無聲音:確認系統音頻輸出裝置、檔案路徑、格式支援(MP3 需 pygame.mixer.music 而非 Sound)。
  • 程序立即退出:必須有阻塞調用(event.wait()、time.sleep()、主迴圈)。
  • 多線程:PyGame 非線程安全,音頻操作請在主線程。

總結

PyGame mixer.music 以 5 行代碼實現音頻播放:初始化 → 載入 → 播放 → 阻塞等待。理解「音樂流式 vs 音效全載入」區別,即可覆蓋 90% Python 音頻播放場景。

copyright © 萬盛學電腦網 all rights reserved