# IAudioMixingManager ```cpp class bytertc::IAudioMixingManager ``` > Deprecated since 353. Use [IAudioEffectPlayer](#IAudioEffectPlayer) and [IMediaPlayer](#IMediaPlayer) instead. 混音管理类 ## 成员函数 | 返回 | 名称 | | --- | --- | | virtual void | [deprecated] [startAudioMixing](#IAudioMixingManager-startaudiomixing) | | virtual void | [deprecated] [stopAudioMixing](#IAudioMixingManager-stopaudiomixing) | | virtual void | [deprecated] [pauseAudioMixing](#IAudioMixingManager-pauseaudiomixing) | | virtual void | [deprecated] [resumeAudioMixing](#IAudioMixingManager-resumeaudiomixing) | | virtual void | [deprecated] [preloadAudioMixing](#IAudioMixingManager-preloadaudiomixing) | | virtual void | [deprecated] [unloadAudioMixing](#IAudioMixingManager-unloadaudiomixing) | | virtual int | [deprecated] [getAudioMixingDuration](#IAudioMixingManager-getaudiomixingduration) | | virtual int | [deprecated] [getAudioMixingCurrentPosition](#IAudioMixingManager-getaudiomixingcurrentposition) | | virtual void | [deprecated] [setAudioMixingPosition](#IAudioMixingManager-setaudiomixingposition) | | virtual void | [deprecated] [setAudioMixingDualMonoMode](#IAudioMixingManager-setaudiomixingdualmonomode) | | virtual void | [deprecated] [setAudioMixingPitch](#IAudioMixingManager-setaudiomixingpitch) | | virtual int | [deprecated] [setAudioMixingPlaybackSpeed](#IAudioMixingManager-setaudiomixingplaybackspeed) | | virtual void | [deprecated] [setAudioMixingProgressInterval](#IAudioMixingManager-setaudiomixingprogressinterval) | | virtual void | [deprecated] [setAudioMixingLoudness](#IAudioMixingManager-setaudiomixingloudness) | | virtual void | [deprecated] [enableAudioMixingFrame](#IAudioMixingManager-enableaudiomixingframe) | | virtual void | [deprecated] [disableAudioMixingFrame](#IAudioMixingManager-disableaudiomixingframe) | | virtual int | [deprecated] [pushAudioMixingFrame](#IAudioMixingManager-pushaudiomixingframe) | | virtual int | [deprecated] [getAudioTrackCount](#IAudioMixingManager-getaudiotrackcount) | | virtual void | [deprecated] [selectAudioTrack](#IAudioMixingManager-selectaudiotrack) | ## 函数说明 ### startAudioMixing ```cpp virtual void bytertc::IAudioMixingManager::startAudioMixing( int mix_id, const char* file_path, const AudioMixingConfig &config )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 开始播放音频文件。可以通过传入不同的 ID 和 filepath 多次调用本方法，以实现同时播放多个混音文件，实现混音叠加。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID。用于标识混音，请保证混音 ID 唯一性。
如果使用相同的 ID 重复调用本方法后，前一次混音会停止，后一次混音开始，SDK 会使用 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged) 回调通知前一次混音已停止。 | | file_path | const char * | 用于混音文件路径。
支持在线文件的 URL 和本地文件的绝对路径。对于在线文件的 URL，仅支持 https 协议。
推荐的音频文件采样率：8KHz、16KHz、22.05KHz、44.1KHz、48KHz。
不同平台支持的本地音频文件格式:

	mp3	mp4	aac	m4a	3gp	wav	ogg	ts	wma
Android	Y	Y	Y	Y	Y	Y	Y
iOS/macOS	Y	Y	Y	Y	Y	Y
Windows	Y	Y	Y	Y	Y	Y		Y	Y

不同平台支持的在线音频文件格式:

	mp3	aac	m4a	3gp	wav	ts	wma
Android	Y	Y	Y	Y	Y
iOS/macOS	Y	Y	Y		Y
Windows	Y	Y	Y	Y	Y	Y	Y

