您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 音頻播放(二):AudioSession 觀念與實作詳解

編輯:iOS 開發綜合

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

AudioSession 在做什麼

它的職責大致有三項:

  1. 告訴系統你的 App 打算怎麼用音頻——播放?錄音?還是兩者都要?
  2. 決定輸入輸出走哪裡:內建喇叭、耳機、藍牙、還是 AirPlay。
  3. 協調你與系統、與其他 App 之間的行為:來電時要被打斷、掛斷後要能恢復、按下靜音鍵時要不要跟著靜音。

相關的類別有兩個:AudioToolBox 中的 AudioSession(C API),以及 AVFoundation 中的 AVAudioSession(Objective-C)。前者在 SDK 7 已被標記為 deprecated,後者雖然從 iOS 3 就存在,但許多方法要到 iOS 6、7 才補齊。選擇標準很簡單:

  • 最低支援 iOS 5:兩者皆可,但建議用 AVAudioSession。
  • 最低支援 iOS 6 以上:直接用 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 同壽命的單例類裡。

監聽 RouteChange

「拔掉耳機就暫停播放」要靠這個:

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, &currentRouteDescriptionDictionary);

    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;
}

設定 Category

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 參數,得以判斷要不要繼續播放。

完整流程:

  1. 音樂 App A 正在播放。
  2. 使用者打開你的 App 播放語音,AudioSession active。
  3. A 被打斷,收到 InterruptBegin。
  4. 語音播完,你的 App deactive 並帶入 NotifyOthersOnDeactivation。
  5. A 收到 InterruptEnd,檢查 Resume 參數:ShouldResume 就繼續播,ShouldNotResume 就維持停止。

遺憾的是,實務上不少 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,繼續播放
            }
        }
    }
}

小結

  • 最低支援 iOS 5:可用 AudioSession 或 AVAudioSession,但必須有一個專門類別統一管理所有回呼,收到後轉發為自訂通知。
  • 最低支援 iOS 6 以上:直接用 AVAudioSession,監聽通知即可,不必統一管理。
  • 依 App 的實際情境選擇合適的 Category。
  • deactive 時依情境決定是否帶上 NotifyOthersOnDeactivation。
  • 處理 InterruptEnd 時別忘了檢查 ShouldResume。

下一部分的預告

接下來會說明如何用 AudioFile 系列 API 讀取音檔格式資訊並分離音頻帧,以及用 AudioQueue 進行播放。

最後補一句現況:AudioSession 與 AudioQueue 都已被列為 deprecated,目前的正確做法是 AVAudioEngine(需要精細控制節奏或做效果處理)或 AVAudioPlayer(只是要放音樂)。中斷的處理方式也改了——現在應該監聽 AVAudioSession.interruptionNotification 與 AVAudioSession.mediaServicesWereResetNotification,後者代表音頻服務被重置,此時所有 player 都得重建,忽略它會導致 App 永久靜音直到重開。上面這些觀念(Category 的意義、route change、ShouldResume 的協定)在新的 API 裡完全適用,只是介面換了形。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved