這是《iOS 音頻播放》系列的第二篇。在動手寫播放的七個步驟之前,會先撞上一個繞不開的東西:AudioSession。
它的職責大致有三項:

相關的類別有兩個:AudioToolBox 中的 AudioSession(C API),以及 AVFoundation 中的 AVAudioSession(Objective-C)。前者在 SDK 7 已被標記為 deprecated,後者雖然從 iOS 3 就存在,但許多方法要到 iOS 6、7 才補齊。選擇標準很簡單:
AVAudioSession。AVAudioSession。以下以 AudioSession 為例說明(使用 AVAudioSession 的同學可以在其 header 中找到對應方法)。另外,用 AVAudioPlayer 或 AVPlayer 時不必操心 AudioSession 的細節,Apple 已經封裝好了,但「被打斷後的 UI 反應」仍要自己做。
extern OSStatus AudioSessionInitialize(CFRunLoopRef inRunLoop,
CFStringRef inRunLoopMode,
AudioSessionInterruptionListener inInterruptionListener,
void *inClientData);
typedef void (*AudioSessionInterruptionListener)(void *inClientData, UInt32 inInterruptionState);
前兩個參數一般傳 NULL,表示 AudioSession 跑在主執行緒上(不代表音頻處理也在主執行緒)。第三個參數是中斷回呼,第四個是回呼時要帶上的 context。
這裡有兩個坑。
第一,中斷回呼只能設定一次。 AudioSessionInitialize 可以被呼叫多次,但回呼永遠指向第一次註冊的那個函式。如果你的 App 同時有播放與錄音,兩個模組各自呼叫初始化、各自傳入不同的回呼,結果只有先註冊的那個會被觸發。解法是建立一個專門管理 AudioSession 的類別,統一接收回呼後轉發成自訂通知,各模組再訂閱自己關心的通知。
Apple 也意識到了這件事,所以 AVAudioSession 取消了 Initialize,改成 sharedInstance 單例;iOS 5 上仍要靠 delegate,iOS 6 之後終於改成通知形式。
第二,inClientData 的生命週期。 它存在的目的是讓回呼能拿到上下文,因此必須是一個夠長命的物件;若它被 dealloc 了,回呼時拿到的就是野指標。這又指向同一個結論:把 context 放在一個與 AudioSession 同壽命的單例類裡。
「拔掉耳機就暫停播放」要靠這個:
extern OSStatus AudioSessionAddPropertyListener(AudioSessionPropertyID inID,
AudioSessionPropertyListener inProc,
void *inClientData);
typedef void (*AudioSessionPropertyListener)(void *inClientData,
AudioSessionPropertyID inID,
UInt32 inDataSize,
const void *inData);
inID 傳 kAudioSessionProperty_AudioRouteChange,inProc 傳回呼。接到回呼時把 inData 轉成 CFDictionaryRef,取出 kAudioSession_AudioRouteChangeKey_Reason 對應的值,就能判斷發生什麼事。其中 kAudioSessionRouteChangeReason_OldDeviceUnavailable 正是「耳機被拔掉了」。
// AudioSession 的 RouteChangeReason
enum {
kAudioSessionRouteChangeReason_Unknown = 0,
kAudioSessionRouteChangeReason_NewDeviceAvailable = 1,
kAudioSessionRouteChangeReason_OldDeviceUnavailable = 2,
kAudioSessionRouteChangeReason_CategoryChange = 3,
kAudioSessionRouteChangeReason_Override = 4,
kAudioSessionRouteChangeReason_WakeFromSleep = 6,
kAudioSessionRouteChangeReason_NoSuitableRouteForCategory = 7,
kAudioSessionRouteChangeReason_RouteConfigurationChange = 8
};
// AVAudioSession 對應的版本
typedef NS_ENUM(NSUInteger, AVAudioSessionRouteChangeReason) {
AVAudioSessionRouteChangeReasonUnknown = 0,
AVAudioSessionRouteChangeReasonNewDeviceAvailable = 1,
AVAudioSessionRouteChangeReasonOldDeviceUnavailable = 2,
AVAudioSessionRouteChangeReasonCategoryChange = 3,
AVAudioSessionRouteChangeReasonOverride = 4,
AVAudioSessionRouteChangeReasonWakeFromSleep = 6,
AVAudioSessionRouteChangeReasonNoSuitableRouteForCategory = 7,
AVAudioSessionRouteChangeReasonRouteConfigurationChange NS_ENUM_AVAILABLE_IOS(7_0) = 8
};
iOS 6 之後直接監聽 AVAudioSession 的通知即可,不必再走 AddPropertyListener。
判斷是否插著耳機:
+ (BOOL)usingHeadset {
#if TARGET_IPHONE_SIMULATOR
return NO;
#endif
CFStringRef route;
UInt32 propertySize = sizeof(CFStringRef);
AudioSessionGetProperty(kAudioSessionProperty_AudioRoute, &propertySize, &route);
BOOL hasHeadset = NO;
if ((route == NULL) || (CFStringGetLength(route) == 0)) {
// 靜音模式
} else {
NSString *routeStr = (__bridge NSString *)route;
NSRange headphoneRange = [routeStr rangeOfString:@"Headphone"];
NSRange headsetRange = [routeStr rangeOfString:@"Headset"];
if (headphoneRange.location != NSNotFound) {
hasHeadset = YES;
} else if (headsetRange.location != NSNotFound) {
hasHeadset = YES;
}
}
if (route) {
CFRelease(route);
}
return hasHeadset;
}
判斷 AirPlay 是否啟用:
+ (BOOL)isAirplayActived {
CFDictionaryRef currentRouteDescriptionDictionary = nil;
UInt32 dataSize = sizeof(currentRouteDescriptionDictionary);
AudioSessionGetProperty(kAudioSessionProperty_AudioRouteDescription,
&dataSize, ¤tRouteDescriptionDictionary);
BOOL airplayActived = NO;
if (currentRouteDescriptionDictionary) {
CFArrayRef outputs = CFDictionaryGetValue(currentRouteDescriptionDictionary,
kAudioSession_AudioRouteKey_Outputs);
if (outputs != NULL && CFArrayGetCount(outputs) > 0) {
CFDictionaryRef currentOutput = CFArrayGetValueAtIndex(outputs, 0);
CFStringRef outputType = CFDictionaryGetValue(currentOutput,
kAudioSession_AudioRouteKey_Type);
airplayActived = (CFStringCompare(outputType, kAudioSessionOutputRoute_AirPlay, 0)
== kCFCompareEqualTo);
}
CFRelease(currentRouteDescriptionDictionary);
}
return airplayActived;
}
extern OSStatus AudioSessionSetProperty(AudioSessionPropertyID inID,
UInt32 inDataSize,
const void *inData);
// 純播放
UInt32 sessionCategory = kAudioSessionCategory_MediaPlayback;
AudioSessionSetProperty(kAudioSessionProperty_AudioCategory,
sizeof(sessionCategory), &sessionCategory);
AVAudioSession 的對應寫法:
- (BOOL)setCategory:(NSString *)category error:(NSError **)outError;
- (BOOL)setCategory:(NSString *)category
withOptions:(AVAudioSessionCategoryOptions)options
error:(NSError **)outError NS_AVAILABLE_IOS(6_0);
可用的 Category:
enum {
kAudioSessionCategory_AmbientSound = 'ambi', // 會被其他音樂壓過
kAudioSessionCategory_SoloAmbientSound = 'solo', // 會讓其他音樂停止
kAudioSessionCategory_MediaPlayback = 'medi', // 音樂播放
kAudioSessionCategory_RecordAudio = 'reca', // 錄音
kAudioSessionCategory_PlayAndRecord = 'plar', // 錄音兼播放
kAudioSessionCategory_AudioProcessing = 'proc'
};
Category 選錯會導致很難查的問題:例如忘了在背景播放時加上 kAudioSessionCategoryOptionsAllowBluetooth,藍牙耳機就會靜音;或選了 Ambient 卻期待靜音鍵不影響播放,行為永遠對不上。
// AudioSession
extern OSStatus AudioSessionSetActive(Boolean active);
extern OSStatus AudioSessionSetActiveWithFlags(Boolean active, UInt32 inFlags);
// AVAudioSession
- (BOOL)setActive:(BOOL)active error:(NSError **)outError;
- (BOOL)setActive:(BOOL)active
withOptions:(AVAudioSessionSetActiveOptions)options
error:(NSError **)outError NS_AVAILABLE_IOS(6_0);
啟動後一定要檢查回傳值,失敗很常見——例如有其他前景 App 正在播放,你的 App 在背景想啟動就會失敗。
一般情況用第一個方法即可。但如果你做的是即時語音通訊類 App(微信、易信那種),在 deactive 時必須用第二個方法並帶上 kAudioSessionSetActiveFlag_NotifyOthersOnDeactivation(AVAudioSession 傳 AVAudioSessionSetActiveOptionNotifyOthersOnDeactivation)。這樣其他 App 收到「中斷結束」時會多得到一個 ShouldResume 參數,得以判斷要不要繼續播放。
完整流程:

