AVAudioSession简单介绍_简单av

当我们在iOS上播放音频的时候.如果来了个电话,那么音频就会自动暂停.当电话结束之后,音频又会自动播放.在用户看来也就是一个神奇的魔法而已.然而在我们开发人员角度来说,我们需要知道iOS系统上有一种managed audio environment(可管理的音频环境).它会智能的管理音频环境.对于开发者来说就是AVAudioSession.

AvaudioSession是一个单例,设置方法有如下四种

- (BOOL)setCategory:(AVAudioSessionCategory)category error:(NSError **)outError API_AVAILABLE(ios(3.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);

- (BOOL)setCategory:(AVAudioSessionCategory)category withOptions:(AVAudioSessionCategoryOptions)options error:(NSError **)outError API_AVAILABLE(ios(6.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);

- (BOOL)setCategory:(AVAudioSessionCategory)category mode:(AVAudioSessionMode)mode options:(AVAudioSessionCategoryOptions)options error:(NSError **)outError API_AVAILABLE(ios(10.0), watchos(3.0), tvos(10.0)) API_UNAVAILABLE(macos);

- (BOOL)setCategory:(AVAudioSessionCategory)category mode:(AVAudioSessionMode)mode routeSharingPolicy:(AVAudioSessionRouteSharingPolicy)policy options:(AVAudioSessionCategoryOptions)options error:(NSError **)outError API_AVAILABLE(ios(11.0), tvos(11.0), watchos(5.0)) API_UNAVAILABLE(macos);
1
2
3
4
5
6
7

AVAudioSessionCategory

/// 用这个分类来发出一些类似雨声、骑车引擎噪音等.可以与其他音乐混合使用
// extern AVAudioSessionCategory const AVAudioSessionCategoryAmbient API_AVAILABLE(ios(3.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);

/// 此分类用于背景音,会暂停其他音乐的播放
// extern AVAudioSessionCategory const AVAudioSessionCategorySoloAmbient API_AVAILABLE(ios(3.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);

/// 此分类用来播放音乐曲目
// extern AVAudioSessionCategory const AVAudioSessionCategoryPlayback API_AVAILABLE(ios(3.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);

/// 用此分类来录制音频
// extern AVAudioSessionCategory const AVAudioSessionCategoryRecord API_AVAILABLE(ios(3.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);

/// 录制和播放音频的时候使用此分类
// extern AVAudioSessionCategory const AVAudioSessionCategoryPlayAndRecord API_AVAILABLE(ios(3.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);

/// 使用硬件解码器或者使用信号处理器的时候使用此类别.(注:不能播放或者录制音频)
//    extern AVAudioSessionCategory const AVAudioSessionCategoryAudioProcessing API_DEPRECATED("No longer supported", ios(3.0, 10.0)) API_UNAVAILABLE(watchos, tvos) API_UNAVAILABLE(macos);

/ *使用此类别可自定义可用音频配件和内置音频硬件的使用情况。
例如，此类别为应用程序提供了使用可用USB输出的功能
和耳机同时输出单独的，不同的音频数据流。用于
应用程序要求此类别需要更详细的知识和与之交互，
可用音频路由的功能。可用于输入，输出或两者。
请注意，并非所有输出类型和输出组合都符合多路径的条件。输入有限
到最后输入端口。符合条件的输入包括以下内容：
AVAudioSessionPortUSBAudio，AVAudioSessionPortHeadsetMic和AVAudioSessionPortBuiltInMic。
符合条件的输出包括以下内容：
AVAudioSessionPortUSBAudio，AVAudioSessionPortLineOut，AVAudioSessionPortHeadphones，AVAudioSessionPortHDMI，
和AVAudioSessionPortBuiltInSpeaker。
请注意，只有在没有其他符合条件的情况下才允许使用AVAudioSessionPortBuiltInSpeaker
输出连接。 * /
// extern AVAudioSessionCategory const AVAudioSessionCategoryMultiRoute API_AVAILABLE(ios(6.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

注:锁屏键或者是应用不在Active状态还能播放音频的category需要设置UIBackgroundModes

AVAudioSessionCategoryOption (用于微调Category行为)

AVAudioSessionMode (可以通过mode来定制Category的行为)

AVAudioSessionRouteSharingPolicy (个人理解是设置成哪个音频通道优先)

注:AVInitialRouteSharingPolicy(AirPlay optimization policy).说明是String.感觉应该是使用AirPlay

active/deactive当前配置

- (BOOL)setActive:(BOOL)active error:(NSError **)outError API_AVAILABLE(ios(3.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);
- (BOOL)setActive:(BOOL)active withOptions:(AVAudioSessionSetActiveOptions)options error:(NSError **)outError API_AVAILABLE(ios(6.0), watchos(2.0), tvos(9.0)) API_UNAVAILABLE(macos);
1
2

用法

AVAudioSession *session = [AVAudioSession sharedInstance];
NSError *error = nil;
if (![session setCategory:AVAudioSessionCategoryAmbient error:&error]) {
	// 处理错误
}
NSError *errorActive = nil;
if (![session setActive:YES error:&errorActive]) {
	// 处理错误
}
1
2
3
4
5
6
7
8
9