AudioSession 簡(jiǎn)介
AudioSession 這個(gè)玩意的主要功能包括以下幾點(diǎn)(圖片來(lái)自官方文檔):
1融虽、確定你的 APP 如何使用音頻享完,是播放還是錄音
2、為你的 APP選擇合適的輸入輸出設(shè)備(如輸入用麥克風(fēng)有额、輸出用耳機(jī)般又、手機(jī)功放或者 AirPlay)
3、協(xié)調(diào)你的 APP 的音頻播放和系統(tǒng)以及其他 APP 的行為(如電話打斷巍佑,結(jié)束電話時(shí)恢復(fù)茴迁,按下靜音按鈕時(shí)是否歌曲也要靜音等)
與 AudioSession 相關(guān)的類(lèi)有2個(gè)
1、AudioToolBox 中的 AudioSession
2萤衰、AVFoundation 中的 AVAudioSession
AudioSession在SDK7中已被標(biāo)注為depracated堕义,在此由于最高版本已經(jīng)到 iOS11, 所以對(duì) AVAudioSession 進(jìn)行說(shuō)明脆栋。
AVAudioSession 為單例倦卖,其初始化方法如下
// 初始化 session
+ (AVAudioSession *)sharedInstance;
激活A(yù)VAudioSession
激活 AVAudioSession的方法有兩個(gè) ,如下:第2個(gè)方法所用的枚舉在這里會(huì)進(jìn)行相應(yīng)的講解
- (BOOL)setActive:(BOOL)active error:(NSError **)outError;
/* AVAudioSessionSetActiveOptions 這個(gè)枚舉只有一個(gè)值:AVAudioSessionSetActiveOptionNotifyOthersOnDeactivation 關(guān)于這個(gè)枚舉做以下2點(diǎn)說(shuō)明
* 作用是通知中斷的應(yīng)用程序中斷已經(jīng)結(jié)束椿争,可以恢復(fù)播放糖耸,只對(duì)某個(gè)會(huì)話停了的 APP 有效。
* 因?yàn)锳VAudioSession會(huì)影響其他 APP 的表現(xiàn)丘薛,當(dāng)自己 APP 的 session 被激活嘉竟,其他 APP 的 session 機(jī)會(huì)被解除激活,如何讓自己的 APP 解除激活后恢復(fù)其他 APP 的表現(xiàn) 就需要用到這個(gè)枚舉
*/
- (BOOL)setActive:(BOOL)active withOptions:(AVAudioSessionSetActiveOptions)options error:(NSError **)outError
七大Category
AVAudioSession 主要能控制 APP 的哪些表現(xiàn)以及如何控制呢洋侨?首先 AVAudioSeeson 將使用音頻的場(chǎng)景分成7大類(lèi)舍扰,通過(guò)設(shè)置 Session 的不同類(lèi)別進(jìn)行控制,設(shè)置類(lèi)別的方法有如下4個(gè)
/** 7大 Category *
* AVAudioSessionCategoryAmbient : 設(shè)置這種category希坚,聲音可作為背景音边苹,如在打游戲的時(shí)候想聽(tīng) QQ 音樂(lè),那么把游戲的背景音就設(shè)置為這種category裁僧。使用這個(gè) category 會(huì)隨著靜音鍵和屏幕的關(guān)閉而靜音个束。應(yīng)用于非語(yǔ)音為主的應(yīng)用
* AVAudioSessionCategorySoloAmbient : 類(lèi)似于AVAudioSessionCategoryAmbient。只用于播放聊疲,它會(huì)終止其他 APP 播放音頻
* AVAudioSessionCategoryPlayback : 適用于 APP 本身就是一個(gè)音頻播放器茬底,用這個(gè) category,不會(huì)隨著靜音鍵和屏幕的關(guān)閉而靜音
* AVAudioSessionCategoryRecord : 用于需要錄音的應(yīng)用获洲,設(shè)置了該 category阱表,除了來(lái)電鈴聲、鬧鐘、日歷提醒之外的其他聲音都不會(huì)被播放最爬,該 category 只提供錄音功能涉馁。
* AVAudioSessionCategoryPlayAndRecord : 用于既需要播放有需要錄音的應(yīng)用,比如打電話的時(shí)候需要錄音爱致,如果應(yīng)用需要用到 iPhone 上的聽(tīng)筒烤送,那么該 Category 是你唯一的選擇,在沒(méi)有外接設(shè)備的情況下糠悯,該 category 下的聲音默認(rèn)出口為聽(tīng)筒
* AVAudioSessionCategoryAudioProcessing : 用于音頻格式處理胯努,一般和 AudioUnit 配合使用
* AVAudioSessionCategoryMultiRoute : 這個(gè)類(lèi)別為應(yīng)用程序提供了同時(shí)使用USB輸出和耳機(jī)輸出的能力,用于單獨(dú)的逢防、不同的音頻數(shù)據(jù)流.使用此 category 需要更詳細(xì)的了解音頻路由的功能,并與之交互蒲讯⊥可用于輸入、輸出或兩者兼用判帮。注意局嘁,不是所有的輸出類(lèi)型和
輸出組合適合于多路由。輸入限制在最后一個(gè)輸入端口晦墙。合格的輸入如下:AVAudioSessionPortUSBAudio, AVAudioSessionPortHeadsetMic, AVAudioSessionPortBuiltInMic.合格的輸出如下:AVAudioSessionPortUSBAudio, AVAudioSessionPortLineOut, AVAudioSessionPortHeadphones, AVAudioSessionPortHDMI, AVAudioSessionPortBuiltInSpeaker(只允許在沒(méi)有其他合適的輸出連接時(shí)使用)
*/
- (BOOL)setCategory:(NSString *)category error:(NSError **)outError;
七大 Category可以認(rèn)為設(shè)定了7種場(chǎng)景悦昵,而這七個(gè) Category肯定不能滿(mǎn)足開(kāi)發(fā)者的所有需求,因此又提供了7個(gè) Options 進(jìn)行微調(diào)晌畅。
/** AVAudioSessionCategoryOptions *
* AVAudioSessionCategoryOptionMixWithOthers : 試用 category AVAudioSessionCategoryPlayAndRecord但指、AVAudioSessionCategoryMultiRoute、AVAudioSessionCategoryPlayback抗楔。 設(shè)置背景音
* AVAudioSessionCategoryOptionDuckOthers : 試用 category AVAudioSessionCategoryAmbient AVAudioSessionCategoryPlayAndRecord棋凳、AVAudioSessionCategoryMultiRoute、AVAudioSessionCategoryPlayback连躏。通過(guò)設(shè)置這個(gè)選項(xiàng)對(duì)其他 APP 的聲音進(jìn)行壓制
* AVAudioSessionCategoryOptionAllowBluetooth : 試用 category AVAudioSessionCategoryPlayAndRecord剩岳、 AVAudioSessionCategoryRecord。 支持藍(lán)牙耳機(jī)通話或者錄音則需要設(shè)置這個(gè)選項(xiàng)
* AVAudioSessionCategoryOptionDefaultToSpeaker : 試用 category AVAudioSessionCategoryPlayAndRecord入热。如果在 VoIP 模式下拍棕,默認(rèn)打開(kāi)免提功能,需要設(shè)置這個(gè)選項(xiàng)
* AVAudioSessionCategoryOptionInterruptSpokenAudioAndMixWithOthers : 試用 category AVAudioSessionCategoryPlayAndRecord勺良、AVAudioSessionCategoryMultiRoute绰播、AVAudioSessionCategoryPlayback。適用于 APP偶爾進(jìn)行音頻能播放
* AVAudioSessionCategoryOptionAllowBluetoothA2DP : 試用 category AVAudioSessionCategoryPlayAndRecord尚困。支持立體聲藍(lán)牙
* AVAudioSessionCategoryOptionAllowAirPlay : 試用 category AVAudioSessionCategoryPlayAndRecord幅垮。支持AirPlay
*/
- (BOOL)setCategory:(NSString *)category withOptions:(AVAudioSessionCategoryOptions)options error:(NSError **)outError
八大模式,通過(guò)上面的七大 Category,我們基本覆蓋了常用的主場(chǎng)景忙芒,在每個(gè)主場(chǎng)景中我們可以通過(guò) Opition 進(jìn)行微調(diào)示弓,為此 CoreAudio 提供了八大比較常見(jiàn)微調(diào)后的子場(chǎng)景。叫做各個(gè)類(lèi)別的模式呵萨。
/** mode *
* AVAudioSessionModeDefault:默認(rèn)模式奏属,適用于所有場(chǎng)景
* AVAudioSessionModeVoiceChat: 只有與AVAudioSessionCategoryPlayAndRecord有效。適用于IP網(wǎng)絡(luò)電話的應(yīng)用潮峦。減少允許的音頻路由的數(shù)量囱皿,使之只適用于VoIP應(yīng)用程序,并可能參與適當(dāng)?shù)南到y(tǒng)提供的信號(hào)處理忱嘹。有設(shè)置 Opitions 為 AVAudioSessionCategoryOptionAllowBluetooth 的副作用
* AVAudioSessionModeGameChat : 適用于游戲App的采集和播放嘱腥,比如“GKVoiceChat”對(duì)象,一般不需要手動(dòng)設(shè)置
* AVAudioSessionModeVideoChat : 主要用于視頻通話拘悦,比如QQ視頻齿兔、FaceTime。時(shí)系統(tǒng)也會(huì)選擇最佳的輸入設(shè)備础米,比如插上耳機(jī)就使用耳機(jī)上的麥克風(fēng)進(jìn)行采集并且會(huì)設(shè)置類(lèi)別的選項(xiàng)為"AVAudioSessionCategoryOptionAllowBluetooth" 和 "AVAudioSessionCategoryOptionDefaultToSpeaker"
* AVAudioSessionModeVideoRecording : 僅對(duì)AVAudioSessionCategoryPlayAndRecord或AVAudioSessionCategoryRecord有效分苇。修改音頻路由選項(xiàng)并可能進(jìn)行適當(dāng)?shù)南到y(tǒng)提供的信號(hào)處理。
* AVAudioSessionModeMeasurement : 適用于希望將系統(tǒng)提供的信號(hào)處理對(duì)輸入和/或輸出音頻信號(hào)的影響降到最低的應(yīng)用程序屁桑。
* AVAudioSessionModeMoviePlayback : 為視頻回放場(chǎng)景進(jìn)行適當(dāng)?shù)男盘?hào)處理医寿。目前只適用于內(nèi)置揚(yáng)聲器的播放
* AVAudioSessionModeSpokenAudio : 當(dāng)想要在另一個(gè)應(yīng)用播放短語(yǔ)音頻時(shí)暫停當(dāng)前音頻時(shí),用于持續(xù)說(shuō)話音頻的模式蘑斧。
*/
- (BOOL)setMode:(NSString *)mode error:(NSError **)outError
系統(tǒng)中斷響應(yīng)
AVAudioSession 提供了多種 Notifications 來(lái)通知當(dāng)前 APP 中斷靖秩,其中將電話、鬧鈴等都?xì)w結(jié)為一般性的中斷用AVAudioSessionInterruptionNotification來(lái)通知竖瘾,其回調(diào)的 userInfo 主要有兩個(gè)鍵盆偿,如下:
1、AVAudioSessionInterruptionTypeKey 有兩個(gè)值
(1)取值為AVAudioSessionInterruptionTypeBegan表示中斷開(kāi)始准浴,我們應(yīng)該暫停播放和采集事扭。
(2)表示中斷結(jié)束,我們可以繼續(xù)播放和采集乐横。
2求橄、AVAudioSessionInterruptionOptionShouldResume 表示此時(shí)也應(yīng)該恢復(fù)繼續(xù)播放和采集。
而其他 APP 占據(jù)AVAudioSession的時(shí)候AVAudioSessionSilenceSecondaryAudioHintNotification會(huì)發(fā)來(lái)通知葡公,其回調(diào)回來(lái)的 userInfo可能包含的值為
1罐农、AVAudioSessionSilenceSecondaryAudioHintTypeBegin:其他 APP 開(kāi)始占據(jù) Session
2、AVAudioSessionSilenceSecondaryAudioHintTypeEnd:其他 App 開(kāi)始釋放 Session
外設(shè)改變
用戶(hù)也可以對(duì)我們的 APP 產(chǎn)生影響催什,會(huì)通過(guò)AVAudioSessionRouteChangeNotification回調(diào)回來(lái) userInfo涵亏,其鍵為
1、AVAudioSessionRouteChangeReasonKey,表示改變?cè)蛑禐?br>
(1)AVAudioSessionRouteChangeReasonUnknown:未知原因
(2)AVAudioSessionRouteChangeReasonNewDeviceAvailable :有新設(shè)備可用
(3)AVAudioSessionRouteChangeReasonOldDeviceUnavailable:舊設(shè)備不可用
(4)AVAudioSessionRouteChangeReasonCategoryChange:Category 改變了
(5)AVAudioSessionRouteChangeReasonOverride:APP 重置了輸出設(shè)置
(6)AVAudioSessionRouteChangeReasonWakeFromSleep:從睡眠狀態(tài)呼醒
(7)AVAudioSessionRouteChangeReasonNoSuitableRouteForCategory:當(dāng)前 Category 下沒(méi)有合適的設(shè)備
(8)可以AVAudioSessionRouteChangeReasonRouteConfigurationChange:router 的配置改變了
2气筋、AVAudioSessionSilenceSecondaryAudioHintTypeKey:和上面的中斷一意
總結(jié):AVAudioSession構(gòu)建了一個(gè)音頻使用生命周期的上下文拆内。當(dāng)前狀態(tài)是否可以錄音、對(duì)其他App有怎樣的影響宠默、是否響應(yīng)系統(tǒng)的靜音鍵麸恍、如何感知來(lái)電話了等都可以通過(guò)它來(lái)實(shí)現(xiàn)。尤為重要的是AVAudioSession不僅可以和AVFoundation中的AVAudioPlyaer/AVAudioRecorder配合搀矫,其他錄音/播放工具比如AudioUnit编丘、AudioQueueService也都需要他進(jìn)行錄音僵控、靜音等上下文配合。
此文借鑒:CZ_iOS聂宾、碼農(nóng)人生的博客,以及官方文檔截汪。
大家喜歡 star循狰,不喜勿噴功氨,這只是小白的進(jìn)化過(guò)程捻勉。