遺憾的是,實務上不少 App 並沒有正確實作這組旗標,於是使用者就會看到「用某語音軟件聽完一段話後音樂就不會恢復了」這類回報。
一個補充(2014.7 更新):即使曾經呼叫過 AudioSessionInitialize,在某些情況下被打斷後 AudioSession 仍可能失效,必須重新初始化,否則 AudioSessionSetActive 會回傳 560557673,轉成字串就是 !ini,也就是 kAudioSessionNotInitialized。這在 iOS 5.1.x 上比較容易發生,6.x 與 7.x 偶爾可見,推測與中斷時直接呼叫 AudioOutputUnitStop 有關。因此每次呼叫 AudioSessionSetActive 都該檢查錯誤碼,遇到這個值就重新初始化一次。
順手附上把 OSStatus 轉成可讀字串的寫法,除錯時非常有用:
#import <endian.h>
NSString *OSStatusToString(OSStatus status) {
size_t len = sizeof(UInt32);
long addr = (unsigned long)&status;
char cstring[5];
len = (status >> 24) == 0 ? len - 1 : len;
len = (status >> 16) == 0 ? len - 1 : len;
len = (status >> 8) == 0 ? len - 1 : len;
len = (status >> 0) == 0 ? len - 1 : len;
addr += (4 - len);
status = EndianU32_NtoB(status); // 字串是 big endian
strncpy(cstring, (char *)addr, len);
cstring[len] = 0;
return [NSString stringWithCString:(char *)cstring encoding:NSMacOSRomanStringEncoding];
}
中斷回呼在 iOS 5 下需要統一管理,收到時轉發成自訂通知:
static void MyAudioSessionInterruptionListener(void *inClientData, UInt32 inInterruptionState) {
AudioSessionInterruptionType interruptionType = kAudioSessionInterruptionType_ShouldNotResume;
UInt32 interruptionTypeSize = sizeof(interruptionType);
AudioSessionGetProperty(kAudioSessionProperty_InterruptionType,
&interruptionTypeSize, &interruptionType);
NSDictionary *userInfo = @{
MyAudioInterruptionStateKey : @(inInterruptionState),
MyAudioInterruptionTypeKey : @(interruptionType)
};
[[NSNotificationCenter defaultCenter] postNotificationName:MyAudioInterruptionNotification
object:nil
userInfo:userInfo];
}
收到通知後的處理:
- (void)interruptionNotificationReceived:(NSNotification *)notification {
UInt32 interruptionState =
[notification.userInfo[MyAudioInterruptionStateKey] unsignedIntValue];
AudioSessionInterruptionType interruptionType =
[notification.userInfo[MyAudioInterruptionTypeKey] unsignedIntValue];
[self handleAudioSessionInterruptionWithState:interruptionState type:interruptionType];
}
- (void)handleAudioSessionInterruptionWithState:(UInt32)interruptionState
type:(AudioSessionInterruptionType)interruptionType {
if (interruptionState == kAudioSessionBeginInterruption) {
// 控制 UI,暫停播放
} else if (interruptionState == kAudioSessionEndInterruption) {
if (interruptionType == kAudioSessionInterruptionType_ShouldResume) {
OSStatus status = AudioSessionSetActive(true);
if (status == noErr) {
// 控制 UI,繼續播放
}
}
}
}
AudioSession 或 AVAudioSession,但必須有一個專門類別統一管理所有回呼,收到後轉發為自訂通知。AVAudioSession,監聽通知即可,不必統一管理。NotifyOthersOnDeactivation。ShouldResume。接下來會說明如何用 AudioFile 系列 API 讀取音檔格式資訊並分離音頻帧,以及用 AudioQueue 進行播放。
最後補一句現況:AudioSession 與 AudioQueue 都已被列為 deprecated,目前的正確做法是 AVAudioEngine(需要精細控制節奏或做效果處理)或 AVAudioPlayer(只是要放音樂)。中斷的處理方式也改了——現在應該監聽 AVAudioSession.interruptionNotification 與 AVAudioSession.mediaServicesWereResetNotification,後者代表音頻服務被重置,此時所有 player 都得重建,忽略它會導致 App 永久靜音直到重開。上面這些觀念(Category 的意義、route change、ShouldResume 的協定)在新的 API 裡完全適用,只是介面換了形。