您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

iOS 音訊路由實戰:切換揚聲器、偵測耳機與 Safari 提示的相容處理

編輯:iOS 相關資訊

這一類需求網路上寫法很多,但雷也多——尤其是 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

初始化:一次把兩套 API 都設好

這段是整個實作的關鍵。為什麼 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 元件時用得上。

實務提醒

  • 非同步 API 的替代。AudioSession 這套 C API 自 iOS 7 起已 deprecated,新專案應全面改用 AVAudioSession,並以 currentRoute.outputs 取代字串比對來判斷路由。
  • Category 決定行為,不是路由決定。很多「切換沒生效」的問題,根因是 category 選錯(例如 PlayAndRecord 與 Playback 的預設輸出不同),而非 override 沒設。
  • 路由回呼可能來得很頻繁。不要在回呼中做重運算,也不要假設它一定在主執行緒上。
  • 靜音鍵的影響。只有 AVAudioSessionCategoryAmbient 會受硬體靜音鍵影響,Playback 不會。這個差異常被誤判為 bug。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved