QNMicrophoneAudioTrack
- @property (nonatomic, readonly) NSString *userID;
-
一路 Track 所属用户的唯一标识
- @property (nonatomic, strong) NSString *trackID;
-
一路 Track 在 Server 端的唯一标识
发布成功时由 SDK 自动生成,订阅/Mute 等操作依据此 trackID 来确定相应的 Track
- @property (nonatomic, readonly) QNTrackKind kind;
-
标识该路 Track 是音频还是视频
- @property (nonatomic, strong) NSString *tag;
-
Track 的 tag
- @property (nonatomic, assign, readonly) BOOL muted;
-
标识 Track 是否为 mute 状态
- @property (nonatomic, weak) id<QNLocalAudioTrackDelegate> delegate;
-
本地音频 Track 回调代理
- - (void)updateMute:(BOOL)mute;
-
更新当前 Track 的 mute 值,静默后,SDK 将会发送静默帧数据
当静默状态改变后,远端用户将会收到 QNRemoteAudioTrackDelegate.didMuteStateChanged 的回调
Parameters-
mute: BOOL
是否静默 Track
-
- - (void)destroy;
-
销毁本地音/视频 Track
在不使用该 Track 之后,请务必调用此接口
- - (void)setVolume:(double)volume;
-
设置当前音频输入设备采集的音量大小
音量值在 0.0 ~ 1.0 之间为软件缩小;1.0 为原始音量;大于 1.0 且小于 10.0 为软件放大
在需要放大时,应从 1.x 开始设置,用最小的放大值来取得合适的播放效果,过大将会导致音频音调异常
该设置可以用于适度对采集音量做放大或者缩小
当麦克风输入音量增益调大之后,部分机型会出现噪音
Parameters-
volume: double
音量值
-
- - (float)getVolumeLevel;
-
用户音量回调,volume 值在 [0, 1] 之间
Returns float
- - (QNAudioMusicMixer *)createAudioMusicMixer:(NSString *)musicPath musicMixerDelegate:(id<QNAudioMusicMixerDelegate>)musicMixerDelegate;
-
创建背景音乐混音对象实例
音频格式支持 aac、mp3、mp4、wav、m4r、caf、ogg、opus、m4a、flac
1. 背景音乐混音仅支持同时混合一路背景音乐,若需要切换背景音乐,重新调用本接口创建 QNAudioMusicMixer 即可
2. 建议使用本地文件进行混音,以避免网络环境差引起的混音异常
3. 若您希望在混合背景音乐的同时添加音效,可参考音效混音相关接口 QNAudioEffectMixer
Parameters-
musicPath: NSString
音乐文件地址
-
musicMixerDelegate: QNAudioMusicMixerDelegate
背景音乐混音代理
Returns QNAudioMusicMixer -
- - (void)destroyAudioMusicMixer;
-
销毁背景音乐混音类
- - (QNAudioEffectMixer *)createAudioEffectMixer:(id<QNAudioEffectMixerDelegate>)effectMixerDelegate;
-
创建音效混音对象实例
音效混音支持同时混合多路音效文件
Parameters-
effectMixerDelegate: QNAudioEffectMixerDelegate
音效混音代理
Returns 音效混音对象实例 -
- - (void)destroyAudioEffectMixer;
-
销毁多音效混音类
- - (QNAudioSourceMixer *)createAudioSourceMixer:(id<QNAudioSourceMixerDelegate>)sourceMixerDelegate;
-
创建音源混音对象实例
音源混音支持同时混合多路 PCM 音频裸数据
Parameters-
sourceMixerDelegate: QNAudioSourceMixerDelegate
音源混音代理
Returns 音源混音对象实例 -
- - (void)destroyAudioSourceMixer;
-
销毁多音源混音类
- - (void)setEarMonitorEnabled:(BOOL)enabled;
-
设置耳返开关,默认为 NO
为达到最佳体验,建议佩戴耳机的场景下,使用该功能
Parameters-
enabled: BOOL
开关
-
- - (BOOL)getEarMonitorEnabled;
-
是否开启了耳返
Returns BOOL
- - (void)setPlayingVolume:(float)volume;
-
设置混音、返听场景下,本地播放的音量大小,范围 0 ~ 1.0
Parameters-
volume: float
播放音量
-
- - (float)getPlayingVolume
-
获取播放音量
Returns float,范围 0 ~ 1.0