iOS 提供了多條音訊播放路徑,各自適用不同場景。本文聚焦兩個最常用的入門選項:適合短音效的 AudioServices,以及功能完整的 AVAudioPlayer。
對於「短、不需要混音」的提示音,AudioToolbox 框架提供了一組 C 風格的簡便 API。使用 AudioServices 播放系統音效必須遵守幾條限制:
除了這些限制,你對播放行為的控制力也相當有限:播放一出現就立即開始,音量跟隨通話使用者設定,無法循環、無法控制左右聲道。不過還是可以註冊一個回呼函式,在播放結束時被呼叫,以便做資源清理與後續通知。
#import <AudioToolbox/AudioToolbox.h>
#import <CoreFoundation/CoreFoundation.h>
// 播放完畢時的回呼
static void SoundFinished(SystemSoundID soundID, void *sample) {
/* 播放全部結束,釋放所有資源 */
AudioServicesDisposeSystemSoundID(soundID);
CFRelease(sample);
CFRunLoopStop(CFRunLoopGetCurrent());
}
// 主程式
int main() {
/* 系統音訊 ID,用來註冊我們將要播放的聲音 */
SystemSoundID soundID;
NSURL *sample = [[NSURL alloc] initWithString:@"sample.wav"];
OSStatus err = AudioServicesCreateSystemSoundID((__bridge CFURLRef)sample, &soundID);
if (err) {
NSLog(@"Error occurred assigning system sound!");
return -1;
}
/* 註冊播放結束的回呼 */
AudioServicesAddSystemSoundCompletion(soundID, NULL, NULL, SoundFinished, (__bridge_retained void *)sample);
/* 開始播放 */
AudioServicesPlaySystemSound(soundID);
CFRunLoopRun();
return 0;
}
表面上看這個服務有點雞肋,但它絕非無用武之地:當你要播放自訂的警告音、訊息提示音時,AudioServices 的資源佔用遠低於其他方案,是這個場景下的最佳選擇。
iOS 中播放音訊主要有三種方式:AVAudioPlayer、音訊服務(AudioServices)、音訊佇列(Audio Queue)。其中 AVAudioPlayer 位於 AVFoundation 框架,使用前需引入 AVFoundation.framework。
AVAudioPlayer 封裝了「播放單個聲音」的能力,可用 NSURL 或 NSData 初始化。但有個重要限制:NSURL 必須是本地檔案 URL,不能是網路位址——AVAudioPlayer 本身不具備串流播放網路音訊的能力。
一個 AVAudioPlayer 實例只能播放一個音訊。若要做混音,就建立多個實例,每個相當於混音盤上的一個音軌。
#import <AVFoundation/AVFoundation.h>
// 使用本地 URL 建立
NSError *err;
AVAudioPlayer *player = [[AVAudioPlayer alloc]
initWithContentsOfURL:[NSURL fileURLWithPath:
[[NSBundle mainBundle] pathForResource:@"music" ofType:@"m4a" inDirectory:@"/"]]
error:&err];
// 使用 NSData 建立
AVAudioPlayer *player2 = [[AVAudioPlayer alloc] initWithData:myData error:&err];
既然 AVAudioPlayer 吃 NSData,那麼「先從網路下載成 NSData 再播放」聽起來是個可行的繞道方案。理論上確實可行,但實務上不推薦:AVAudioPlayer 只能播放完整檔案,不支援串流,必須全數緩衝後才開始播放。網路檔案稍大或連線稍慢,使用者就會盯著轉圈等很久。要播放網路音訊,正確選擇是音訊佇列。
音量(0.0 ~ 1.0)
player.volume = 0.8;
循環次數(預設只播一次,設為負數代表無限循環)
player.numberOfLoops = 3;
播放位置(可指定從任意秒數開始)
player.currentTime = 15.0;
聲道數(唯讀)
NSUInteger channels = player.numberOfChannels;
總時長
NSTimeInterval duration = player.duration;
音量計(Metering)——可用來做波形視覺化或音量反應效果:
player.meteringEnabled = YES; // 開啟音量計功能
[player updateMeters]; // 更新讀數
// 讀取每個聲道的平均值與峰值,單位為分貝,範圍 -100 ~ 0
for (int i = 0; i < player.numberOfChannels; i++) {
float power = [player averagePowerForChannel:i];
float peak = [player peakPowerForChannel:i];
}
[player prepareToPlay]; // 配置播放所需資源並排入內部播放佇列 [player play]; // 開始播放 [player stop]; // 停止播放
prepareToPlay 常被忽略,但它能事先配置好資源,讓後續 play 的啟動延遲明顯降低——在需要「按下就立刻出聲」的場景(例如樂器 App、音效按鈕)尤其關鍵。
若播放過程發生異常,或被更高優先級的系統事件(來電、其他 App 搶佔音訊工作階段)打斷,若毫無準備,程式往往就這樣草草收場。AVAudioPlayerDelegate 提供了完整的處理接口。首先要設定代理:
player.delegate = self;
接著實作需要的回呼:
- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag {
// 播放結束時的處理
}
- (void)audioPlayerDecodeErrorDidOccur:(AVAudioPlayer *)player error:(NSError *)error {
// 解碼錯誤時的處理
}
- (void)audioPlayerBeginInterruption:(AVAudioPlayer *)player {
// 播放被中斷時的處理,例如來電
}
- (void)audioPlayerEndInterruption:(AVAudioPlayer *)player {
// 中斷結束後的處理
}
把這些代理方法實作完整,再搭配前述的屬性設定,一個堪用的本地音樂播放器雛形就完成了。若要進一步處理背景播放、鎖定螢幕控制或 Audio Session 分類,則需要進入 AVAudioSession 的領域。