KSYAudioMixer.h
3.76 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
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
//
// KSYAudioMixer.h
// KSYStreamer
//
//
// Created by pengbin on 10/15/15.
// Copyright © 2015 ksy. All rights reserved.
//
#import <Foundation/Foundation.h>
#import <AVFoundation/AVFoundation.h>
#pragma mark - audio format
/** 多路pcm混音
1. 用trackId来表示某一路音频，从0开始编号
2. 要求一定要有一路麦克风的音频，其他音频都叠加到麦克风上
3. 将输入的音频pcm数据存入buffer，每一路音频的buffer独立
4. 每次麦克风的音频输入，都会触发从所有buffer中取数据，混合，发送的动作
5. 每一路音频可以单独配置音量
6. 输出格式固定为 44.1KHz, S16 (声道数可设定)
*/
@interface KSYAudioMixer : NSObject
/**
@abstract 获取最大支持的混合路数
**/
- (int)getMaxMixTrack;
/**
@abstract 设置混音音量（默认音量为1.0）
@param vol 音量比例（0.0~2.0） (<1.0 为缩小, > 1.0为放大)
@param trackId 设置对应track的
@return NO为设置失败，如track不存在，或vol超出范围
@warning 设置放大的音量可能会出现爆音, 请注意
**/
- (BOOL) setMixVolume:(float) vol
of:(int) trackId;
/**
@abstract 查询track的音量
@param trackId 设置对应track的
@return 负数为查询失败，如track不存在
**/
- (float) getMixVolume:(int) trackId;
/**
@abstract 开启/关闭一路声音
@param onOff 开关， 0号track默认开启
@param trackId 开关对应track
@return NO为设置失败，比如trackID不存在
**/
- (BOOL) setTrack:(int) trackId
enable:(BOOL)onOff;
/**
@abstract 查询track是否开启
@param trackId 开关对应track
**/
- (BOOL) getTrackEnable:(int) trackId;
/**
@abstract 查询track中缓存数据的长度（单位为一次输出的samplebuffer数）
@param trackId 开关对应track
@return <0, 表示查询失败
=0，表示残余的数据不足一次输出
>0, 表示可以buffer中的数据还可以输出n次
**/
- (int) getBufLength:(int) trackId;
/**
@abstract 输入音频PCM
@param sampleBuffer 音频数据
@param trackId 设置对应track的
@return NO为设置失败，比如trackID不存在
*/
- (BOOL)processAudioSampleBuffer:(CMSampleBufferRef)sampleBuffer
of:(int) trackId;
/**
@abstract 输入音频PCM
@param pData 原始数据
@param len 数据的长度，单位为字节
@param fmt 原始数据的格式
@param pts 原始数据的时间戳
@param trackId 设置对应track的
@return NO为设置失败，比如trackID不存在
@discussion 传入数据为NULL时，仅仅检查是否有数据输出
*/
- (BOOL)processAudioData:(uint8_t**)pData
nbSample:(int)len
withFormat:(const AudioStreamBasicDescription*)fmt
timeinfo:(CMTime)pts
of:(int) trackId;
/**
@abstract 音频处理回调接口
@discussion sampleBuffer 混音后的音频数据
@discussion 请注意本函数的执行时间，如果太长可能导致不可预知的问题
@discussion 请参考 CMSampleBufferRef
*/
@property(nonatomic, copy) void(^audioProcessingCallback)(CMSampleBufferRef sampleBuffer);
/**
@abstract 主轨的trackId （默认为0）
@discussion 比如micphone的track，所有track都同步到主轨的时间轴
*/
@property(nonatomic, assign) int mainTrack;
/**
@abstract 输出音频是否为双声道立体声 (默认为NO)
@discussion 如果输入数据都不是双声道则输出数据左右耳内容一样
*/
@property(nonatomic, assign) BOOL bStereo;
/**
@abstract 混音后输出PCM的格式
@discussion 暂时为固定一种格式 (44.1KHz, S16)
*/
@property (nonatomic, readonly) AudioStreamBasicDescription* outFmtDes;
@end