AVAudioPlayer 是 AVFoundation.framework 中最基礎的音訊播放類別。它與 MPMediaPlayerController 在 play、pause、volume 等基礎操作上相當類似,但有一個關鍵差異:AVAudioPlayer 沒有播放隊列的概念,每一個物件只能播放一個指定路徑的音訊檔。
如果需要播放多首曲目,就必須建立多個 AVAudioPlayer 物件。若要做成真正的音樂播放器(例如串流、跨曲目無縫接續),更合適的選擇是 AVFoundation 中功能更完整的 AVQueuePlayer。
那麼 AVAudioPlayer 的用武之地在哪裡?它的定位介於 System Audio Services 與完整播放器之間:能播放單一音訊,同時提供了更細緻的控制能力——可以指定播放次數、可以調整播放速率、還能分別控制左右聲道的音量。最後這一點尤其好用,能輕鬆做出左右漂移的立體聲效果,因此在遊戲音效上非常實用。例如撲克牌遊戲洗牌時,就可以讓洗牌音效無限循環播放,直到洗牌動作結束為止。
只要使用 AVFoundation 播放音訊,就必須先設定 Audio Session,否則可能會遇到靜音鍵或來電後沒有聲音的問題(除非你完全採用系統預設行為)。
[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback error:nil];
NSURL *musicOneURL = [[NSBundle mainBundle] URLForResource:@"十年" withExtension:@"mp3"]; self.audioPlayerOne = [[AVAudioPlayer alloc] initWithContentsOfURL:musicOneURL error:nil];
AVAudioPlayer 有兩個特別值得一提的能力。
第一是 pan 屬性,可調整左右聲道平衡:值為 -1.0 時完全左聲道發音,1.0 時完全右聲道發音,0.0 則是置中。
第二是音量功率測量。開啟 meteringEnabled 後,即可讀取每個聲道即時的平均功率,這正是各家播放器繪製動態聲波的原理,若想做更進一步的聲音分析也是可行的起點。
self.audioPlayerOne.meteringEnabled = YES; // 允許測量 [self.audioPlayerOne updateMeters]; // 更新數據 [self.averagePowerChannelOne setValue:[self.audioPlayerOne averagePowerForChannel:0] animated:YES]; [self.averagePowerChannelTwo setValue:[self.audioPlayerOne averagePowerForChannel:1] animated:YES];
[self.audioPlayerOne prepareToPlay]; // 播放前必須準備 [self.audioPlayerOne setNumberOfLoops:-1]; // -1 代表無限循環 [self.audioPlayerOne setRate:1.5f]; // 播放速率 [self.audioPlayerOne setPan:1.0f]; // 左右聲道 [self.audioPlayerOne setCurrentTime:20.0f]; // 指定起始播放位置 [self.audioPlayerOne play]; // 播放 [self.audioPlayerOne pause]; // 暫停 [self.audioPlayerOne stop]; // 停止
要特別注意的是 prepareToPlay 不可省略,它會預先解碼並建立音訊管線,能大幅降低首次播放的延遲。
設定 delegate 後,就能在播放結束或播放被中斷時做出反應,例如來電導致的中斷。
// 完成播放
- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag {
if (flag) {
NSLog(@"play succeed");
}
}
// 中斷結束後恢復,例如一通突然來電造成的中斷
- (void)audioPlayerEndInterruption:(AVAudioPlayer *)player withOptions:(NSUInteger)flags {
[player play];
}
整體來說,AVAudioPlayer 的 API 設計相當直覺,適合音效、提示音、單曲播放等輕量情境;若需求升級為播放清單與跨曲控制,再改用 AVQueuePlayer 即可。