這一類需求網路上寫法很多,但雷也多——尤其是 SDK 7.x 前後的差異,以及 iOS 7 之後 AudioSession 部分 C API 被標記為 deprecated 所帶來的混亂。以下是一個把「切換聽筒/揚聲器」與「耳機插拔偵測」整合在一起的完整實作,並說明每個環節的理由。
單純呼叫一次「切到揚聲器」是不夠的。使用者的耳機隨時可能被插入或拔出,系統會發出路由變更通知,App 必須跟著反應,否則會出現「耳機拔了聲音還是從聽筒出」這類狀況。因此正確的設計是:主動設定 + 被動監聽兩者並存。
#import <AVFoundation/AVFoundation.h>
#import <AudioToolbox/AudioToolbox.h>
@interface AudioManager : NSObject {
AVAudioPlayer *m_audioPlayer;
}
@property (atomic, readonly) BOOL _isSpeakerOn;
@property (atomic, readonly) BOOL _isHeadsetOn;
+ (AudioManager *)shared;
- (void)setSpeakerOn; // 打開揚聲器
- (void)setSpeakerOff; // 關閉揚聲器
@end
這段是整個實作的關鍵。為什麼 AVAudioSession 與 C 版 AudioSession 要同時設定?因為兩者操作的其實是同一個底層 session,但在不同 iOS 版本上,某些選項只有其中一套 API 支援。實務上兩邊都設,相容性最好。
#define IOSVersion [[UIDevice currentDevice].systemVersion floatValue]
@implementation AudioManager
@synthesize _isSpeakerOn;
@synthesize _isHeadsetOn;
static AudioManager *_audioManager = NULL;
+ (AudioManager *)shared {
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
_audioManager = [[AudioManager alloc] init];
});
return _audioManager;
}
- (id)init {
self = [super init];
if (self) {
_isSpeakerOn = NO;
AVAudioSession *audioSession = [AVAudioSession sharedInstance];
// 預設以揚聲器播放,並允許與其他 App 混音
[audioSession setCategory:AVAudioSessionCategoryPlayback
withOptions:AVAudioSessionCategoryOptionMixWithOthers
error:nil];
[audioSession setActive:YES error:nil];
// 以下為 C API 的等效設定
UInt32 sessionCategory = kAudioSessionCategory_MediaPlayback;
AudioSessionSetProperty(kAudioSessionProperty_AudioCategory,
sizeof(sessionCategory), &sessionCategory);
UInt32 audioRouteOverride = kAudioSessionOverrideAudioRoute_Speaker;
AudioSessionSetProperty(kAudioSessionProperty_OverrideAudioRoute,
sizeof(audioRouteOverride), &audioRouteOverride);
// 註冊路由變更監聽,self 作為 userData 傳入回呼
AudioSessionAddPropertyListener(kAudioSessionProperty_AudioRouteChange,
audioRouteChangeListenerCallback,
(__bridge void *)(self));
}
return self;
}
這裡用的是 kAudioSessionProperty_OverrideCategoryDefaultToSpeaker,語意是「把預設輸出改為揚聲器」,而不是強制覆寫路由。差別在於:前者尊重耳機優先原則,後者會無視耳機存在。對通話類 App 來說,前者是正確選擇。
- (void)setSpeakerOn {
NSLog(@"setSpeakerOn: %d", [NSThread isMainThread]);
UInt32 doChangeDefaultRoute = kAudioSessionOverrideAudioRoute_Speaker;
AudioSessionSetProperty(kAudioSessionProperty_OverrideCategoryDefaultToSpeaker,
sizeof(doChangeDefaultRoute), &doChangeDefaultRoute);
_isSpeakerOn = [self checkSpeakerOn];
_isHeadsetOn = NO;
}
- (void)setSpeakerOff {
UInt32 doChangeDefaultRoute = kAudioSessionOverrideAudioRoute_None;
AudioSessionSetProperty(kAudioSessionProperty_OverrideCategoryDefaultToSpeaker,
sizeof(doChangeDefaultRoute), &doChangeDefaultRoute);
_isSpeakerOn = [self checkSpeakerOn];
}
不要用自己的旗標當唯一真相來源,應該實際去問系統目前聲音從哪裡出來。做法是讀取 kAudioSessionProperty_AudioRoute,再對回傳的路徑描述字串做比對。
- (BOOL)checkSpeakerOn {
CFStringRef route;
UInt32 propertySize = sizeof(CFStringRef);
AudioSessionGetProperty(kAudioSessionProperty_AudioRoute, &propertySize, &route);
if ((route == NULL) || (CFStringGetLength(route) == 0)) {
// 靜音模式,不做處理
NSLog(@"AudioRoute: SILENT, do nothing!");
} else {
NSString *routeStr = (__bridge NSString *)route;
NSRange speakerRange = [routeStr rangeOfString:@"Speaker"];
if (speakerRange.location != NSNotFound) return YES;
}
return NO;
}
- (BOOL)hasHeadset {
CFStringRef route;
UInt32 propertySize = sizeof(CFStringRef);
AudioSessionGetProperty(kAudioSessionProperty_AudioRoute, &propertySize, &route);
if ((route == NULL) || (CFStringGetLength(route) == 0)) {
NSLog(@"AudioRoute: SILENT, do nothing!");
} else {
NSString *routeStr = (__bridge NSString *)route;
NSLog(@"AudioRoute: %@", routeStr);
// 只有 ReceiverAndMicrophone 代表聲音走聽筒
if ([routeStr isEqualToString:@"ReceiverAndMicrophone"]) {
[self setSpeakerOn];
}
NSRange headphoneRange = [routeStr rangeOfString:@"Headphone"];
NSRange headsetRange = [routeStr rangeOfString:@"Headset"];
if (headphoneRange.location != NSNotFound) return YES;
if (headsetRange.location != NSNotFound) return YES;
}
return NO;
}
// 判斷麥克風是否可用
- (BOOL)hasMicphone {
return [[AVAudioSession sharedInstance] isInputAvailable];
}
// 有耳機:尊重耳機,不做強制覆寫
- (void)erjiOutPutTarget {
BOOL hasHeadset = [self hasHeadset];
if (hasHeadset) {
_isHeadsetOn = YES;
}
NSLog(@"Will set output target, is_headset = %@.", hasHeadset ? @"YES" : @"NO");
UInt32 audioRouteOverride = kAudioSessionOverrideAudioRoute_None;
AudioSessionSetProperty(kAudioSessionProperty_OverrideAudioRoute,
sizeof(audioRouteOverride), &audioRouteOverride);
}
// 無耳機:強制回到揚聲器
- (void)resetOutputTarget {
BOOL hasHeadset = [self hasHeadset];
NSLog(@"Will set output target, is_headset = %@.", hasHeadset ? @"YES" : @"NO");
UInt32 audioRouteOverride = kAudioSessionOverrideAudioRoute_Speaker;
AudioSessionSetProperty(kAudioSessionProperty_OverrideAudioRoute,
sizeof(audioRouteOverride), &audioRouteOverride);
_isHeadsetOn = NO;
}
這是整個模組的神經中樞。系統透過 inPropertyValue 傳入一個字典,其中 kAudioSession_AudioRouteChangeKey_Reason 說明了變更原因,需要依原因分派處理:
void audioRouteChangeListenerCallback(void *inUserData,
AudioSessionPropertyID inPropertyID,
UInt32 inPropertyValueSize,
const void *inPropertyValue) {
if (inPropertyID != kAudioSessionProperty_AudioRouteChange) return;
// 取出變更原因,用以排除「只是 category 換了」這種情況
CFDictionaryRef routeChangeDictionary = (CFDictionaryRef)inPropertyValue;
CFNumberRef routeChangeReasonRef =
(CFNumberRef)CFDictionaryGetValue(routeChangeDictionary,
CFSTR(kAudioSession_AudioRouteChangeKey_Reason));
SInt32 routeChangeReason;
CFNumberGetValue(routeChangeReasonRef, kCFNumberSInt32Type, &routeChangeReason);
AudioManager *pMgr = (__bridge AudioManager *)inUserData;
// 舊裝置消失:多半是耳機被拔出
if (routeChangeReason == kAudioSessionRouteChangeReason_OldDeviceUnavailable) {
[pMgr setSpeakerOn];
[pMgr resetOutputTarget];
}
// 新裝置可用:耳機被插入
else if (routeChangeReason == kAudioSessionRouteChangeReason_NewDeviceAvailable) {
[pMgr erjiOutPutTarget];
}
// 類別被強制覆寫
else if (routeChangeReason == kAudioSessionRouteChangeReason_Override) {
[pMgr setSpeakerOn];
[pMgr resetOutputTarget];
}
NSLog(@"-------->%f", IOSVersion);
// 部分 iOS 版本會以 8 這個數字表示路由變化,需額外查一次耳機狀態
if (routeChangeReason == 8) {
[pMgr hasHeadset];
}
}
最後那個 routeChangeReason == 8 的判斷是實測補上的相容分支——某些系統版本回傳的原因碼與列舉值對不上,若不額外查一次,就會出現耳機狀態與實際不符的情況。這類「靠實機歸納出來的補丁」在音訊路由相關程式碼中很常見,也是這個領域特別容易踩坑的原因。
如果你只需要「切到擴音」,其實不必這麼複雜。最小實作只要三行:
UInt32 sessionCategory = kAudioSessionCategory_MediaPlayback;
AudioSessionSetProperty(kAudioSessionProperty_AudioCategory,
sizeof(sessionCategory), &sessionCategory);
UInt32 audioRouteOverride = kAudioSessionOverrideAudioRoute_Speaker;
AudioSessionSetProperty(kAudioSessionProperty_OverrideAudioRoute,
sizeof(audioRouteOverride), &audioRouteOverride);
若需要的是「通話時貼近耳朵切聽筒、離開切揚聲器」,則要搭配距離感測器:
#pragma mark - 監聽聽筒/揚聲器切換
- (void)handleNotification:(BOOL)state {
// 建議播放前設 YES,播放結束設 NO
[[UIDevice currentDevice] setProximityMonitoringEnabled:state];
if (state) {
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(sensorStateChange:)
name:UIDeviceProximityStateDidChangeNotification
object:nil];
} else {
[[NSNotificationCenter defaultCenter] removeObserver:self
name:UIDeviceProximityStateDidChangeNotification object:nil];
}
}
- (void)sensorStateChange:(NSNotificationCenter *)notification {
if ([[UIDevice currentDevice] proximityState] == YES) {
// 貼近耳朵,聲音走聽筒
[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayAndRecord
error:nil];
} else {
// 遠離,聲音走揚聲器
[[AVAudioSession sharedInstance] setCategory:AVAudioSessionCategoryPlayback
error:nil];
}
}
另外,若要判斷音訊是否正在輸出到 AirPlay,可以讀取 kAudioSessionProperty_AudioRouteDescription 取得輸出裝置陣列,再比對型別是否為 kAudioSessionOutputRoute_AirPlay。這段邏輯在需要為外接輸出隱藏某些 UI 元件時用得上。
currentRoute.outputs 取代字串比對來判斷路由。AVAudioSessionCategoryAmbient 會受硬體靜音鍵影響,Playback 不會。這個差異常被誤判為 bug。