在 iOS 中播放本地音訊,常會使用 AVAudioPlayer。它屬於 AVFoundation 框架,適合播放時間較長的音樂檔。若是時間很短的音效,則可能會使用系統音訊服務。本文整理 AVAudioPlayer 的基本用法與常見注意事項。
使用 AVAudioPlayer 前,需要先匯入 AVFoundation。接著透過檔案 URL 建立播放器物件,並在播放前呼叫 prepareToPlay 進行準備。播放時呼叫 play,暫停時呼叫 pause,停止時則呼叫 stop。
一個常見錯誤是:把播放器建立成區域變數,導致方法結束後物件被釋放,音樂無法持續播放。因此,通常會把 AVAudioPlayer 宣告為類別的屬性,讓它的生命週期與控制器一致。若需要同時播放多個音訊,則需要建立多個播放器物件。
play 可以開始播放或從暫停處繼續;pause 會保留目前播放位置;stop 則會結束播放。需要注意的是,stop 之後若要再次播放,通常必須重新建立或重新設定播放器,否則可能出現狀態異常。
實務上,常會用懶加載的方式建立播放器,只在第一次需要時才初始化。這樣能避免不必要的資源佔用。停止播放後,也可以把播放器設為 nil,讓下次播放時重新建立,確保狀態乾淨。
整體而言,AVAudioPlayer 的 API 很直覺,但播放器的持有方式、停止後的重置,以及多檔案播放的處理,才是實務上容易忽略的細節。