KSYAVAudioSession.h
3.23 KB
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
//
// KSYAVAudioSession.h
// KSYStreamer
//
//
// Created by pengbin on 10/15/15.
// Copyright © 2015 ksyun. All rights reserved.
//
#import <Foundation/Foundation.h>
#import <AVFoundation/AVFoundation.h>
#import "KSYTypeDef.h"
/** iOS的AVAudioSession 属性配置工具类
1. 主要是保证推流时有采集和播放音频的权限 AVAudioSessionCategoryPlayAndRecord
2. 将一些常用的AVAudioSession的配置项提取为属性, 方便设置
3. 提供查询和修改当前音频采集设备相关的工具函数 比如查询是否有耳机
*/
@interface KSYAVAudioSession : NSObject
/**
@abstract 是否打断其他后台的音乐播放 (默认为NO)
@discussion 也可以理解为是否允许在其他后台音乐播放的同时进行采集
@discussion YES:开始采集时，会打断其他的后台播放音乐，也会被其他音乐打断（采集过程中，启动其他音乐播放，音频采集被中止）
@discussion NO: 可以与其他后台播放共存，相互之间不会被打断
@discussion 参考 AVAudioSessionCategoryOptionMixWithOthers
*/
@property (nonatomic, assign) BOOL bInterruptOtherAudio;
/**
@abstract 启动采集后,是否从扬声器播放声音 (默认为YES)
@discussion 启动声音采集后,iOS系统的行为是默认从听筒播放声音的
@discussion 将该属性设为YES, 则改为默认从扬声器播放
@discussion 参考 AVAudioSessionCategoryOptionDefaultToSpeaker
*/
@property (nonatomic, assign) BOOL bDefaultToSpeaker;
/**
@abstract 是否启用蓝牙设备 (默认为YES)
@discussion 参考 AVAudioSessionCategoryOptionAllowBluetooth
*/
@property (nonatomic, assign) BOOL bAllowBluetooth;
/**
@abstract 设置声音采集需要的AUAudioSession的参数
@discussion 按照属性的设置值刷新AUAudioSession的配置
@discussion 参考 AUAudioSession
*/
- (void) setAVAudioSessionOption;
/**
@abstract 本SDK使用的AVAudioSession的类别 (默认为AVAudioSessionCategoryPlayAndRecord)
@discussion 用于指定推流过程中需要采集和播放音频的权限
@warning 如无必要请勿修改
*/
@property (nonatomic, assign) NSString * AVAudioSessionCategory;
/**
@abstract 检查当前AVAudioSession的类别是否与设置的AVAudioSessionCategory 一致
@discussion AVAudioSession为公有的单例, APP中的其他SDK也可以修改
@discussion 因此可能出现直播时,改为无录音权限的类别的情况, 通过此方法进行检查
*/
- (BOOL) checkCategory;
#pragma mark - audio input ports
/**
@abstract 是否有蓝牙麦克风可用
@return 是/否有蓝牙麦克风可用
*/
+ (BOOL)isBluetoothInputAvaible;
/**
@abstract 选择是否使用蓝牙麦克风
@param onOrOff : YES 使用蓝牙麦克风 NO
@return 是/否有蓝牙麦克风可用
*/
+ (BOOL)switchBluetoothInput:(BOOL)onOrOff;
/**
@abstract 是否有耳机麦克风可用
@return 是/否有耳机麦克风
*/
+ (BOOL)isHeadsetInputAvaible;
/**
@abstract 查询当前是否有耳机(包括蓝牙耳机)
*/
+ (BOOL) isHeadsetPluggedIn;
/**
@abstract 当前使用的音频采集设备
@discussion 当设置新值时, 如果修改成功, 重新查询为新值, 修改不成功值不变
@discussion 参考 KSYMicType
*/
@property KSYMicType currentMicType;
@end