| | config | const AudioMixingConfig & | 混音配置
可以设置混音的播放次数、是否本地播放混音、以及是否将混音发送至远端，详见 [AudioMixingConfig](85519#AudioMixingConfig)。 | **注意** - 如果已经通过 [preloadAudioMixing](#IAudioMixingManager-preloadaudiomixing) 将文件加载至内存，确保此处的 ID 与预加载时设置的 ID 相同。 - 调用本方法播放音频文件后，关于当前的混音状态，会收到回调 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged)。 - 开始播放音频文件后，可以调用 [stopAudioMixing](#IAudioMixingManager-stopaudiomixing) 方法停止播放音频文件。 - 本方法的混音数据来源于外部文件，而 [enableAudioMixingFrame](#IAudioMixingManager-enableaudiomixingframe) 的混音数据来源于外部缓存且音频格式为 PCM，这两种混音方式可以共存。 ### stopAudioMixing ```cpp virtual void bytertc::IAudioMixingManager::stopAudioMixing(int mix_id)=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 停止播放音频文件及混音。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int |
混音 ID | **注意** - 调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 方法开始播放音频文件及混音后，可以调用本方法停止播放音频文件及混音。 - 调用本方法停止播放音频文件后，SDK 会向本地回调通知已停止混音，见 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged)。 - 调用本方法停止播放音频文件后，该音乐文件会被自动卸载。 ### pauseAudioMixing ```cpp virtual void bytertc::IAudioMixingManager::pauseAudioMixing(int mix_id)=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 暂停播放音频文件及混音。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int |
混音 ID | **注意** - 调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 方法开始播放音频文件及混音后，可以通过调用本方法暂停播放音频文件及混音。 - 调用本方法暂停播放音频文件及混音后，可调用 [resumeAudioMixing](#IAudioMixingManager-resumeaudiomixing) 方法恢复播放及混音。 - 调用本方法暂停播放音频文件后，SDK 会向本地回调通知已暂停混音，见 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged)。 ### resumeAudioMixing ```cpp virtual void bytertc::IAudioMixingManager::resumeAudioMixing(int mix_id)=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 恢复播放音频文件及混音。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int |
混音 ID | **注意** - 调用 [pauseAudioMixing](#IAudioMixingManager-pauseaudiomixing) 方法暂停播放音频文件及混音后，可以通过调用本方法恢复播放及混音。 - 调用本方法恢复播放音频文件及混音后，SDK 会向本地回调通知音乐文件正在播放中，见 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged)。 ### preloadAudioMixing ```cpp virtual void bytertc::IAudioMixingManager::preloadAudioMixing( int mix_id, const char* file_path )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 预加载指定音乐文件到内存中，以避免频繁播放同一文件时的重复加载，减少 CPU 占用。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID。用于标识混音，请保证混音 ID 唯一性。
如果使用相同的 ID 重复调用本方法，后一次会覆盖前一次。
如果先调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing)，再使用相同的 ID 调用本方法，会先回调 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged) 通知上一个混音停止，然后加载后一个混音。
调用本方法预加载 A.mp3 后，如果需要使用相同的 ID 调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 播放 B.mp3，请先调用 [unloadAudioMixing](#IAudioMixingManager-unloadaudiomixing) 卸载 A.mp3。 | | file_path | const char * | 混音文件路径。仅支持本地文件的绝对路径。预加载的文件长度不得超过 20s。
不同平台支持的音频文件格式：

	mp3	mp4	aac	m4a	3gp	wav	ogg	ts	wma
Android	Y	Y	Y	Y	Y	Y	Y
iOS	Y	Y	Y	Y	Y	Y
Windows	Y	Y	Y	Y	Y	Y		Y	Y

| **注意** - 本方法只是预加载指定音频文件，只有调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 方法才开始播放指定音频文件。 - 调用本方法预加载音频文件后，关于当前的混音状态，会收到回调 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged)。 - 调用本方法预加载的指定音频文件可以通过 [unloadAudioMixing](#IAudioMixingManager-unloadaudiomixing) 卸载。 ### unloadAudioMixing ```cpp virtual void bytertc::IAudioMixingManager::unloadAudioMixing(int mix_id)=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 卸载指定音乐文件。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int |
混音 ID | **注意** 不论音乐文件是否播放，调用本方法卸载该文件后，SDK 会回调通知混音已停止，见 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged)。 ### getAudioMixingDuration ```cpp virtual int bytertc::IAudioMixingManager::getAudioMixingDuration(int mix_id)=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 获取音频文件时长。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int |
混音 ID | **返回值** - \>0: 成功, 音乐文件时长，单位为毫秒。 - < 0: 失败 **注意** 调用本方法获取音乐文件时长前，需要先调用 [preloadAudioMixing](#IAudioMixingManager-preloadaudiomixing) 或 [startAudioMixing](#IAudioMixingManager-startaudiomixing)。 ### getAudioMixingCurrentPosition ```cpp virtual int bytertc::IAudioMixingManager::getAudioMixingCurrentPosition(int mix_id)=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 获取音频文件播放进度。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int |
混音 ID | **返回值** - \>0: 成功, 音乐文件播放进度，单位为毫秒。 - < 0: 失败 **注意** 调用本方法获取音乐文件播放进度前，需要先调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 开始播放音乐文件。 ### setAudioMixingPosition ```cpp virtual void bytertc::IAudioMixingManager::setAudioMixingPosition( int mix_id, int position )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 设置音频文件的起始播放位置 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID | | position | int | 音频文件起始播放位置，单位为毫秒。
你可以通过 [getAudioMixingDuration](#IAudioMixingManager-getaudiomixingduration) 获取音频文件总时长，position 的值应小于音频文件总时长。 | **注意** 在播放在线文件时，调用此接口可能造成播放延迟的现象。 ### setAudioMixingDualMonoMode ```cpp virtual void bytertc::IAudioMixingManager::setAudioMixingDualMonoMode( int mix_id, AudioMixingDualMonoMode mode )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead 设置当前音频文件的声道模式 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID | | mode | AudioMixingDualMonoMode | 声道模式。默认的声道模式和源文件一致，详见 [AudioMixingDualMonoMode](85519#AudioMixingDualMonoMode)。 | **注意** - 调用本方法设置音频文件的声道模式前，需要先调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 开始播放音频文件。 - 此方法对 [enableAudioMixingFrame](#IAudioMixingManager-enableaudiomixingframe) 播放的音乐无效。 ### setAudioMixingPitch ```cpp virtual void bytertc::IAudioMixingManager::setAudioMixingPitch( int mix_id, int pitch )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 开启本地播放音乐文件变调功能，多用于 K 歌场景。使用该方法，你可以对本地播放音乐文件的音调进行升调或降调等调整。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID | | pitch | int | 相对于音乐文件原始音调的升高/降低值，取值范围[-12，12]，默认值为 0，即不做调整。
取值范围内每相邻两个值的音高距离相差半音，正值表示升调，负值表示降调，设置的绝对值越大表示音调升高或降低越多。
超出取值范围则设置失败，并且会触发 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged) 回调，提示 [AudioMixingState](85519#AudioMixingState) 状态为 `AUDIO_MIXING_STATE_FAILED` 混音播放失败， [AudioMixingError](85519#AudioMixingError) 错误码为 `AUDIO_MIXING_ERROR_ID_TYPE_INVALID_PITCH` 设置混音文件音调不合法。 | **注意** 本方法需要在调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 开始播放音频文件后、调用 [stopAudioMixing](#IAudioMixingManager-stopaudiomixing) 停止播放音频文件前使用，否则会触发 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged) 回调报错 ### setAudioMixingPlaybackSpeed ```cpp virtual int bytertc::IAudioMixingManager::setAudioMixingPlaybackSpeed( int mix_id, int speed )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead 设置混音时音频文件的播放速度 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID | | speed | int | 播放速度与原始文件速度的比例，单位：%，取值范围为 [50,200]，默认值为 100。
超出取值范围则设置失败，你会收到 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged) 回调，提示 [AudioMixingState](85519#AudioMixingState) 状态为 `kAudioMixingStateFailed` 混音播放失败， [AudioMixingError](85519#AudioMixingError) 错误码为 `kAudioMixingErrorInValidPlaybackSpeed` 设置混音文件的播放速度不合法。 | **注意** - 暂不支持对 PCM 音频数据进行变速调整。 - 你需要在调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 开始混音，并且收到 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged) 回调提示 [AudioMixingState](85519#AudioMixingState) 状态为 `kAudioMixingStatePlaying`， [AudioMixingError](85519#AudioMixingError) 错误码为 `kAudioMixingErrorOk` 之后调用该方法。 - 在 [stopAudioMixing](#IAudioMixingManager-stopaudiomixing) 停止混音或 [unloadAudioMixing](#IAudioMixingManager-unloadaudiomixing) 卸载音频文件后调用该 API，会收到状态为 `kAudioMixingStateFailed` 错误码为 `kAudioMixingErrorIdNotFound` 的 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged) 回调。 ### setAudioMixingProgressInterval ```cpp virtual void bytertc::IAudioMixingManager::setAudioMixingProgressInterval( int mix_id, int64_t interval )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead 设置混音时音频文件播放进度回调的间隔 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID
可以通过多次调用本接口传入不同的 ID 对多个 ID 进行间隔设置。 | | interval | int64_t | 音频文件播放进度回调的时间间隔，单位毫秒。

interval 的值为大于 0 的 10 的倍数，当设置的值不能被 10 整除时，则默认向上取整 10，如设为 52ms 时会默认调整为 60ms。设置完成后 SDK 将会按照设置的时间间隔触发 `onAudioMixingPlayingProgress` 回调。
interval 的值小于等于 0 时，不会触发进度回调。

| **注意** 本方法需要在调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 开始播放音频文件后、调用 [stopAudioMixing](#IAudioMixingManager-stopaudiomixing) 停止播放音频文件前使用，否则会触发 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged) 回调报错。若想在音乐文件开始播放前设置播放进度回调间隔，你需调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 在 [AudioMixingConfig](85519#AudioMixingConfig) 中设置时间间隔，开始播放后可以通过此接口更新回调间隔。 ### setAudioMixingLoudness ```cpp virtual void bytertc::IAudioMixingManager::setAudioMixingLoudness( int mix_id, float loudness )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead 如果你需要使用 `enableVocalInstrumentBalance` 对混音音频文件/PCM 音频数据进行音量调整，你必须通过此接口传入其原始响度。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID | | loudness | float | 原始响度，单位：lufs，取值范围为 [-70.0, 0.0]。
当设置的值小于 -70.0lufs 时，则默认调整为 -70.0lufs，大于 0.0lufs 时，则不对该响度做音均衡处理。默认值为 1.0lufs，即不做处理。 | **注意** 建议在 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 开始播放音频文件之前调用该接口，以免播放过程中的音量突变导致听感体验下降。 ### enableAudioMixingFrame ```cpp virtual void bytertc::IAudioMixingManager::enableAudioMixingFrame( int mix_id, AudioMixingType type )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead 启动 PCM 音频数据混音。要实现多个 PCM 音频数据混音，多次调用本方法，并传入不同的 mix_id。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID，用于标识混音，保证混音 ID 唯一性。
如果使用相同的 ID 重复调用本方法后，前一次混音会停止，后一次混音开始，会收到 [onAudioMixingStateChanged](85517#IRTCVideoEventHandler-onaudiomixingstatechanged) 通知前一次混音已停止。 | | type | AudioMixingType | 混音播放类型
是否本地播放、以及是否发送到远端，详见 [AudioMixingType](85519#AudioMixingType)。 | **注意** - 必须先调用本方法启动 PCM 音频数据混音，随后调用 [pushAudioMixingFrame](#IAudioMixingManager-pushaudiomixingframe) 方法，才会开始混音。 - 如要结束 PCM 音频数据混音，使用 [disableAudioMixingFrame](#IAudioMixingManager-disableaudiomixingframe)。 ### disableAudioMixingFrame ```cpp virtual void bytertc::IAudioMixingManager::disableAudioMixingFrame(int mix_id)=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead 关闭 PCM 混音 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID。 | ### pushAudioMixingFrame ```cpp virtual int bytertc::IAudioMixingManager::pushAudioMixingFrame( int mix_id, IAudioFrame* audio_frame )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead 推送 PCM 音频帧数据用于混音 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID。 | | audio_frame | IAudioFrame * | 音频帧，详见 [IAudioFrame](85519#IAudioFrame)。 | **返回值** - 0: 成功 - < 0: 失败 **注意** - 调用该方法前，须通过 [enableAudioMixingFrame](#IAudioMixingManager-enableaudiomixingframe) 启动外部音频流混音。 - 使用参考建议：首次推送数据，请在应用侧先缓存一定数据（如 100 毫秒），然后一次性推送过去；此后的推送操作定时 10 毫秒一次，并且每次的音频数据量为 10 毫秒数据量。要暂停播放，暂停推送即可。 ### getAudioTrackCount ```cpp virtual int bytertc::IAudioMixingManager::getAudioTrackCount(int mix_id)=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead 获取当前音频文件的音轨索引 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID | **返回值** 方法调用结果 - ≥ 0：成功，返回当前音频文件的音轨索引 - < 0：方法调用失败 **注意** - 调用本方法获取音频文件的音轨前，需要先调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 开始播放音频文件。 - 此方法对 [enableAudioMixingFrame](#IAudioMixingManager-enableaudiomixingframe) 播放的音频无效。 ### selectAudioTrack ```cpp virtual void bytertc::IAudioMixingManager::selectAudioTrack( int mix_id, int audio_track_index )=0 ``` > Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead 指定当前音频文件的播放音轨 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | mix_id | int | 混音 ID | | audio_track_index | int | 指定的播放音轨
设置的参数值需要小于或等于 [getAudioTrackCount](#IAudioMixingManager-getaudiotrackcount) 的返回值 | **注意** - 调用本方法设置音频文件的音轨前，需要先调用 [startAudioMixing](#IAudioMixingManager-startaudiomixing) 开始播放音频文件。 - 此方法对 [enableAudioMixingFrame](#IAudioMixingManager-enableaudiomixingframe) 播放的音乐无效。 # IRTCVideo ```cpp class bytertc::IRTCVideo ``` 引擎 API ## 成员函数 | 返回 | 名称 | | --- | --- | | virtual int | [muteAudioCapture](#IRTCVideo-muteaudiocapture) | | virtual int | [setCaptureVolume](#IRTCVideo-setcapturevolume) | | virtual int | [setPlaybackVolume](#IRTCVideo-setplaybackvolume) | | virtual int | [startAudioCapture](#IRTCVideo-startaudiocapture) | | virtual int | [stopAudioCapture](#IRTCVideo-stopaudiocapture) | | virtual int | [setAudioProfile](#IRTCVideo-setaudioprofile) | | virtual int | [setAnsMode](#IRTCVideo-setansmode) | | virtual int | [enableAGC](#IRTCVideo-enableagc) | | virtual int | [setAudioSourceType](#IRTCVideo-setaudiosourcetype) | | virtual int | [setAudioRenderType](#IRTCVideo-setaudiorendertype) | | virtual int | [pushExternalAudioFrame](#IRTCVideo-pushexternalaudioframe) | | virtual int | [pullExternalAudioFrame](#IRTCVideo-pullexternalaudioframe) | | virtual int | [startVideoCapture](#IRTCVideo-startvideocapture) | | virtual int | [stopVideoCapture](#IRTCVideo-stopvideocapture) | | virtual int | [setVideoCaptureConfig](#IRTCVideo-setvideocaptureconfig) | | virtual int | [setVideoCaptureRotation](#IRTCVideo-setvideocapturerotation) | | virtual int | [enableSimulcastMode](#IRTCVideo-enablesimulcastmode) | | virtual int | [setVideoEncoderConfig](#IRTCVideo-setvideoencoderconfig) | | virtual int | [setVideoEncoderConfig](#IRTCVideo-setvideoencoderconfig-3) | | virtual int | [setScreenVideoEncoderConfig](#IRTCVideo-setscreenvideoencoderconfig) | | virtual int | [disableAlphaChannelVideoEncode](#IRTCVideo-disablealphachannelvideoencode) | | virtual int | [setLocalVideoCanvas](#IRTCVideo-setlocalvideocanvas) | | virtual int | [updateLocalVideoCanvas](#IRTCVideo-updatelocalvideocanvas) | | virtual int | [setRemoteVideoCanvas](#IRTCVideo-setremotevideocanvas) | | virtual int | [pushScreenVideoFrame](#IRTCVideo-pushscreenvideoframe) | | virtual int | [updateScreenCaptureRegion](#IRTCVideo-updatescreencaptureregion) | | virtual int | [startScreenVideoCapture](#IRTCVideo-startscreenvideocapture) | | virtual int | [stopScreenVideoCapture](#IRTCVideo-stopscreenvideocapture) | | virtual int | [updateScreenCaptureHighlightConfig](#IRTCVideo-updatescreencapturehighlightconfig) | | virtual int | [updateScreenCaptureMouseCursor](#IRTCVideo-updatescreencapturemousecursor) | | virtual IScreenCaptureSourceList * | [getScreenCaptureSourceList](#IRTCVideo-getscreencapturesourcelist) | | virtual IVideoFrame * | [getThumbnail](#IRTCVideo-getthumbnail) | | virtual IVideoFrame * | [getWindowAppIcon](#IRTCVideo-getwindowappicon) | | virtual int | [setVideoSourceType](#IRTCVideo-setvideosourcetype) | | virtual int | [pushExternalVideoFrame](#IRTCVideo-pushexternalvideoframe) | | virtual IRTCRoom * | [createRTCRoom](#IRTCVideo-creatertcroom) | | virtual int | [setPublishFallbackOption](#IRTCVideo-setpublishfallbackoption) | | virtual int | [setSubscribeFallbackOption](#IRTCVideo-setsubscribefallbackoption) | | virtual int | [setRemoteUserPriority](#IRTCVideo-setremoteuserpriority) | | virtual int | [setBusinessId](#IRTCVideo-setbusinessid) | | virtual int | [setRemoteVideoMirrorType](#IRTCVideo-setremotevideomirrortype) | | virtual int | [setEncryptInfo](#IRTCVideo-setencryptinfo) | | virtual int | [setCustomizeEncryptHandler](#IRTCVideo-setcustomizeencrypthandler) | | virtual int | [enableAudioFrameCallback](#IRTCVideo-enableaudioframecallback) | | virtual int | [disableAudioFrameCallback](#IRTCVideo-disableaudioframecallback) | | virtual int | [registerAudioFrameObserver](#IRTCVideo-registeraudioframeobserver) | | virtual int | [registerAudioProcessor](#IRTCVideo-registeraudioprocessor) | | virtual int | [enableAudioProcessor](#IRTCVideo-enableaudioprocessor) | | virtual int | [disableAudioProcessor](#IRTCVideo-disableaudioprocessor) | | virtual int | [registerLocalVideoProcessor](#IRTCVideo-registerlocalvideoprocessor) | | virtual int | [setVideoDigitalZoomConfig](#IRTCVideo-setvideodigitalzoomconfig) | | virtual int | [setVideoDigitalZoomControl](#IRTCVideo-setvideodigitalzoomcontrol) | | virtual int | [startVideoDigitalZoomControl](#IRTCVideo-startvideodigitalzoomcontrol) | | virtual int | [stopVideoDigitalZoomControl](#IRTCVideo-stopvideodigitalzoomcontrol) | | virtual int | [sendSEIMessage](#IRTCVideo-sendseimessage-2) | | virtual IVideoDeviceManager * | [getVideoDeviceManager](#IRTCVideo-getvideodevicemanager) | | virtual IAudioDeviceManager * | [getAudioDeviceManager](#IRTCVideo-getaudiodevicemanager) | | virtual int | [startFileRecording](#IRTCVideo-startfilerecording) | | virtual int | [stopFileRecording](#IRTCVideo-stopfilerecording) | | virtual int | [startAudioRecording](#IRTCVideo-startaudiorecording) | | virtual int | [stopAudioRecording](#IRTCVideo-stopaudiorecording) | | virtual int | [enableExternalSoundCard](#IRTCVideo-enableexternalsoundcard) | | virtual int | [setRuntimeParameters](#IRTCVideo-setruntimeparameters) | | virtual int | [feedback](#IRTCVideo-feedback) | | virtual IAudioEffectPlayer * | [getAudioEffectPlayer](#IRTCVideo-getaudioeffectplayer) | | virtual IMediaPlayer * | [getMediaPlayer](#IRTCVideo-getmediaplayer) | | virtual int | [login](#IRTCVideo-login) | | virtual int | [logout](#IRTCVideo-logout) | | virtual int | [updateLoginToken](#IRTCVideo-updatelogintoken) | | virtual int | [setServerParams](#IRTCVideo-setserverparams) | | virtual int | [getPeerOnlineStatus](#IRTCVideo-getpeeronlinestatus) | | virtual int64_t | [sendUserMessageOutsideRoom](#IRTCVideo-sendusermessageoutsideroom) | | virtual int64_t | [sendUserBinaryMessageOutsideRoom](#IRTCVideo-senduserbinarymessageoutsideroom) | | virtual int64_t | [sendServerMessage](#IRTCVideo-sendservermessage) | | virtual int64_t | [sendServerBinaryMessage](#IRTCVideo-sendserverbinarymessage) | | virtual int | [startNetworkDetection](#IRTCVideo-startnetworkdetection) | | virtual int | [stopNetworkDetection](#IRTCVideo-stopnetworkdetection) | | virtual int | [startScreenAudioCapture](#IRTCVideo-startscreenaudiocapture) | | virtual int | [stopScreenAudioCapture](#IRTCVideo-stopscreenaudiocapture) | | virtual int | [setAudioAlignmentProperty](#IRTCVideo-setaudioalignmentproperty) | | virtual int | [startPushPublicStream](#IRTCVideo-startpushpublicstream) | | virtual int | [stopPushPublicStream](#IRTCVideo-stoppushpublicstream) | | virtual int | [updatePublicStreamParam](#IRTCVideo-updatepublicstreamparam) | | virtual int | [enableAudioPropertiesReport](#IRTCVideo-enableaudiopropertiesreport) | | virtual int | [setRemoteAudioPlaybackVolume](#IRTCVideo-setremoteaudioplaybackvolume) | | virtual int | [enableVocalInstrumentBalance](#IRTCVideo-enablevocalinstrumentbalance) | | virtual int | [enablePlaybackDucking](#IRTCVideo-enableplaybackducking) | | virtual int | [registerLocalEncodedVideoFrameObserver](#IRTCVideo-registerlocalencodedvideoframeobserver) | | virtual int | [registerRemoteEncodedVideoFrameObserver](#IRTCVideo-registerremoteencodedvideoframeobserver) | | virtual int | [setExternalVideoEncoderEventHandler](#IRTCVideo-setexternalvideoencodereventhandler) | | virtual int | [pushExternalEncodedVideoFrame](#IRTCVideo-pushexternalencodedvideoframe) | | virtual int | [setVideoDecoderConfig](#IRTCVideo-setvideodecoderconfig) | | virtual int | [requestRemoteVideoKeyFrame](#IRTCVideo-requestremotevideokeyframe) | | virtual int | [sendStreamSyncInfo](#IRTCVideo-sendstreamsyncinfo) | | virtual int | [setLocalVoicePitch](#IRTCVideo-setlocalvoicepitch) | | virtual int | [startPlayPublicStream](#IRTCVideo-startplaypublicstream) | | virtual int | [stopPlayPublicStream](#IRTCVideo-stopplaypublicstream) | | virtual int | [setPublicStreamVideoCanvas](#IRTCVideo-setpublicstreamvideocanvas) | | virtual int | [setPublicStreamVideoSink](#IRTCVideo-setpublicstreamvideosink) | | virtual int | [setPublicStreamAudioPlaybackVolume](#IRTCVideo-setpublicstreamaudioplaybackvolume) | | virtual int | [setVideoWatermark](#IRTCVideo-setvideowatermark) | | virtual int | [clearVideoWatermark](#IRTCVideo-clearvideowatermark) | | virtual int | [setDummyCaptureImagePath](#IRTCVideo-setdummycaptureimagepath) | | virtual int | [startCloudProxy](#IRTCVideo-startcloudproxy) | | virtual int | [stopCloudProxy](#IRTCVideo-stopcloudproxy) | | virtual int | [setLocalProxy](#IRTCVideo-setlocalproxy) | | virtual int | [setLowLightAdjusted](#IRTCVideo-setlowlightadjusted) | | virtual int | [deprecated] [setVideoEncoderConfig](#IRTCVideo-setvideoencoderconfig-4) | | virtual int | [deprecated] [updateRemoteStreamVideoCanvas](#IRTCVideo-updateremotestreamvideocanvas) | | virtual int | [setLocalVideoSink](#IRTCVideo-setlocalvideosink) | | virtual int | [setRemoteVideoSink](#IRTCVideo-setremotevideosink) | | virtual int | [deprecated] [sendSEIMessage](#IRTCVideo-sendseimessage) | | virtual IAudioMixingManager * | [deprecated] [getAudioMixingManager](#IRTCVideo-getaudiomixingmanager) | | virtual int | [deprecated] [muteAudioPlayback](#IRTCVideo-muteaudioplayback) | ## 函数说明 ### muteAudioCapture ```cpp virtual int bytertc::IRTCVideo::muteAudioCapture( StreamIndex index, bool mute )=0 ``` > Available since 3.58.1 设置是否将采集到的音频信号静音，而不影响改变本端硬件采集状态。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | index | StreamIndex | 流索引，指定调节主流/屏幕流音量，参看 [StreamIndex](70083#streamindex-2)。 | | mute | bool | 是否静音采集信号。

True：是
False：否

| **返回值** - 0: 调用成功。 - < 0 : 调用失败。具体失败原因参看 [ReturnStatus](85519#ReturnStatus)。 **注意** - 该方法用于设置是否使用静音数据替换设备采集到的音频数据进行推流，不影响 SDK 音频流的采集发布状态。对于 Windows 平台，如有需要你也可以选择静音整个系统的音频采集，具体参看 [setAudioCaptureDeviceMute](#IAudioDeviceManager-setaudiocapturedevicemute) 方法说明。 - 静音后通过 [setCaptureVolume](#IRTCVideo-setcapturevolume) 调整音量不会取消静音状态，音量状态会保存至取消静音。 - 调用 [startAudioCapture](#IRTCVideo-startaudiocapture) 开启音频采集前后，都可以使用此接口设置采集音量。 ### setCaptureVolume ```cpp virtual int bytertc::IRTCVideo::setCaptureVolume( StreamIndex index, int volume )=0 ``` 调节音频采集音量 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | index | StreamIndex | 流索引，指定调节主流还是调节屏幕流的音量，参看 [StreamIndex](85519#StreamIndex) | | volume | int | 采集的音量值和原始音量的比值，范围是 [0, 400]，单位为 %，自带溢出保护。
只改变音频数据的音量信息，不涉及本端硬件的音量调节。
为保证更好的通话质量，建议将 volume 值设为 [0,100]。

0：静音
100：原始音量
400: 最大可为原始音量的 4 倍(自带溢出保护)

| **返回值** - 0: 调用成功。 - < 0 : 调用失败。查看 [ReturnStatus](85519#ReturnStatus) 获得更多错误说明 **注意** 在开启音频采集前后，你都可以使用此接口设定采集音量。 ### setPlaybackVolume ```cpp virtual int bytertc::IRTCVideo::setPlaybackVolume(const int volume)=0 ``` 调节本地播放的所有远端用户音频混音后的音量，混音内容包括远端人声、音乐、音效等。播放音频前或播放音频时，你都可以使用此接口设定播放音量。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | volume | const int | 音频播放音量值和原始音量的比值，范围是 [0, 400]，单位为 %，自带溢出保护。
只改变音频数据的音量信息，不涉及本端硬件的音量调节。
为保证更好的通话质量，建议将 volume 值设为 [0,100]。

0: 静音
100: 原始音量
400: 最大可为原始音量的 4 倍(自带溢出保护)

| **返回值** - 0: 调用成功。 - < 0 : 调用失败。查看 [ReturnStatus](85519#ReturnStatus) 获得更多错误说明 **注意** 假设某远端用户 A 始终在被调节的目标用户范围内，当该方法与 [setRemoteAudioPlaybackVolume](#IRTCVideo-setremoteaudioplaybackvolume) 或 [setRemoteRoomAudioPlaybackVolume](#IRTCRoom-setremoteroomaudioplaybackvolume) 共同使用时，本地收听用户 A 的音量将为两次设置的音量效果的叠加。 ### startAudioCapture ```cpp virtual int bytertc::IRTCVideo::startAudioCapture()=0 ``` 开启内部音频采集。默认为关闭状态。内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。调用该方法开启后，本地用户会收到 [onAudioDeviceStateChanged](85517#IRTCVideoEventHandler-onaudiodevicestatechanged) 的回调。非隐身用户进房后调用该方法，房间中的其他用户会收到 [onUserStartAudioCapture](85517#IRTCVideoEventHandler-onuserstartaudiocapture) 的回调。 **返回值** - 0: 调用成功。 - < 0 : 调用失败。查看 [ReturnStatus](85519#ReturnStatus) 获得更多错误说明 **注意** - 若未取得当前设备的麦克风权限，调用该方法后会触发 [onAudioDeviceStateChanged](85517#IRTCVideoEventHandler-onaudiodevicestatechanged) 回调，对应的错误码为 `MediaDeviceError.kMediaDeviceErrorDeviceNoPermission = 1`。 - 调用 [stopAudioCapture](#IRTCVideo-stopaudiocapture) 可以关闭音频采集设备，否则，SDK 只会在销毁引擎的时候自动关闭设备。 - 由于不同硬件设备初始化响应时间不同，频繁调用 [stopAudioCapture](#IRTCVideo-stopaudiocapture) 和本接口闭麦/开麦可能出现短暂无声问题，建议使用 [publishStream](#IRTCRoom-publishstream)/ [unpublishStream](#IRTCRoom-unpublishstream) 实现临时闭麦和重新开麦。 - 创建引擎后，无论是否发布音频数据，你都可以调用该方法开启音频采集，并且调用后方可发布音频。 - 对于 Windows SDK，如果需要从自定义音频采集切换为内部音频采集，你必须先停止发布流，调用 [setAudioSourceType](#IRTCVideo-setaudiosourcetype) 关闭自定义采集，再调用此方法手动开启内部采集。 ### stopAudioCapture ```cpp virtual int bytertc::IRTCVideo::stopAudioCapture()=0 ``` 立即关闭内部音频采集。默认为关闭状态。内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。调用该方法，本地用户会收到 [onAudioDeviceStateChanged](85517#IRTCVideoEventHandler-onaudiodevicestatechanged) 的回调。非隐身用户进房后调用该方法后，房间中的其他用户会收到 [onUserStopAudioCapture](85517#IRTCVideoEventHandler-onuserstopaudiocapture) 的回调。 **返回值** - 0: 调用成功。 - < 0 : 调用失败。查看 [ReturnStatus](85519#ReturnStatus) 获得更多错误说明 **注意** - 调用 [startAudioCapture](#IRTCVideo-startaudiocapture) 可以开启音频采集设备。 - 如果不调用本方法停止内部视频采集，则只有当销毁引擎实例时，内部音频采集才会停止。 ### setAudioProfile ```cpp virtual int bytertc::IRTCVideo::setAudioProfile(AudioProfileType audio_profile)=0 ``` 设置音质档位。当所选的 [RoomProfileType](85519#RoomProfileType) 中的音频参数无法满足你的场景需求时，调用本接口切换的音质档位。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | audio_profile | AudioProfileType | 音质档位，参看 [AudioProfileType](85519#AudioProfileType) | **返回值** - 0: 调用成功。 - < 0 : 调用失败。查看 [ReturnStatus](85519#ReturnStatus) 获得更多错误说明 **注意** - 该方法在进房前后均可调用； - 支持通话过程中动态切换音质档位。 ### setAnsMode ```cpp virtual int bytertc::IRTCVideo::setAnsMode(AnsMode ans_mode)=0 ``` > Available since 3.52 支持根据业务场景，设置通话中的音频降噪模式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | ans_mode | AnsMode | 降噪模式。具体参见 [AnsMode](85519#AnsMode)。 | **返回值** - 0: 调用成功。 - < 0 : 调用失败。查看 [ReturnStatus](85519#ReturnStatus) 获得更多错误说明 **注意** - 该接口进房前后均可调用，可重复调用，仅最后一次调用生效。 - 降噪算法包含传统降噪和 AI 降噪。传统降噪主要是抑制平稳噪声，比如空调声、风扇声等。而 AI 降噪主要是抑制非平稳噪声，比如键盘敲击声、桌椅碰撞声等。 - 只有以下 [RoomProfileType](85519#RoomProfileType) 场景时，调用本接口可以开启 AI 降噪。其余场景的 AI 降噪不会生效。 - 游戏语音模式：kRoomProfileTypeGame - 高音质游戏模式：kRoomProfileTypeGameHD - 云游戏模式：kRoomProfileTypeCloudGame - 1 vs 1 音视频通话：kRoomProfileTypeChat - 多端同步播放音视频：kRoomProfileTypeLwTogether - 云端会议中的个人设备：kRoomProfileTypeMeeting - 课堂互动模式：kRoomProfileTypeClassroom - 云端会议中的会议室终端：kRoomProfileTypeMeetingRoom ### enableAGC ```cpp virtual int bytertc::IRTCVideo::enableAGC(bool enable)=0 ``` > Available since 3.51 打开/关闭 AGC(Automatic Gain Control) 自动增益控制功能。开启该功能后，SDK 会自动调节麦克风的采集音量，确保音量稳定。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | enable | bool | 是否打开 AGC 功能:

true: 打开 AGC 功能。
false: 关闭 AGC 功能。

| **返回值** - 0: 调用成功。 - -1: 调用失败。 **注意** 该方法在进房前后均可调用。如果你需要在进房前使用 AGC 功能，请联系技术支持获得私有参数，传入对应 [RoomProfileType](85519#RoomProfileType)。要想在进房后开启 AGC 功能，你需要把 [RoomProfileType](85519#RoomProfileType) 设置为 `kRoomProfileTypeMeeting` 、`kRoomProfileTypeMeetingRoom` 或 `kRoomProfileTypeClassroom` 。 AGC 功能生效后，不建议再调用 [setAudioCaptureDeviceVolume](#IAudioDeviceManager-setaudiocapturedevicevolume) 来调节设备麦克风的采集音量。 ### setAudioSourceType ```cpp virtual int bytertc::IRTCVideo::setAudioSourceType (AudioSourceType type) = 0 ``` 切换音频采集方式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | type |AudioSourceType | 音频数据源，详见 [AudioSourceType](85519#AudioSourceType)
默认使用内部音频采集。音频采集和渲染方式无需对应。 | **返回值** - >0: 切换成功。 - -1：切换失败。 **注意** - 进房前后调用此方法均有效。 - 如果你调用此方法由内部采集切换至自定义采集，SDK 会自动关闭内部采集。然后，调用 [pushExternalAudioFrame](#IMediaPlayer-pushexternalaudiofram) 推送自定义采集的音频数据到 RTC SDK 用于传输。 - 如果你调用此方法由自定义采集切换至内部采集，你必须再调用 [startAudioCapture](#IRTCVideo-startaudiocapture) 手动开启内部采集。 ### setAudioRenderType ```cpp virtual int bytertc::IRTCVideo::setAudioRenderType (AudioRenderType type) = 0 ``` 切换音频渲染方式。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | type |AudioRenderType | 音频输出类型，详见 [AudioRenderType](85519#AudioRenderType)。
默认使用内部音频渲染。音频采集和渲染方式无需对应。 | **返回值** - >0: 切换成功。 - -1：切换失败。 **注意** - 进房前后调用此方法均有效。 - 如果你调用此方法切换至自定义渲染，调用 [pullExternalAudioFrame](#IRTCVideo-pullexternalaudioframe} 获取音频数据。 ### pushExternalAudioFrame ```cpp virtual int bytertc::IRTCVideo::pushExternalAudioFrame(IAudioFrame* audio_frame) = 0 ``` 推送自定义采集的音频数据到 RTC SDK。 **传入参数** | 参数名 | 类型 | 说明 | | --- | --- | --- | | audio_frame | IAudioFrame * | 10 ms 对应的音频数据。详见 [IAudioFrame](85519#IAudioFrame)。

音频采样格式必须为 S16。音频缓冲区内的数据格式必须为 PCM，其容量大小应该为 audioFrame.samples × audioFrame.channel × 2。
必须指定具体的采样率和声道数，不支持设置为自动。

true：开启
false：关闭（默认）

选择本地采集的音频时，会收到 [onProcessRecordAudioFrame](85517#IAudioFrameProcessor-onprocessrecordaudioframe)。
选择远端音频流的混音音频时，会收到 [onProcessPlayBackAudioFrame](85517#IAudioFrameProcessor-onprocessplaybackaudioframe)。
选择远端音频流时，会收到 [onProcessRemoteUserAudioFrame](85517#IAudioFrameProcessor-onprocessremoteuseraudioframe)。
选择屏幕共享音频流时，会收到 [onProcessScreenAudioFrame](85517#IAudioFrameProcessor-onprocessscreenaudioframe)。（Linux 不适用）

设置为 `kVideoPixelFormatUnknown` 时，RTC SDK 给出供 processor 处理的视频帧格式即采集的格式。你可以通过 [VideoFrameType](85519#VideoFrameType) 和 [VideoPixelFormat](85519#VideoPixelFormat) 获取实际采集的视频帧格式和像素类型。
设置为 `kVideoPixelFormatI420` 时，RTC SDK 会将采集得到的视频帧转变为对应的格式，供前处理使用。
设置为其他值时，此方法调用失败。

`kZoomConfigTypeFocusOffset`：缩放系数增量，范围为 [0, 7]。例如，设置为 0.5 时，如果调用 [setVideoDigitalZoomControl](#IRTCVideo-setvideodigitalzoomcontrol) 选择 Zoom in，则缩放系数增加 0.5。缩放系数范围 [1，8]，默认为 `1`，原始大小。
`kZoomConfigTypeMoveOffset`：移动百分比，范围为 [0, 0.5]，默认为 0，不移动。如果调用 [setVideoDigitalZoomControl](#IRTCVideo-setvideodigitalzoomcontrol) 选择的是左右移动，则移动距离为 size x 原始视频宽度；如果选择的是上下移动，则移动距离为 size x 原始视频高度。例如，视频帧边长为 1080 px，设置为 0.5 时，实际移动距离为 0.5 x 1080 px = 540 px。

true: 开启
false: 不开启(默认)

0: 静音
100: 原始音量，默认值
400: 最大可为原始音量的 4 倍(自带溢出保护)

true: 是
false: 否

true: 是
false: 否

true: 可见，用户可以在房间内发布音视频流，房间中的其他用户将收到用户的行为通知，例如进房、开启视频采集和退房。
false: 不可见，用户不可以在房间内发布音视频流，房间中的其他用户不会收到用户的行为通知，例如进房、开启视频采集和退房。

使用不同 App ID 的 App 是不能互通的。
请务必保证生成 Token 使用的 App ID 和创建引擎时使用的 App ID 相同，否则会导致加入房间失败。

0: 静音
100: 原始音量，默认值
400: 最大可为原始音量的 4 倍(自带溢出保护)

	mp3	mp4	aac	m4a	3gp	wav	ogg	ts	wma
Android	Y	Y	Y	Y	Y	Y	Y
iOS/macOS	Y	Y	Y	Y	Y	Y
Windows	Y	Y	Y	Y	Y	Y		Y	Y

	mp3	aac	m4a	3gp	wav	ts	wma
Android	Y	Y	Y	Y	Y
iOS/macOS	Y	Y	Y		Y
Windows	Y	Y	Y	Y	Y	Y	Y

interval > 0 时，触发回调。实际间隔为 10 的倍数。如果输入数值不能被 10 整除，将自动向上取整。例如传入 `52`，实际间隔为 60 ms。
interval <= 0 时，不会触发回调。

音频采样格式必须为 S16。音频缓冲区内的数据格式必须为 PCM，其容量大小应该为 audioFrame.samples × audioFrame.channel × 2。
必须指定具体的采样率和声道数，不支持设置为自动。

	mp3	mp4	aac	m4a	3gp	wav	ogg	ts	wma
Android	Y	Y	Y	Y	Y	Y	Y
iOS/macOS	Y	Y	Y	Y	Y	Y
Windows	Y	Y	Y	Y	Y	Y		Y	Y

	mp3	aac	m4a	3gp	wav	ts	wma
Android	Y	Y	Y	Y	Y
iOS/macOS	Y	Y	Y		Y
Windows	Y	Y	Y	Y	Y	Y	Y

true: 跟随。此时，调用 [setAudioPlaybackDevice](#IAudioDeviceManager-setaudioplaybackdevice) 会失败。默认值。
false: 不跟随系统。此时，可以调用 [setAudioPlaybackDevice](#IAudioDeviceManager-setaudioplaybackdevice) 进行设置。

true: 跟随。此时，调用 [setAudioCaptureDevice](#IAudioDeviceManager-setaudiocapturedevice) 会失败。默认值。
false: 不跟随系统。此时，可以调用 [setAudioCaptureDevice](#IAudioDeviceManager-setaudiocapturedevice) 进行设置。

[0,25] 接近无声；
[25,75] 为低音量；
[76,204] 为中音量；
[205,255] 为高音量。

[0,25] 接近无声；
[25,75] 为低音量；
[76,204] 为中音量；
[205,255] 为高音量。

[0,25] 接近无声；
[25,75] 为低音量；
[76,204] 为中音量；
[205,255] 为高音量。

[0,25] 接近无声；
[25,75] 为低音量；
[76,204] 为中音量；
[205,255] 为高音量。

true：静音
false：非静音

true：静音
false：非静音

true：静音
false：非静音

true：静音
false：非静音

1: 是。
0: 否。

实时音视频