對於「短、不需要混音」的提示音,AudioToolbox 提供了一組 C 風格的簡便介面,用 AudioServicesPlaySystemSound 就能發出聲音。使用上有幾個硬性限制:
1. 音檔長度須小於 30 秒。
2. 編碼僅支援 PCM 或 IMA4。
3. 檔案格式必須是 .caf、.aif 或 .wav。
4. 只能從磁碟檔案播放,無法直接在記憶體中播放。
除了這些限制,你對播放行為幾乎沒有控制權:聲音一出現就以「系統目前音量」播放,無法指定循環次數,也無法調整立體聲平衡。唯一能做的是註冊一個結束回呼,在播放完畢時進行資源清理。
#import <AudioToolbox/AudioToolbox.h>
#import <CoreFoundation/CoreFoundation.h>
// 播放結束後的回呼
static void SoundFinished(SystemSoundID soundID, void *sample) {
/* 播放全部結束,釋放資源 */
AudioServicesDisposeSystemSoundID(sample);
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 void *)sample);
/* 開始播放並進入 RunLoop 等待回呼 */
AudioServicesPlaySystemSound(soundID);
CFRunLoopRun();
return 0;
}
這組 API 看起來功能單薄,但在「自訂警示音」「訊息提示音」這類場景下,它比啟動一個完整播放器省資源得多,仍有其價值。
iOS 播放音訊大致有三條路:AVAudioPlayer、音訊服務與音訊佇列。AVAudioPlayer 位於 AVFoundation 框架,使用前需匯入 AVFoundation.framework。
它封裝了「播放單一檔案」的能力,可用 NSURL 或 NSData 初始化。要特別注意:NSURL 必須是本機檔案網址,AVAudioPlayer 本身不具備播放網路音訊的能力。一個 AVAudioPlayer 實例只負責一個音軌,若要混音,就建立多個實例,各自代表混音板上的一軌。
建立播放器
#import <AVFoundation/AVFoundation.h>
// 以本機 URL 建立
NSError *err;
AVAudioPlayer *player = [[AVAudioPlayer alloc]
initWithContentsOfURL:[NSURL fileURLWithPath:
[[NSBundle mainBundle] pathForResource:@"music" ofType:@"m4a"]]
error:&err];
// 以 NSData 建立
AVAudioPlayer *player2 = [[AVAudioPlayer alloc] initWithData:myData error:&err];
既然它吃 NSData,直覺上似乎可以「先下載成 NSData 再播放」來繞過網路限制。技術上可行,但並不實用:AVAudioPlayer 需要完整檔案才能播放,不支援串流,必須等整份下載完畢。檔案稍大或網速稍慢,使用者就得乾等。要播放網路音訊,請改用音訊佇列。
常用屬性
player.volume = 0.8; // 音量,0.0 ~ 1.0 player.numberOfLoops = 3; // 循環次數,預設只播一次(-1 代表無限循環) player.currentTime = 15.0; // 指定起始播放位置(秒) NSUInteger channels = player.numberOfChannels; // 聲道數,唯讀 NSTimeInterval duration = player.duration; // 音檔總長度
音量分析(VU 表):
player.meteringEnabled = YES; // 開啟計量
[player updateMeters]; // 更新讀數
// 平均電平與峰值電平,單位為分貝,範圍 -100 ~ 0
for (NSUInteger i = 0; i < player.numberOfChannels; i++) {
float power = [player averagePowerForChannel:i];
float peak = [player peakPowerForChannel:i];
}
播放控制
[player prepareToPlay]; // 配置播放資源並預先加入內部佇列 [player play]; // 開始播放 [player stop]; // 停止播放 [player pause]; // 暫停
prepareToPlay 可以提前完成解碼與資源配置,能明顯降低首次播放的延遲,建議在真正 play 之前呼叫。
代理方法
播放過程中可能遇到解碼失敗,或被來電等高優先級任務打斷。適度實作 delegate 能把這些收尾處理好:
player.delegate = self;
- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag {
// 播放結束
}
- (void)audioPlayerDecodeErrorDidOccur:(AVAudioPlayer *)player error:(NSError *)error {
// 解碼失敗
}
- (void)audioPlayerBeginInterruption:(AVAudioPlayer *)player {
// 播放被中斷(來電、其他 App 搶佔音訊工作階段)
}
- (void)audioPlayerEndInterruption:(AVAudioPlayer *)player withOptions:(NSUInteger)flags {
// 中斷結束,可視需要恢復播放
}
把這些拼起來,就足以做出一個可用的本機音樂播放器了。若要處理背景播放,還需要設定 AVAudioSession 的分類與啟用狀態。