QNMicrophoneAudioTrack
- getTrackID
- getUserID
- getTag
- isAudio
- isVideo
- isMuted
- setMuted
- destroy
- setAudioFrameListener
- setMicrophoneEventListener
- setVolume
- getVolumeLevel
- createAudioMusicMixer
- createAudioEffectMixer
- createAudioSourceMixer
- setEarMonitorEnabled
- isEarMonitorEnabled
- setPlayingVolume
- getPlayingVolume
- createAudioMixer
- String getTrackID()
-
获取 TrackID,仅当发布成功后,才可以获取到有效的 TrackID
Returns String
- String getUserID()
-
获取 UserID
Returns String
- String getTag()
-
获取 Tag
Returns String
- boolean isAudio()
-
是否为音频 Track
Returns boolean
- boolean isVideo()
-
是否为视频 Track
Returns boolean
- boolean isMuted()
-
该 Track 是否处于静默状态
Returns boolean
- void setMuted(boolean muted)
-
设置是否静默该 track,静默后,SDK 将会发送静默帧数据
当静默状态改变后,远端用户将会收到 QNTrackInfoChangedListener.onMuteStateChanged 的回调
Parameters-
muted: boolean
是否静默
-
- void destroy()
-
销毁本地创建的 Track
- void setAudioFrameListener(QNAudioFrameListener listener)
-
设置音频数据监听
Parameters-
listener: QNAudioFrameListener
音频数据监听接口
-
- void setMicrophoneEventListener(QNMicrophoneEventListener listener)
-
设置麦克风事件监听,可用于监听麦克风启动和采集过程中的错误信息
Parameters-
listener: QNMicrophoneEventListener
麦克风事件监听接口
-
- void setVolume(double volume)
-
设置当前音频输入设备采集的音量大小
音量值在 0.0 - 1.0 之间为软件缩小;1.0 为原始音量;大于 1.0 且小于 10.0 为软件放大
在需要放大时,应从 1.x 开始设置,用最小的放大值来取得合适的播放效果,过大将会导致音频音调异常
该设置可以用于适度对采集音量做放大或者缩小
Parameters-
volume: double
采集音量大小,[0.0 - 10.0],默认值为 1.0
-
- float getVolumeLevel()
-
获取当前音频输入设备采集的音量大小
可通过定时调用该方法获取音量值的方式来判断当前用户是否在讲话
在安静的环境下,获取到 0.0x 大小的数值为预期现象,您可根据您的需求自行决定判断的阈值
Returns 采集音频音量大小
- QNAudioMusicMixer createAudioMusicMixer(String musicPath, QNAudioMusicMixerListener listener)
-
创建背景音乐混音控制器对象
支持本地和在线文件,支持的文件格式为:aac、mp3、mp4、ogg、opus、wav、m4a、flac
注意:
1. 背景音乐混音仅支持同时混合一路背景音乐,若需要切换背景音乐,重新调用本接口创建 QNAudioMusicMixer 即可
2. 建议使用本地文件进行混音,以避免网络环境差引起的混音异常
3. 若您希望在混合背景音乐的同时添加音效,可参考音效混音相关接口(QNAudioEffectMixer)
Parameters-
musicPath: String
音频文件路径,支持本地文件和在线文件
-
listener: QNAudioMusicMixerListener
混音控制器监听接口
Returns QNAudioMusicMixer -
- QNAudioEffectMixer createAudioEffectMixer(QNAudioEffectMixerListener listener)
-
创建音效混音控制器对象
音效混音支持同时混合多路音效文件
Parameters-
listener: QNAudioEffectMixerListener
音效混音控制器监听接口
Returns QNAudioEffectMixer -
- QNAudioSourceMixer createAudioSourceMixer(QNAudioSourceMixerListener listener)
-
创建音源混音控制器对象
音源混音支持同时混合多路音源
Parameters-
listener: QNAudioSourceMixerListener
混音器监听接口
Returns QNAudioSourceMixer -
- void setEarMonitorEnabled(boolean enabled)
-
开启、关闭返听
为达到最佳体验,建议佩戴耳机的场景下,使用该功能
Parameters-
enabled: boolean
是否开启返听
-
- boolean isEarMonitorEnabled()
-
获取当前是否开启、关闭返听
Returns 返听开启状态
- void setPlayingVolume(float playingVolume)
-
设置混音、返听场景下,本地播放的音量大小
Parameters-
playingVolume: float
音量,[0.0f - 1.0f],默认值为 1.0f
-
- float getPlayingVolume()
-
获取混音、返听场景下,本地播放的音量大小
Returns 混音、返听场景下,本地播放的音量大小
- QNAudioMixer createAudioMixer(String musicPath, QNAudioMixerListener listener)
-
创建混音控制器对象
注意:
1. 当前仅支持同一时间混一路音频,重复对不同的 QNAudioMixer 执行 start 操作,后面的会覆盖前面的,即以后执行 start 的音频混音控制器为准进行混音
2. 建议使用本地文件进行混音,以避免网络环境差引起的混音异常
该接口已废弃
最新接口实现,背景音乐混音可参考 QNAudioMusicMixer,音效混音可参考 QNAudioEffectMixer
Parameters-
musicPath: String
音频文件路径,支持本地文件和在线文件
-
listener: QNAudioMixerListener
混音器监听接口
Returns QNAudioMixer -