要在 App 裡播放音效或背景音樂,AVAudioPlayer 是最容易上手的選擇之一。它屬於 AVFoundation 框架,雖然功能不如專業播放器強大,卻在「播放單一音頻」這件事上做得相當出色。本文從它是什麼、適合什麼場景談起,再逐步示範完整用法。
AVAudioPlayer 是 AVFoundation.framework 裡最基本的音頻播放器類別。它與 MPMediaPlayerController 在一些基本操作上類似,例如 play、pause、volume 等。
不同之處在於,AVAudioPlayer 沒有「佇列」這個概念,也就是說它一次只能播放一個指定路徑的音頻。要播放多個音頻,可以建立多個 AVAudioPlayer。若要做完整的音樂播放器,AVFoundation 裡另有功能更強大的 AVQueuePlayer(QQ 音樂、酷狗這類應該都是用它)。
那 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 為完全右聲道。此外,它還能測量播放時各聲道的實時功率,可用來繪製聲音波形:
// audioPlayerOne 為一個 AVAudioPlayer 物件
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]; // 停止
有時我們需要在播放結束時做些處理,這時可設定 AVAudioPlayer 的 delegate:
// 完成播放
- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag {
if (flag) {
NSLog(@"play succeed");
}
}
// 播放中斷結束後(例如突然來電造成的中斷)
- (void)audioPlayerEndInterruption:(AVAudioPlayer *)player withOptions:(NSUInteger)flags {
// 可在此恢復播放
}
把這五個步驟串起來——設定 Session、初始化、配置參數、播放控制、處理回呼——你就能在 App 裡加入流暢的音頻體驗。記得播放前務必呼叫 prepareToPlay,這是新手最容易漏掉的一步。