AVAudioSession(2)：定义一个 Audio Session

2022-06-01 00:29:41

本文转自：AVAudioSession(2)：定义一个 Audio Session | www.samirchen.com

本文内容主要来源于 Defining an Audio Session。

Audio Session 的默认行为

AVAudioSession 的默认行为如下：

音频播放能力是开启的，但是音频录制能力是关闭的。
当用户通过静音键切换到静音模式时，你的音频会被静音。
当用户通过锁屏键锁定屏幕或者自动锁屏定时触发时，你的音频会被静音。
当你的音频开始播放时，正在播放的其他 App 的音频会被静音。

这些行为是由默认的 AVAudioSessionCategorySoloAmbient Category 设定的。通常默认设置是不能满足你的需求的，除非你的 App 对音频的控制场景如下：

你的 App 只使用 System Sound Services 或者 UIKit 中的 playInputClick 方法来处理音频，而没有用到其他音频相关的 API 时。
你的 App 不使用任何音频。

系统如何解决竞争性的音频请求

流程大致如下图，还是挺好理解的：

需要注意的是，系统永远遵循一个原则：电话的优先级最高。

和 AVCaptureSession 协同

在 AV Foundatin capture 相关的 API 中（AVCaptureDevice, AVCaptureSession）允许你从摄像头和麦克风采集同步的音视频数据。其中表示麦克风的 AVCaptureDevice 对象可以共享你的 AVAudioSession。通常情况下，如果 AVCaptureSession 需要使用麦克风进行音频录制时，它会去修改优化你的 AVAudioSession 配置。如果你不希望这样，则需要设置对应的 AVCaptureSession 对象的 automaticallyConfiguresApplicationAudioSession 属性为 NO 来让 AVCaptureSession 使用你当前的 AVAudioSession 配置而不会修改它。

初始化 Audio Session

代码如下：

// implicitly initializes your audio session

AVAudioSession *session = [AVAudioSession sharedInstance];

音量和路径控制

苹果官方推荐使用 MPVolumeView 来控制音频音量和路径，MPVolumeView 提供了一个 Slider 来控制音量，提供了一个按钮来供你选择音频输出路径。

你可以通过如下代码来设置音频输出路径到话筒：

[[AVAudioSession sharedInstance] overrideOutputAudioPort:AVAudioSessionPortOverrideSpeaker error:nil];

但苹果推荐你用 MPVolumeView 提供的路径选择按钮来实现音频输出路径切换。

响应远程控制事件

通过响应 Remote Control Events 能让你在播放音视频内容时，可以响应来自锁屏界面、外部设备等 App 外部的控制。

具体参见 Remote Control Events 和 MPNowPlayingInfoCenter Class Reference。

激活和关闭 Audio Session

苹果官方建议如果你需要用到 Audio Session，总是应该显示地激活你的 Audio Session。并且参考 Setting Preferred Hardware Values 来设置相应的硬件参数。这样可以在你使用 Audio Session 前来测试是否能成功激活，以便于做出正确的处理逻辑。

激活 Audio Session 代码如下：

NSError *activationError = nil;

BOOL success = [[AVAudioSession sharedInstance] setActive:YES error:&activationError]; // Pass 'NO' when deactivate your audio session.

if (!success) { /* handle the error in activationError */ }

值得注意的是，大部分时候我们不需要关闭 Audio Session，除非是在 VoIP(Voice over Internet Protocol) 类应用、turn-by-turn 导航类应用和某些录制类应用中。这时你需要注意：

对于 VoIP 类应用，要确保 Audio Session 只在电话接听中是 Active 的。当应用处于后台时，保持应用为准备接听电话的状态，但应用的 Audio Session 应该是 Inactive 的。
对于定位于 Recording Category 来使用 Audio Session 的应用，要确保只在录制中设置 Audio Session 为 Active 状态，在录制开始前和录制结束后要确保 Audio Session 为 Inactive 状态以允许其他音频的播放。

检查是否有其他音频正在播放

你可以通过 otherAudioPlaying 来检查是否当前有其他应用的音频正在播放。

比如你是一个自带音效的游戏，当一个正在听音乐的用户打开你的游戏时，iOS 设计指南会建议你不要关闭用户正在听的音乐而播放你的游戏音效，这时候你怎么处理呢？你可以用上面的接口检查一下，如果有声音在播放则将你的音效静音并设置 AVAudioSessionCategorySoloAmbient。

Inter-App Audio 特性

Inter-App Audio 特性允许一个 Node App 将它的音频输出给一个 Host App。也可以由 Host App 发送它的音频给 Node App 进行处理，处理完后再发回给 Host App。Host App 需要设置一个 Active 的 Audio Session，而 Node App 则只在从 Host App 或系统接收音频输入时才需要一个 Active 的 Audio Session。

你可以使用下面这些规则来搭建 Inter-App Audio：

为 Node App 和 Host App 都设置「inter-app-audio」的 entitlement。
为 Host App 设置 UIBackgroundModes 的 audio flag。
为那些在与 Host App 连接时使用音频输入或输出路径的 Node App 设置 UIBackgroundModes 的 audio flag。
为 Node App 和 Host App 都设置 AVAudioSessionCategoryOptionMixWithOthers 这个 Category。
确保连接着 inter-app host 的 Node App 在接收来自系统的音频或者输出音频时的 Audio Session 是 Active 的。

码农公寓