class bytertc::IVideoEffect
cpp

高级视频特效，参看集成指南。

virtual bytertc::IVideoEffect::~IVideoEffect()=default
cpp

virtual int bytertc::IVideoEffect::initCVResource(
    const char* license_file_path,
    const char* algo_model_dir
)=0
cpp

检查视频特效证书，设置算法模型路径，并初始化特效模块。

传入参数

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

virtual int bytertc::IVideoEffect::getAuthMessage(
    char* *ppmsg,
    int* len
)=0
cpp

从特效 SDK 获取授权消息，用于获取在线许可证。

传入参数

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

注意

• 使用视频特效的功能前，你必须获取特效 SDK 的在线许可证。
• 通过此接口获取授权消息后，你必须参考 在线授权说明 自行实现获取在线许可证的业务逻辑。获取许可证后，你必须调用 initCVResource 确认许可证有效。然后，你才可以使用 CV 功能。
• 获取授权消息后，调用 freeAuthMessage 释放内存。

virtual int bytertc::IVideoEffect::freeAuthMessage(char* pmsg)=0
cpp

使用完授权消息字符串后，释放内存。

传入参数

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

virtual int bytertc::IVideoEffect::enableVideoEffect()=0
cpp

开启高级美颜、滤镜等视频特效。

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

注意

• 调用本方法前，必须先调用 initCVResource 进行初始化。
• 调用该方法后，特效不直接生效，你还需调用 setEffectNodes 设置视频特效素材包或调用 setColorFilter 设置滤镜。
• 调用 disableVideoEffect 关闭视频特效。

virtual int bytertc::IVideoEffect::disableVideoEffect()=0
cpp

关闭视频特效。

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

注意

调用 enableVideoEffect 开启视频特效。

virtual int bytertc::IVideoEffect::setEffectNodes(
    const char* *effect_node_paths,
    int node_num
)=0
cpp

设置视频特效素材包。

传入参数

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

注意

调用本方法前，必须先调用 enableVideoEffect。

virtual int bytertc::IVideoEffect::updateEffectNode(
    const char* effect_node_path,
    const char* node_key,
    float node_value
)=0
cpp

设置特效强度。

传入参数

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

virtual int bytertc::IVideoEffect::setColorFilter(const char* res_path)=0
cpp

设置颜色滤镜。

传入参数

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

注意

调用 setColorFilterIntensity 设置已启用颜色滤镜的强度。设置强度为 0 时即关闭颜色滤镜。

virtual int bytertc::IVideoEffect::setColorFilterIntensity(float intensity)=0
cpp

设置已启用颜色滤镜的强度。

传入参数

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

virtual int bytertc::IVideoEffect::enableFaceDetection(
    IFaceDetectionObserver* observer,
    unsigned int interval_ms,
    const char* face_model_path
)=0
cpp

开启人脸识别功能，并设置人脸检测结果回调观察者。

此观察者后，你会周期性收到 onFaceDetectResult 回调。

传入参数

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• -1004: 初始化中，初始化完成后启动此功能。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

virtual int bytertc::IVideoEffect::disableFaceDetection()=0
cpp

关闭人脸识别功能。

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

virtual void bytertc::IVideoEffect::setAlgoModelPath(const char* model_path)=0
cpp

Deprecated since 3.50 and will be deleted in 3.55, use initCVResource instead.

设置视频特效算法模型路径

传入参数

virtual int bytertc::IVideoEffect::checkLicense(
    void* android_context,
    void* jnienv,
    const char* license_path
)=0
cpp

Deprecated since 3.50 and will be deleted in 3.55, use initCVResource instead.

视频特效许可证检查

传入参数

返回值

• 0: 调用成功。
• 1000: 未集成特效 SDK。
• 1001: 特效 SDK 不支持该功能。
• < 0: 调用失败。具体错误码，参看 错误码表。

注意

开始使用视频特效前，你必须先调用这个方法进行许可证验证

virtual int bytertc::IVideoEffect::enableEffect(bool enabled)=0
cpp

Deprecated since 3.50 and will be deleted in 3.55, use enableVideoEffect instead.

开启关闭视频特效

传入参数

返回值

• 0: 调用成功。
• 1000: 未集成特效 SDK。
• 1001: 特效 SDK 不支持该功能。
• < 0: 调用失败。具体错误码，参看 错误码表。

注意

在调用 CheckLicense 和 SetAlgoModelPath 后调用此方法。

virtual int bytertc::IVideoEffect::updateNode(
    const char* node_path,
    const char* node_key,
    float node_value
)=0
cpp

Deprecated since 3.50 and will be deleted in 3.55, use updateEffectNode instead.

设置特效强度

传入参数

返回值

• 0: 调用成功。
• 1000: 未集成特效 SDK。
• 1001: 特效 SDK 不支持该功能。
• < 0: 调用失败。具体错误码，参看 错误码表。

virtual int bytertc::IVideoEffect::registerFaceDetectionObserver(
    IFaceDetectionObserver* observer,
    int interval_ms
)=0
cpp

Deprecated since 3.50 and will be deleted in 3.55, use enableFaceDetection and disableFaceDetection instead.

注册人脸检测结果回调观察者。

注册此观察者后，你会周期性收到 onFaceDetectResult 回调。

传入参数

返回值

• 0: 调用成功。
• –1000: 未集成特效 SDK。
• –1001: 特效 SDK 不支持该功能。
• –1002: 特效 SDK 版本不兼容。
• < 0: 调用失败，错误码对应具体描述参看 错误码表。

class bytertc::IAudioMixingManager
cpp

Deprecated since 353. Use IAudioEffectPlayer and IMediaPlayer instead.

混音管理类

virtual void bytertc::IAudioMixingManager::startAudioMixing(
    int mix_id,
    const char* file_path,
    const AudioMixingConfig &config
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

开始播放音频文件。

可以通过传入不同的 ID 和 filepath 多次调用本方法，以实现同时播放多个混音文件，实现混音叠加。

传入参数

注意

• 如果已经通过 preloadAudioMixing 将文件加载至内存，确保此处的 ID 与预加载时设置的 ID 相同。
• 调用本方法播放音频文件后，关于当前的混音状态，会收到回调 onAudioMixingStateChanged。
• 开始播放音频文件后，可以调用 stopAudioMixing 方法停止播放音频文件。
• 本方法的混音数据来源于外部文件，而 enableAudioMixingFrame 的混音数据来源于外部缓存且音频格式为 PCM，这两种混音方式可以共存。

virtual void bytertc::IAudioMixingManager::stopAudioMixing(int mix_id)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

停止播放音频文件及混音。

传入参数

注意

• 调用 startAudioMixing 方法开始播放音频文件及混音后，可以调用本方法停止播放音频文件及混音。
• 调用本方法停止播放音频文件后，SDK 会向本地回调通知已停止混音，见 onAudioMixingStateChanged。
• 调用本方法停止播放音频文件后，该音乐文件会被自动卸载。

virtual void bytertc::IAudioMixingManager::pauseAudioMixing(int mix_id)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

暂停播放音频文件及混音。

传入参数

注意

• 调用 startAudioMixing 方法开始播放音频文件及混音后，可以通过调用本方法暂停播放音频文件及混音。
• 调用本方法暂停播放音频文件及混音后，可调用 resumeAudioMixing 方法恢复播放及混音。
• 调用本方法暂停播放音频文件后，SDK 会向本地回调通知已暂停混音，见 onAudioMixingStateChanged。

virtual void bytertc::IAudioMixingManager::resumeAudioMixing(int mix_id)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

恢复播放音频文件及混音。

传入参数

注意

• 调用 pauseAudioMixing 方法暂停播放音频文件及混音后，可以通过调用本方法恢复播放及混音。
• 调用本方法恢复播放音频文件及混音后，SDK 会向本地回调通知音乐文件正在播放中，见 onAudioMixingStateChanged。

virtual void bytertc::IAudioMixingManager::preloadAudioMixing(
    int mix_id,
    const char* file_path
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

预加载指定音乐文件到内存中，以避免频繁播放同一文件时的重复加载，减少 CPU 占用。

传入参数

注意

• 本方法只是预加载指定音频文件，只有调用 startAudioMixing 方法才开始播放指定音频文件。
• 调用本方法预加载音频文件后，关于当前的混音状态，会收到回调 onAudioMixingStateChanged。
• 调用本方法预加载的指定音频文件可以通过 unloadAudioMixing 卸载。

virtual void bytertc::IAudioMixingManager::unloadAudioMixing(int mix_id)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

卸载指定音乐文件。

传入参数

注意

不论音乐文件是否播放，调用本方法卸载该文件后，SDK 会回调通知混音已停止，见 onAudioMixingStateChanged。

virtual int bytertc::IAudioMixingManager::getAudioMixingDuration(int mix_id)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

获取音频文件时长。

传入参数

返回值

• >0: 成功, 音乐文件时长，单位为毫秒。
• < 0: 失败

注意

调用本方法获取音乐文件时长前，需要先调用 preloadAudioMixing 或 startAudioMixing。

virtual int bytertc::IAudioMixingManager::getAudioMixingCurrentPosition(int mix_id)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

获取音频文件播放进度。

传入参数

返回值

• >0: 成功, 音乐文件播放进度，单位为毫秒。
• < 0: 失败

注意

调用本方法获取音乐文件播放进度前，需要先调用 startAudioMixing 开始播放音乐文件。

virtual void bytertc::IAudioMixingManager::setAudioMixingPosition(
    int mix_id,
    int position
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

设置音频文件的起始播放位置

传入参数

注意

在播放在线文件时，调用此接口可能造成播放延迟的现象。

virtual void bytertc::IAudioMixingManager::setAudioMixingDualMonoMode(
    int mix_id,
    AudioMixingDualMonoMode mode
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead

设置当前音频文件的声道模式

传入参数

注意

• 调用本方法设置音频文件的声道模式前，需要先调用 startAudioMixing 开始播放音频文件。
• 此方法对 enableAudioMixingFrame 播放的音乐无效。

virtual void bytertc::IAudioMixingManager::setAudioMixingPitch(
    int mix_id,
    int pitch
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

开启本地播放音乐文件变调功能，多用于 K 歌场景。

使用该方法，你可以对本地播放音乐文件的音调进行升调或降调等调整。

传入参数

注意

本方法需要在调用 startAudioMixing 开始播放音频文件后、调用 stopAudioMixing 停止播放音频文件前使用，否则会触发 onAudioMixingStateChanged 回调报错

virtual int bytertc::IAudioMixingManager::setAudioMixingPlaybackSpeed(
    int mix_id,
    int speed
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer or IAudioEffectPlayer instead

设置混音时音频文件的播放速度

传入参数

注意

• 暂不支持对 PCM 音频数据进行变速调整。
• 你需要在调用 startAudioMixing 开始混音，并且收到 onAudioMixingStateChanged 回调提示 AudioMixingState 状态为 kAudioMixingStatePlaying， AudioMixingError 错误码为 kAudioMixingErrorOk 之后调用该方法。
• 在 stopAudioMixing 停止混音或 unloadAudioMixing 卸载音频文件后调用该 API，会收到状态为 kAudioMixingStateFailed 错误码为 kAudioMixingErrorIdNotFound 的 onAudioMixingStateChanged 回调。

virtual void bytertc::IAudioMixingManager::setAudioMixingProgressInterval(
    int mix_id,
    int64_t interval
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead

设置混音时音频文件播放进度回调的间隔

传入参数

注意

本方法需要在调用 startAudioMixing 开始播放音频文件后、调用 stopAudioMixing 停止播放音频文件前使用，否则会触发 onAudioMixingStateChanged 回调报错。

若想在音乐文件开始播放前设置播放进度回调间隔，你需调用 startAudioMixing 在 AudioMixingConfig 中设置时间间隔，开始播放后可以通过此接口更新回调间隔。

virtual void bytertc::IAudioMixingManager::setAudioMixingLoudness(
    int mix_id,
    float loudness
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead

如果你需要使用 enableVocalInstrumentBalance 对混音音频文件/PCM 音频数据进行音量调整，你必须通过此接口传入其原始响度。

传入参数

注意

建议在 startAudioMixing 开始播放音频文件之前调用该接口，以免播放过程中的音量突变导致听感体验下降。

virtual void bytertc::IAudioMixingManager::enableAudioMixingFrame(
    int mix_id,
    AudioMixingType type
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead

启动 PCM 音频数据混音。

要实现多个 PCM 音频数据混音，多次调用本方法，并传入不同的 mix_id。

传入参数

注意

• 必须先调用本方法启动 PCM 音频数据混音，随后调用 pushAudioMixingFrame 方法，才会开始混音。
• 如要结束 PCM 音频数据混音，使用 disableAudioMixingFrame。

virtual void bytertc::IAudioMixingManager::disableAudioMixingFrame(int mix_id)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead

关闭 PCM 混音

传入参数

virtual int bytertc::IAudioMixingManager::pushAudioMixingFrame(
    int mix_id,
    IAudioFrame* audio_frame
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead

推送 PCM 音频帧数据用于混音

传入参数

返回值

• 0: 成功
• < 0: 失败

注意

• 调用该方法前，须通过 enableAudioMixingFrame 启动外部音频流混音。
• 使用参考建议：首次推送数据，请在应用侧先缓存一定数据（如 100 毫秒），然后一次性推送过去；此后的推送操作定时 10 毫秒一次，并且每次的音频数据量为 10 毫秒数据量。要暂停播放，暂停推送即可。

virtual int bytertc::IAudioMixingManager::getAudioTrackCount(int mix_id)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead

获取当前音频文件的音轨索引

传入参数

返回值

方法调用结果

• ≥ 0：成功，返回当前音频文件的音轨索引
• < 0：方法调用失败

注意

• 调用本方法获取音频文件的音轨前，需要先调用 startAudioMixing 开始播放音频文件。
• 此方法对 enableAudioMixingFrame 播放的音频无效。

virtual void bytertc::IAudioMixingManager::selectAudioTrack(
    int mix_id,
    int audio_track_index
)=0
cpp

Deprecated since 353.1, will be deleted in 359, use IMediaPlayer instead

指定当前音频文件的播放音轨

传入参数

注意

• 调用本方法设置音频文件的音轨前，需要先调用 startAudioMixing 开始播放音频文件。
• 此方法对 enableAudioMixingFrame 播放的音乐无效。

class bytertc::IRTCVideo
cpp

引擎 API

virtual int bytertc::IRTCVideo::muteAudioCapture(
    StreamIndex index,
    bool mute
)=0
cpp

Available since 3.58.1

设置是否将采集到的音频信号静音，而不影响改变本端硬件采集状态。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。具体失败原因参看 ReturnStatus。

注意

• 该方法用于设置是否使用静音数据替换设备采集到的音频数据进行推流，不影响 SDK 音频流的采集发布状态。对于 Windows 平台，如有需要你也可以选择静音整个系统的音频采集，具体参看 setAudioCaptureDeviceMute 方法说明。
• 静音后通过 setCaptureVolume 调整音量不会取消静音状态，音量状态会保存至取消静音。
• 调用 startAudioCapture 开启音频采集前后，都可以使用此接口设置采集音量。

virtual int bytertc::IRTCVideo::setCaptureVolume(
    StreamIndex index,
    int volume
)=0
cpp

调节音频采集音量

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

在开启音频采集前后，你都可以使用此接口设定采集音量。

virtual int bytertc::IRTCVideo::setPlaybackVolume(const int volume)=0
cpp

调节本地播放的所有远端用户音频混音后的音量，混音内容包括远端人声、音乐、音效等。

播放音频前或播放音频时，你都可以使用此接口设定播放音量。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

假设某远端用户 A 始终在被调节的目标用户范围内，当该方法与 setRemoteAudioPlaybackVolume 或 setRemoteRoomAudioPlaybackVolume 共同使用时，本地收听用户 A 的音量将为两次设置的音量效果的叠加。

virtual int bytertc::IRTCVideo::startAudioCapture()=0
cpp

开启内部音频采集。默认为关闭状态。

内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。

调用该方法开启后，本地用户会收到 onAudioDeviceStateChanged 的回调。

非隐身用户进房后调用该方法，房间中的其他用户会收到 onUserStartAudioCapture 的回调。

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 若未取得当前设备的麦克风权限，调用该方法后会触发 onAudioDeviceStateChanged 回调，对应的错误码为 MediaDeviceError.kMediaDeviceErrorDeviceNoPermission = 1。
• 调用 stopAudioCapture 可以关闭音频采集设备，否则，SDK 只会在销毁引擎的时候自动关闭设备。
• 由于不同硬件设备初始化响应时间不同，频繁调用 stopAudioCapture 和本接口闭麦/开麦可能出现短暂无声问题，建议使用 publishStream/ unpublishStream 实现临时闭麦和重新开麦。
• 创建引擎后，无论是否发布音频数据，你都可以调用该方法开启音频采集，并且调用后方可发布音频。
• 对于 Windows SDK，如果需要从自定义音频采集切换为内部音频采集，你必须先停止发布流，调用 setAudioSourceType 关闭自定义采集，再调用此方法手动开启内部采集。

virtual int bytertc::IRTCVideo::stopAudioCapture()=0
cpp

立即关闭内部音频采集。默认为关闭状态。

内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。

调用该方法，本地用户会收到 onAudioDeviceStateChanged 的回调。

非隐身用户进房后调用该方法后，房间中的其他用户会收到 onUserStopAudioCapture 的回调。

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用 startAudioCapture 可以开启音频采集设备。
• 如果不调用本方法停止内部视频采集，则只有当销毁引擎实例时，内部音频采集才会停止。

virtual int bytertc::IRTCVideo::setAudioProfile(AudioProfileType audio_profile)=0
cpp

设置音质档位。

当所选的 RoomProfileType 中的音频参数无法满足你的场景需求时，调用本接口切换的音质档位。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 该方法在进房前后均可调用；
• 支持通话过程中动态切换音质档位。

virtual int bytertc::IRTCVideo::setAnsMode(AnsMode ans_mode)=0
cpp

支持根据业务场景，设置通话中的音频降噪模式。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 该接口进房前后均可调用，可重复调用，仅最后一次调用生效。
• 降噪算法包含传统降噪和 AI 降噪。传统降噪主要是抑制平稳噪声，比如空调声、风扇声等。而 AI 降噪主要是抑制非平稳噪声，比如键盘敲击声、桌椅碰撞声等。
• 在 V3.57.1 之前的版本，只有以下 RoomProfileType 场景时，调用本接口可以开启 AI 降噪。其余场景的 AI 降噪不会生效。
  • 游戏语音模式：kRoomProfileTypeGame
  • 高音质游戏模式：kRoomProfileTypeGameHD
  • 云游戏模式：kRoomProfileTypeCloudGame
  • 1 vs 1 音视频通话：kRoomProfileTypeChat
  • 多端同步播放音视频：kRoomProfileTypeLwTogether
  • 云端会议中的个人设备：kRoomProfileTypeMeeting
  • 课堂互动模式：kRoomProfileTypeClassroom
  • 云端会议中的会议室终端：kRoomProfileTypeMeetingRoom

virtual int bytertc::IRTCVideo::enableAGC(bool enable)=0
cpp

Available since 3.51

打开/关闭 AGC(Automatic Gain Control) 自动增益控制功能。

开启该功能后，SDK 会自动调节麦克风的采集音量，确保音量稳定。

传入参数

返回值

• 0: 调用成功。
• -1: 调用失败。

注意

该方法在进房前后均可调用。如果你需要在进房前使用 AGC 功能，请联系技术支持获得私有参数，传入对应 RoomProfileType。

要想在进房后开启 AGC 功能，你需要把 RoomProfileType 设置为 kRoomProfileTypeMeeting 、kRoomProfileTypeMeetingRoom 或 kRoomProfileTypeClassroom 。

AGC 功能生效后，不建议再调用 setAudioCaptureDeviceVolume 来调节设备麦克风的采集音量。

virtual int bytertc::IRTCVideo::startVideoCapture()=0
cpp

立即开启内部视频采集。默认为关闭状态。

内部视频采集指：使用 RTC SDK 内置视频采集模块，进行采集。

调用该方法后，本地用户会收到 onVideoDeviceStateChanged 的回调。

本地用户在非隐身状态下调用该方法后，房间中的其他用户会收到 onUserStartVideoCapture 的回调。

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用 stopVideoCapture 可以停止内部视频采集。否则，只有当销毁引擎实例时，内部视频采集才会停止。
• 创建引擎后，无论是否发布视频数据，你都可以调用该方法开启内部视频采集。只有当（内部或外部）视频采集开始以后视频流才会发布。
• 如果需要从自定义视频采集切换为内部视频采集，你必须先关闭自定义采集，再调用此方法手动开启内部采集。

virtual int bytertc::IRTCVideo::stopVideoCapture()=0
cpp

立即关闭内部视频采集。默认为关闭状态。

内部视频采集指：使用 RTC SDK 内置视频采集模块，进行采集。

调用该方法后，本地用户会收到 onVideoDeviceStateChanged 的回调。

非隐身用户进房后调用该方法，房间中的其他用户会收到 onUserStopVideoCapture 的回调。

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用 startVideoCapture 可以开启内部视频采集。
• 如果不调用本方法停止内部视频采集，则只有当销毁引擎实例时，内部视频采集才会停止。

virtual int bytertc::IRTCVideo::setVideoCaptureConfig(const VideoCaptureConfig &video_capture_config)=0
cpp

设置 RTC SDK 内部采集时的视频采集参数。

如果你的项目使用了 SDK 内部采集模块，可以通过本接口指定视频采集参数，包括模式、分辨率、帧率。

传入参数

返回值

• 0: 成功；
• < 0: 失败；

注意

• 本接口在引擎创建后可调用，调用后立即生效。建议在调用 startVideoCapture 前调用本接口。
• 建议同一设备上的不同引擎使用相同的视频采集参数。
• 如果调用本接口前使用内部模块开始视频采集，采集参数默认为 Auto 模式。

virtual int bytertc::IRTCVideo::setVideoCaptureRotation(VideoRotation rotation)=0
cpp

设置本端采集的视频帧的旋转角度。

当摄像头倒置或者倾斜安装时，可调用本接口进行调整。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用本接口也将对自定义采集视频画面生效，在原有的旋转角度基础上叠加本次设置。
• 对于 Windows SDK，视频贴纸特效或通过 enableVirtualBackground 增加的虚拟背景，也会跟随本接口的设置进行旋转。

virtual int bytertc::IRTCVideo::enableSimulcastMode(bool enabled)=0
cpp

该方法设置视频流发布端是否开启发布多路编码参数不同的视频流的模式。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 你应在进房前或进房后但未发布流时，调用此方法。
• 开启推送多路流后，不能动态关闭，也不能更新多路流的路数和编码参数。
• 开启推送多路视频流模式后，你可以在发布流前调用 setVideoEncoderConfig 为多路视频流分别设置编码参数。
• 该功能关闭时，或该功能开启但未设置多路流参数时，默认只发一路视频流，该流的编码参数为：分辨率 640px × 360px，帧率 15fps。

virtual int bytertc::IRTCVideo::setVideoEncoderConfig(const VideoEncoderConfig &max_solution)=0
cpp

视频发布端设置期望发布的最大分辨率视频流参数，包括分辨率、帧率、码率、网络不佳时的回退策略等。

该接口支持设置一路视频流参数，设置多路参数请使用重载 API：setVideoEncoderConfig。

传入参数

返回值

方法调用结果：

• 0：成功
• !0：失败

注意

• 你可以同时使用 enableSimulcastMode 方法来发布多路分辨率不同的流。具体而言，若期望发布多路不同分辨率的流，你需要在发布流之前调用本方法以及 enableSimulcastMode 方法开启多路流模式，SDK 会根据订阅端的设置智能调整发布的流数（最多发布 4 条）以及各路流的参数。其中，调用本方法设置的分辨率为各路流中的最大分辨率。具体规则参看推送多路流文档。
• 调用该方法前，SDK 默认仅发布一条分辨率为 640px × 360px，帧率为 15fps 的视频流。
• 使用自定义采集时，必须调用该方法设置编码参数，以保证远端收到画面的完整性。
• 该方法适用于摄像头采集的视频流，设置屏幕共享视频流参数参看 setScreenVideoEncoderConfig（Linux 不适用）。

virtual int bytertc::IRTCVideo::setVideoEncoderConfig(
    const VideoEncoderConfig* channel_solutions,
    int solution_num
)=0
cpp

视频发布端设置推送多路流时各路流的参数，包括分辨率、帧率、码率、网络不佳时的回退策略等。

传入参数

返回值

方法调用结果：

• 0：成功
• !0：失败

注意

• 该方法设置的多路参数是否均生效，取决于是否同时调用了 enableSimulcastMode 开启发布多路参数不同的视频流模式。若未开启推送多路流模式，但调用本方法设置了多个分辨率，SDK 则默认发布设置的第一条流，多个分辨率的设置会在开启推送多路流模式之后生效。
• 若期望推送多路不同分辨率的流，你需要在发布流之前调用本方法以及 enableSimulcastMode 方法。
• 开启推送多路流后，不能动态关闭，也不能更新多路流的路数和编码参数。
• 调用该方法设置多路视频流参数前，SDK 默认仅发布一条分辨率为 640px × 360px，帧率为 15fps 的视频流。
• 调用该方法设置分辨率不同的多条流后，SDK 会根据订阅端设置的期望订阅参数自动匹配发送的流，具体规则参看推送多路流文档。
• 该方法适用于摄像头采集的视频流，设置屏幕共享视频流参数参看 setScreenVideoEncoderConfig（Linux 不适用）。

virtual int bytertc::IRTCVideo::setScreenVideoEncoderConfig(const ScreenVideoEncoderConfig &screen_solution)=0
cpp

为发布的屏幕共享视频流设置期望的编码参数，包括分辨率、帧率、码率、网络不佳时的回退策略等。

传入参数

返回值

0：成功。

!0：失败。

注意

建议在采集视频前设置编码参数。若采集前未设置编码参数，则使用默认编码参数: 分辨率 1920px × 1080px，帧率 15fps。

virtual int bytertc::IRTCVideo::disableAlphaChannelVideoEncode(StreamIndex streamIndex)=0
cpp

Available since 3.58

关闭外部采集视频帧的 Alpha 通道编码功能。

传入参数

返回值

方法调用结果：

• 0：成功；
• !0：失败。

注意

该接口须在停止发布视频流之后调用。

virtual int bytertc::IRTCVideo::setLocalVideoCanvas(
    StreamIndex index,
    const VideoCanvas &canvas
)=0
cpp

设置本地视频渲染时使用的视图，并设置渲染模式。

传入参数

返回值

• 0：成功
• !0：失败

注意

• 你应在加入房间前，绑定本地视图。退出房间后，此设置仍然有效。
• 如果需要解除绑定，你可以调用本方法传入空视图。

virtual int bytertc::IRTCVideo::updateLocalVideoCanvas(
    StreamIndex index,
    const enum RenderMode render_mode,
    const uint32_t background_color
)=0
cpp

修改本地视频渲染模式和背景色。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

你可以在本地视频渲染过程中，调用此接口。调用结果会实时生效。

virtual int bytertc::IRTCVideo::setRemoteVideoCanvas(
    RemoteStreamKey stream_key,
    const VideoCanvas &canvas
)=0
cpp

设置渲染指定视频流 stream_key 时，使用的视图和渲染模式。

如果需要解除某个用户的绑定视图，你可以把 canvas 设置为空。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

本地用户离开房间时，会解除调用此 API 建立的绑定关系；远端用户离开房间则不会影响。

virtual int bytertc::IRTCVideo::setLocalVideoRender(
    StreamIndex index,
    IVideoSink* video_sink,
    LocalVideoSinkConfig &render_config
)=0
cpp

Available since 3.57

将本地视频流与自定义渲染器绑定。你可以通过参数设置返回指定位置和格式的视频帧数据。

传入参数

返回值

• 0: 调用成功。
• < 0: 调用失败。查看 ReturnStatus 获得更多错误说明。

注意

• RTC SDK 默认使用自带的渲染器（内部渲染器）进行视频渲染。
• 退房时将清除绑定状态。
• 如果需要解除绑定，你必须将 video_sink 设置为 null。
• 一般在收到 onFirstLocalVideoFrameCaptured 回调通知完成本地视频首帧采集后，调用此方法为视频流绑定自定义渲染器；然后加入房间。

virtual int bytertc::IRTCVideo::setRemoteVideoRender(
    RemoteStreamKey stream_key,
    IVideoSink* video_sink,
    RemoteVideoSinkConfig &config
)=0
cpp

Available since 3.57

将远端视频流与自定义渲染器绑定。你可以通过参数设置返回指定位置和格式的视频帧数据。

传入参数

返回值

• 0: 调用成功。
• < 0: 调用失败。查看 ReturnStatus 获得更多错误说明。

注意

• RTC SDK 默认使用自带的渲染器（内部渲染器）进行视频渲染。
• 该方法进房前后均可以调用。若想在进房前调用，你需要在加入房间前获取远端流信息；若无法预先获取远端流信息，你可以在加入房间并通过 onUserPublishStream 回调获取到远端流信息之后，再调用该方法。
• 退房时将清除绑定状态。
• 如果需要解除绑定，你必须将 video_sink 设置为 null。

virtual int bytertc::IRTCVideo::pushScreenVideoFrame(IVideoFrame* frame)=0
cpp

推送屏幕视频帧

传入参数

返回值

方法调用结果：

• 0：成功；
• <0：失败。具体失败原因参看 ReturnStatus。

注意

• 支持格式：I420, NV12, RGBA, BGRA, ARGB。不支持 RGB 24。
• 该函数运行在用户调用线程内，即将销毁 IRTCVideo 实例前，请停止调用该函数推送屏幕共享数据

virtual int bytertc::IRTCVideo::updateScreenCaptureRegion(const Rectangle &region_rect)=0
cpp

通过 RTC SDK 提供的采集模块采集屏幕视频流时，更新采集区域。仅用于采集源为显示器屏幕时。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

调用此接口前，必须已通过调用 startScreenVideoCapture 开启了内部屏幕流采集。

virtual int bytertc::IRTCVideo::startScreenVideoCapture(
    const ScreenCaptureSourceInfo &source_info,
    const ScreenCaptureParameters &capture_params
)=0
cpp

采集屏幕视频流，用于共享。屏幕视频流包括：屏幕上显示的内容，应用窗口中显示的内容，或虚拟屏幕中显示的内容。

其中，虚拟屏幕中显示的内容仅在 Windows 平台上支持。

传入参数

返回值

• 0: 成功
• -1: 失败

注意

• 调用本接口时，采集模式应为内部模式。在外部采集模式下调用无效，并将触发 onVideoDeviceWarning 回调。
• 调用此方法仅开启屏幕流视频采集，不会发布采集到的视频。发布屏幕流视频需要调用 publishScreen。
• 调用 stopScreenVideoCapture 关闭屏幕视频源采集。
• 本地用户通过 onVideoDeviceStateChanged 的回调获取屏幕采集状态，包括开始、暂停、恢复、错误等。
• 调用成功后，本端会收到 onFirstLocalVideoFrameCaptured 回调。
• 调用此接口前，你可以调用 setScreenVideoEncoderConfig 设置屏幕视频流的采集帧率和编码分辨率。
• 在收到 onFirstLocalVideoFrameCaptured 回调后通过调用 setLocalVideoCanvas 或 setLocalVideoSink 函数设置本地屏幕共享视图。
• 可以调用 setLocalVideoSink 将本地视频流与自定义渲染器绑定，通过回调 onFrame 获取采集成功的本地视频帧。
• 对于 Windows SDK，再开启采集屏幕视频流后，你可以调用 updateScreenCaptureHighlightConfig 更新边框高亮设置，调用 updateScreenCaptureMouseCursor 更新对鼠标的处理设置，调用 updateScreenCaptureFilterConfig 设置需要过滤的窗口。

virtual int bytertc::IRTCVideo::stopScreenVideoCapture()=0
cpp

停止屏幕视频流采集。

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用本接口时，采集模式应为内部模式。在外部采集模式下调用无效，并将触发 onVideoDeviceWarning 回调。
• 要开启屏幕视频流采集，调用 startScreenVideoCapture。
• 调用后，本地用户会收到 onVideoDeviceStateChanged 的回调。
• 调用此接口不影响屏幕视频流发布。

virtual int bytertc::IRTCVideo::updateScreenCaptureHighlightConfig(const HighlightConfig &highlight_config)=0
cpp

通过 RTC SDK 提供的采集模块采集屏幕视频流时，更新边框高亮设置。默认展示表框。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用此接口前，必须已通过调用 startScreenVideoCapture 开启了内部屏幕流采集。
• 对 Linux 系统，采用 X11 协议时可用；采用 Wayland 协议时不可用。

virtual int bytertc::IRTCVideo::updateScreenCaptureMouseCursor(MouseCursorCaptureState capture_mouse_cursor)=0
cpp

通过 RTC SDK 提供的采集模块采集屏幕视频流时，更新对鼠标的处理设置。默认采集鼠标。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

调用此接口前，必须已通过调用 startScreenVideoCapture 开启了内部屏幕流采集。

virtual IScreenCaptureSourceList * bytertc::IRTCVideo::getScreenCaptureSourceList()=0
cpp

获取共享对象列表。

返回值

共享对象列表，包括应用窗口和屏幕。详见 IScreenCaptureSourceList。用户选择后，可调用 startScreenVideoCapture 进行共享。

注意

• 对 Linux 系统，采用 X11 协议时可用；采用 Wayland 协议时不可用。采用 Wayland 协议，调用 startScreenVideoCapture 时，系统会通过弹窗供用户选择共享对象。
• 使用完之后需要调用 release 接口释放。

virtual IVideoFrame * bytertc::IRTCVideo::getThumbnail(
    ScreenCaptureSourceType type,
    view_t source_id,
    int max_width,
    int max_height
)=0
cpp

获取共享对象缩略图

传入参数

返回值

共享对象缩略图，详见 IVideoFrame。

注意

对 Linux 系统，采用 X11 协议时可用；采用 Wayland 协议时不可用。

virtual IVideoFrame * bytertc::IRTCVideo::getWindowAppIcon(
    view_t source_id,
    int max_width=100,
    int max_height=100
)=0
cpp

获取应用窗体所属应用的图标。

传入参数

返回值

详见 IVideoFrame。当屏幕共享对象为应用窗体，且有图标时有效，否则返回 nullptr。

注意

对 Linux 系统，采用 X11 协议时可用；采用 Wayland 协议时不可用。

virtual int bytertc::IRTCVideo::setVideoSourceType(
    StreamIndex stream_index,
    VideoSourceType type
)=0
cpp

设置向 SDK 输入的视频源，包括屏幕流

默认使用内部采集。内部采集指：使用 RTC SDK 内置的视频采集机制进行视频采集。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 该方法进房前后均可调用。
• 当你已调用 startVideoCapture 开启内部采集后，再调用此方法切换至自定义采集时，SDK 会自动关闭内部采集。
• 当你调用此方法开启自定义采集后，想要切换至内部采集，你必须先调用此方法关闭自定义采集，然后调用 startVideoCapture 手动开启内部采集。
• 当你需要向 SDK 推送自定义编码后的视频帧，你需调用该方法将视频源切换至自定义编码视频源。

virtual int bytertc::IRTCVideo::pushExternalVideoFrame(IVideoFrame* frame)=0
cpp

推送外部视频帧。

传入参数

返回值

方法调用结果：

• 0：成功；
• <0：失败。具体失败原因参看 ReturnStatus。

注意

• 支持格式：I420, NV12, RGBA, BGRA, ARGB
• 该函数运行在用户调用线程内
• 推送外部视频帧前，必须调用 setVideoSourceType 开启外部视频源采集。

virtual IRTCRoom * bytertc::IRTCVideo::createRTCRoom(const char* room_id)=0
cpp

创建房间实例。

调用此方法仅返回一个房间实例，你仍需调用 joinRoom 才能真正地创建/加入房间。

多次调用此方法以创建多个 IRTCRoom 实例。分别调用各 IRTCRoom 实例中的 joinRoom 方法，同时加入多个房间。

多房间模式下，用户可以同时订阅各房间的音视频流。

传入参数

返回值

创建的 IRTCRoom 房间实例。

注意

• 如果需要加入的房间已存在，你仍需先调用本方法来获取 IRTCRoom 实例，再调用 joinRoom 加入房间。
• 请勿使用同样的 roomId 创建多个房间，否则后创建的房间实例会替换先创建的房间实例。
• 如果你需要在多个房间发布音视频流，无须创建多房间，直接调用 startForwardStreamToRooms 开始跨房间转发媒体流。

virtual int bytertc::IRTCVideo::setPublishFallbackOption(PublishFallbackOption option)=0
cpp

设置发布的音视频流的回退选项。

你可以调用该接口设置网络不佳或设备性能不足时从大流起进行降级处理，以保证通话质量。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 该方法仅在调用 enableSimulcastMode 开启了发送多路视频流的情况下生效。
• 该方法必须在进房前设置，进房后设置或更改设置无效。
• 调用该方法后，如因性能或网络不佳产生发布性能回退或恢复，本端会提前收到 onPerformanceAlarms 回调发出的告警，以便采集设备配合调整。
• 设置回退后，本地发布的音视频流发生回退或从回退中恢复后，远端会收到 onSimulcastSubscribeFallback 回调，通知该情况。
• 你可以调用客户端 API 或者在服务端下发策略设置回退。当使用服务端下发配置实现时，下发配置优先级高于在客户端使用 API 设定的配置。

virtual int bytertc::IRTCVideo::setSubscribeFallbackOption(SubscribeFallbackOption option)=0
cpp

设置订阅的音视频流的回退选项。

你可调用该接口设置网络不佳或设备性能不足时允许订阅流进行降级或只订阅音频流，以保证通话流畅。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 你必须在进房前设置，进房后设置或更改设置无效。
• 设置回退选项后，订阅的音视频流发生回退或从回退中恢复时，会收到 onSimulcastSubscribeFallback 和 onRemoteVideoSizeChanged 回调通知。
• 你可以调用 API 或者在服务端下发策略设置回退。当使用服务端下发配置实现时，下发配置优先级高于在客户端使用 API 设定的配置。

virtual int bytertc::IRTCVideo::setRemoteUserPriority(
    const char* room_id,
    const char* user_id,
    RemoteUserPriority priority
)=0
cpp

设置用户优先级。

传入参数

返回值

0: 方法调用成功

• < 0: 方法调用失败

注意

• 1. 该方法与 setSubscribeFallbackOption 搭配使用。
• 2. 如果开启了订阅流回退选项，弱网或性能不足时会优先保证收到的高优先级用户的流的质量。
• 3. 该方法在进房前后都可以使用，可以修改远端用户的优先级。

virtual int bytertc::IRTCVideo::setBusinessId(const char* business_id)=0
cpp

设置业务标识参数

可通过 businessId 区分不同的业务场景。businessId 由客户自定义，相当于一个“标签”，可以分担和细化现在 AppId 的逻辑划分的功能，但不需要鉴权。

传入参数

返回值

• 0： 成功
• < 0： 失败，具体原因参照 BusinessCheckCode。
• -6001： 用户已经在房间中。
• -6002： 输入非法，合法字符包括所有小写字母、大写字母和数字，除此外还包括四个独立字符，分别是：英文句号，短横线，下划线和 @ 。

注意

• 需要在调用 joinRoom 之前调用，joinRoom 之后调用该方法无效。

virtual int bytertc::IRTCVideo::setRemoteVideoMirrorType(
    RemoteStreamKey stream_key,
    RemoteMirrorType mirror_type
)=0
cpp

Available since 3.57

使用内部渲染时，为远端流开启镜像。

传入参数

返回值

• 0: 调用成功。
• < 0: 调用失败，参看 ReturnStatus 获得更多错误说明。

virtual IVideoEffect * bytertc::IRTCVideo::getVideoEffectInterface()=0
cpp

获取视频特效接口。

返回值

视频特效接口，参看 IVideoEffect。

virtual int bytertc::IRTCVideo::setEncryptInfo(
    EncryptType encrypt_type,
    const char* key,
    int key_size
)=0
cpp

设置传输时使用内置加密的方式。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 使用传输时内置加密时，使用此方法；如果需要使用传输时自定义加密，参看 onEncryptData。 内置加密和自定义加密互斥，根据最后一个调用的方法确定传输是加密的方案。
• 该方法必须在进房之前调用，可重复调用，以最后调用的参数作为生效参数。

virtual int bytertc::IRTCVideo::setCustomizeEncryptHandler(IEncryptHandler* handler)=0
cpp

设置自定义加密和解密方式。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 该方法与 setEncryptInfo 为互斥关系，只能选择自定义加密方式或者默认加密方式。最终生效的加密方式取决于最后一个调用的方法。
• 该方法必须在进房之前调用，可重复调用，以最后调用的参数作为生效参数。
• 无论加密或者解密，其对原始数据的长度修改，需要控制在 180% 之间，即如果输入数据为 100 字节，则处理完成后的数据必须不超过 180 字节，如果加密或解密结果超出该长度限制，则该音视频帧可能会被丢弃。
• 数据加密/解密为串行执行，因而视实现方式不同，可能会影响到最终渲染效率。是否使用该方法，需要由使用方谨慎评估。

virtual int bytertc::IRTCVideo::enableAudioFrameCallback(
    AudioFrameCallbackMethod method,
    AudioFormat format
)=0
cpp

设置并开启指定的音频数据帧回调

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

开启音频回调并调用 registerAudioFrameObserver 后， IAudioFrameObserver 会收到对应的音频回调。两者调用顺序没有限制且相互独立。

virtual int bytertc::IRTCVideo::disableAudioFrameCallback(AudioFrameCallbackMethod method)=0
cpp

关闭音频回调

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

该方法需要在调用 enableAudioFrameCallback 之后调用。

virtual int bytertc::IRTCVideo::registerAudioFrameObserver(IAudioFrameObserver* observer)=0
cpp

注册音频数据回调观察者。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

注册音频数据回调观察者并调用 enableAudioFrameCallback 后， IAudioFrameObserver 会收到对应的音频回调。对回调中收到的音频数据进行处理，不会影响 RTC 的编码发送或渲染。

virtual int bytertc::IRTCVideo::registerAudioProcessor(IAudioFrameProcessor* processor)=0
cpp

注册自定义音频处理器。

注册完成后，你可以调用 enableAudioProcessor，对本地采集到的音频进行处理，RTC SDK 将对处理后的音频进行编码和发送。也可以对接收到的远端音频进行自定义处理，RTC SDK 将对处理后的音频进行渲染。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 重复调用此接口时，仅最后一次调用生效。
• 更多相关信息，详见音频自定义处理。

virtual int bytertc::IRTCVideo::enableAudioProcessor(
    AudioProcessorMethod method,
    AudioFormat format
)=0
cpp

设置并开启指定的音频帧回调，进行自定义处理。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 在调用此接口前，你需要调用 registerAudioProcessor 注册自定义音频处理器。
• 要关闭音频自定义处理，调用 disableAudioProcessor。

virtual int bytertc::IRTCVideo::disableAudioProcessor(AudioProcessorMethod method)=0
cpp

关闭自定义音频处理。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

virtual int bytertc::IRTCVideo::registerLocalVideoProcessor(
    IVideoProcessor* processor,
    VideoPreprocessorConfig config
)=0
cpp

设置自定义视频前处理器。

使用这个视频前处理器，你可以调用 processVideoFrame 对 RTC SDK 采集得到的视频帧进行前处理，并将处理后的视频帧用于 RTC 音视频通信。

传入参数

返回值

• 0：方法调用成功
• !0：方法调用失败

注意

• 对于 Windows 平台，经前处理返回的视频帧格式仅支持 kVideoPixelFormatI420
• 对于 Windows 平台，将 config 中的 required_pixel_format 设置为 kVideoPixelFormatI420，可以通过避免格式转换带来一些性能优化。
• 重复调用此接口时，仅最后一次调用生效。效果不会叠加。

virtual int bytertc::IRTCVideo::setVideoDigitalZoomConfig(
    ZoomConfigType type,
    float size
)=0
cpp

Available since 3.51

设置本地摄像头数码变焦参数，包括缩放倍数，移动步长。

传入参数

返回值

• 0：成功。
• !0：失败。

注意

• 每次调用本接口只能设置一种参数。如果缩放系数和移动步长都需要设置，分别调用本接口传入相应参数。
• 由于移动步长的默认值为 0 ，在调用 setVideoDigitalZoomControl 或 startVideoDigitalZoomControl 进行数码变焦操作前，应先调用本接口。

virtual int bytertc::IRTCVideo::setVideoDigitalZoomControl(ZoomDirectionType direction)=0
cpp

Available since 3.51

控制本地摄像头数码变焦，缩放或移动一次。设置对本地预览画面和发布到远端的视频都生效。

传入参数

返回值

• 0：成功。
• !0：失败。

注意

• 由于默认步长为 0，调用该方法前需通过 setVideoDigitalZoomConfig 设置参数。
• 调用该方法进行移动前，应先使用本方法或 startVideoDigitalZoomControl 进行放大，否则无法移动。
• 当数码变焦操作超出范围时，将置为临界值。例如，移动到了图片边界、放大到了 8 倍、缩小到原图大小。
• 如果你希望实现持续数码变焦操作，调用 startVideoDigitalZoomControl。
• 移动端可对摄像头进行光学变焦控制，参看 setCameraZoomRatio。

virtual int bytertc::IRTCVideo::startVideoDigitalZoomControl(ZoomDirectionType direction)=0
cpp

Available since 3.51

开启本地摄像头持续数码变焦，缩放或移动。设置对本地预览画面和发布到远端的视频都生效。

传入参数

返回值

• 0：成功。
• !0：失败。

注意

• 由于默认步长为 0，调用该方法前需通过 setVideoDigitalZoomConfig 设置参数。
• 调用该方法进行移动前，应先使用本方法或 setVideoDigitalZoomControl 进行放大，否则无法移动。
• 当数码变焦操作超出范围时，将置为临界值并停止操作。例如，移动到了图片边界、放大到了 8 倍、缩小到原图大小。
• 你也可以调用 stopVideoDigitalZoomControl 手动停止控制。
• 如果你希望实现单次数码变焦操作，调用 setVideoDigitalZoomControl。
• 移动端可对摄像头进行光学变焦控制，参看 setCameraZoomRatio。

virtual int bytertc::IRTCVideo::stopVideoDigitalZoomControl()=0
cpp

Available since 3.51

停止本地摄像头持续数码变焦。

返回值

• 0：成功。
• !0：失败。

注意

关于开始数码变焦，参看 startVideoDigitalZoomControl。

virtual int bytertc::IRTCVideo::sendSEIMessage(
    StreamIndex stream_index,
    const uint8_t* message,
    int length,
    int repeat_count,
    SEICountPerFrame mode
)=0
cpp

通过视频帧发送 SEI 数据。

在视频通话场景下，SEI 数据会随视频帧发送；在语音通话场景下，SDK 会自动生成一路 16px × 16px 的黑帧视频流用来发送 SEI 数据。

传入参数

返回值

• >= 0: 将被添加到视频帧中的 SEI 的数量。
• < 0: 发送失败。

注意

• 每秒发送的 SEI 消息数量建议不超过当前的视频帧率。在语音通话场景下，黑帧帧率为 15 fps。
• 语音通话场景中，仅支持在内部采集模式下调用该接口发送 SEI 数据。
• 视频通话场景中，使用自定义采集并通过 pushExternalVideoFrame 推送至 SDK 的视频帧，若本身未携带 SEI 数据，也可通过本接口发送 SEI 数据；若原视频帧中已添加了 SEI 数据，则调用此方法不生效。
• 视频帧仅携带前后 2s 内收到的 SEI 数据；语音通话场景下，若调用此接口后 1min 内未有 SEI 数据发送，则 SDK 会自动取消发布视频黑帧。
• 消息发送成功后，远端会收到 onSEIMessageReceived 回调。
• 语音通话切换至视频通话时，会停止使用黑帧发送 SEI 数据，自动转为用采集到的正常视频帧发送 SEI 数据。

virtual IVideoDeviceManager * bytertc::IRTCVideo::getVideoDeviceManager()=0
cpp

创建视频设备管理实例

返回值

视频设备管理实例，详见 IVideoDeviceManager

virtual IAudioDeviceManager * bytertc::IRTCVideo::getAudioDeviceManager()=0
cpp

设备音频管理接口创建

返回值

音频设备管理接口

virtual int bytertc::IRTCVideo::startFileRecording(
    StreamIndex type,
    RecordingConfig config,
    RecordingType recording_type
)=0
cpp

录制通话过程中的音视频数据到本地的文件中。

传入参数

返回值

• 0: 正常
• -1: 参数设置异常
• -2: 当前版本 SDK 不支持该特性，请联系技术支持人员

注意

• 调用该方法后，你会收到 onRecordingStateUpdate 回调。
• 如果录制正常，系统每秒钟会通过 onRecordingProgressUpdate 回调通知录制进度。

virtual int bytertc::IRTCVideo::stopFileRecording(StreamIndex type)=0
cpp

停止本地录制

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用 startFileRecording 开启本地录制后，你必须调用该方法停止录制。
• 调用该方法后，你会收到 onRecordingStateUpdate 回调提示录制结果。

virtual int bytertc::IRTCVideo::startAudioRecording(AudioRecordingConfig &config)=0
cpp

开启录制语音通话，生成本地文件。

在进房前后开启录制，如果未打开麦克风采集，录制任务正常进行，只是不会将数据写入生成的本地文件；只有调用 startAudioCapture 接口打开麦克风采集后，才会将录制数据写入本地文件。

传入参数

返回值

• 0: 正常
• -2: 参数设置异常
• -3: 当前版本 SDK 不支持该特性，请联系技术支持人员

注意

• 录制包含各种音频效果。但不包含背景音乐。
• 调用 stopAudioRecording 关闭录制。
• 加入房间前后均可调用。在进房前调用该方法，退房之后，录制任务不会自动停止，需调用 stopAudioRecording 关闭录制。在进房后调用该方法，退房之后，录制任务会自动被停止。如果加入了多个房间，录制的文件中会包含各个房间的音频。
• 调用该方法后，你会收到 onAudioRecordingStateUpdate 回调。

virtual int bytertc::IRTCVideo::stopAudioRecording()=0
cpp

停止音频文件录制

返回值

• 0: 正常
• -3: 当前版本 SDK 不支持该特性，请联系技术支持人员

注意

调用 startAudioRecording 开启本地录制。

virtual int bytertc::IRTCVideo::enableExternalSoundCard(bool enable)=0
cpp

启用匹配外置声卡的音频处理模式

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 当采用外接声卡进行音频采集时，建议开启此模式，以获得更好的音质。
• 开启此模式时，仅支持耳机播放。如果需要使用扬声器或者外置音箱播放，关闭此模式。

virtual int bytertc::IRTCVideo::setRuntimeParameters(const char* json_string)=0
cpp

设置运行时的参数

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

该接口需在 joinRoom 和 startAudioCapture 之前调用。

virtual int bytertc::IRTCVideo::feedback(
    uint64_t type,
    const ProblemFeedbackInfo* info
)=0
cpp

将用户反馈的问题上报到 RTC。

传入参数

返回值

• 0: 上报成功
• -1: 上报失败，还没加入过房间
• -2: 上报失败，数据解析错误
• -3: 上报失败，字段缺失

注意

• 你可以在 RTC 控制台上查看用户通过此接口提交的反馈详情和整体趋势。
• 如果用户上报时在房间内，那么问题会定位到用户当前所在的一个或多个房间；如果用户上报时不在房间内，那么问题会定位到引擎此前退出的房间。

virtual IAudioEffectPlayer * bytertc::IRTCVideo::getAudioEffectPlayer()=0
cpp

Available since 3.53

创建音效播放器实例。

返回值

音效播放器。详见 IAudioEffectPlayer。

virtual IMediaPlayer * bytertc::IRTCVideo::getMediaPlayer(int player_id)=0
cpp

Available since 3.53

创建音乐播放器实例。

传入参数

返回值

音乐播放器实例，详见 IMediaPlayer

virtual int bytertc::IRTCVideo::login(
    const char* token,
    const char* uid
)=0
cpp

登陆 RTS 服务器。

必须先登录，才能调用 sendUserMessageOutsideRoom 和 sendServerMessage 发送房间外点对点消息和向应用服务器发送消息

在调用本接口登录后，如果想要登出，需要调用 logout。

传入参数

返回值

• 0：成功；
• <0：失败。具体失败原因参看 ReturnStatus。

注意

本地用户调用此方法登录后，会收到 onLoginResult 回调通知登录结果，远端用户不会收到通知。

virtual int bytertc::IRTCVideo::logout()=0
cpp

登出 RTS 服务器。

调用本接口登出后，无法调用房间外消息以及端到服务器消息相关的方法或收到相关回调。

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用本接口登出前，必须先调用 login 登录。
• 本地用户调用此方法登出后，会收到 onLogout 回调通知结果，远端用户不会收到通知。

virtual int bytertc::IRTCVideo::updateLoginToken(const char* token)=0
cpp

更新用户用于登录的 Token

Token 有一定的有效期，当 Token 过期时，需调用此方法更新登录的 Token 信息。

调用 login 方法登录时，如果使用了过期的 Token 将导致登录失败，并会收到 onLoginResult 回调通知，错误码为 kLoginErrorCodeInvalidToken。此时需要重新获取 Token，并调用此方法更新 Token。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 如果 Token 无效导致登录失败，则调用此方法更新 Token 后，SDK 会自动重新登录，而用户不需要自己调用 login 方法。
• Token 过期时，如果已经成功登录，则不会受到影响。Token 过期的错误会在下一次使用过期 Token 登录时，或因本地网络状况不佳导致断网重新登录时通知给用户。

virtual int bytertc::IRTCVideo::setServerParams(
    const char* signature,
    const char* url
)=0
cpp

设置应用服务器参数

客户端调用 sendServerMessage 或 sendServerBinaryMessage 发送消息给应用服务器之前，必须设置有效签名和应用服务器地址。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 用户必须调用 login 登录后，才能调用本接口。
• 调用本接口后，SDK 会使用 onServerParamsSetResult 返回相应结果。

virtual int bytertc::IRTCVideo::getPeerOnlineStatus(const char* peer_user_id)=0
cpp

查询对端用户或本端用户的登录状态

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 必须调用 login 登录后，才能调用本接口。
• 调用本接口后，SDK 会使用 onGetPeerOnlineStatus 回调通知查询结果。
• 在发送房间外消息之前，用户可以通过本接口了解对端用户是否登录，从而决定是否发送消息。也可以通过本接口查询自己查看自己的登录状态。

virtual int64_t bytertc::IRTCVideo::sendUserMessageOutsideRoom(
    const char* uid,
    const char* message,
    MessageConfig config=kMessageConfigReliableOrdered
)=0
cpp

给房间外指定的用户发送文本消息（P2P）

传入参数

返回值

• >0：发送成功，返回这次发送消息的编号，从 1 开始递增
• -1：发送失败，IRTCVideo 实例未创建
• -2：发送失败，uid 为空

注意

• 在发送房间外文本消息前，必须先调用 login 完成登录。
• 用户调用本接口发送文本信息后，会收到一次 onUserMessageSendResultOutsideRoom 回调，得知消息是否成功发送。
• 若文本消息发送成功，则 uid 所指定的用户会通过 onUserMessageReceivedOutsideRoom 回调收到该消息。

virtual int64_t bytertc::IRTCVideo::sendUserBinaryMessageOutsideRoom(
    const char* uid,
    int length,
    const uint8_t* message,
    MessageConfig config=kMessageConfigReliableOrdered
)=0
cpp

给房间外指定的用户发送二进制消息（P2P）

传入参数

返回值

• >0：发送成功，返回这次发送消息的编号，从 1 开始递增
• -1：发送失败，IRTCVideo 实例未创建
• -2：发送失败，uid 为空

注意

• 在发送房间外二进制消息前，必须先调用 login 完成登录。
• 用户调用本接口发送二进制消息后，会收到一次 onUserMessageSendResultOutsideRoom 回调，通知消息是否发送成功。
• 若二进制消息发送成功，则 uid 所指定的用户会通过 onUserBinaryMessageReceivedOutsideRoom 回调收到该条消息。

virtual int64_t bytertc::IRTCVideo::sendServerMessage(const char* message)=0
cpp

客户端给应用服务器发送文本消息（P2Server）

传入参数

返回值

• >0：发送成功，返回这次发送消息的编号，从 1 开始递增
• -1：发送失败，IRTCVideo 实例未创建

注意

• 在向应用服务器发送文本消息前，必须先调用 login 完成登录，随后调用 setServerParams 设置应用服务器。
• 调用本接口后，会收到一次 onServerMessageSendResult 回调，通知消息发送方是否发送成功。
• 若文本消息发送成功，则之前调用 setServerParams 设置的应用服务器会收到该条消息。

virtual int64_t bytertc::IRTCVideo::sendServerBinaryMessage(
    int length,
    const uint8_t* message
)=0
cpp

客户端给应用服务器发送二进制消息（P2Server）

传入参数

返回值

• >0：发送成功，返回这次发送消息的编号，从 1 开始递增
• -1：发送失败，IRTCVideo 实例未创建

注意

• 在向应用服务器发送二进制消息前，必须先调用 login 完成登录，随后调用 setServerParams 设置应用服务器。
• 调用本接口后，会收到一次 onServerMessageSendResult 回调，通知消息发送方发送成功或失败。
• 若二进制消息发送成功，则之前调用 setServerParams 设置的应用服务器会收到该条消息。

virtual int bytertc::IRTCVideo::startNetworkDetection(
    bool is_test_uplink,
    int expected_uplink_bitrate,
    bool is_test_downlink,
    int expected_downlink_biterate
)=0
cpp

开启通话前网络探测

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 成功调用本接口后，会在 3s 内收到一次 onNetworkDetectionResult 回调，此后每 2s 会收到一次该回调，通知探测结果；
• 若探测停止，则会收到一次 onNetworkDetectionStopped 通知探测停止。

virtual int bytertc::IRTCVideo::stopNetworkDetection()=0
cpp

停止通话前网络探测

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用本接口后，会收到一次 onNetworkDetectionStopped 回调通知探测停止。

virtual int bytertc::IRTCVideo::startScreenAudioCapture()=0
cpp

在屏幕共享时，开始使用 RTC SDK 内部采集方式，采集屏幕音频

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 本接口仅对内部采集生效，RTC SDK 默认使用内部采集模块采集屏幕音频。对于 Windows SDK，若已调用 setScreenAudioSourceType 将音频输入源设置为 kAudioSourceTypeExternal 自定义采集，需先切换为 kAudioSourceTypeInternal 内部采集，否则该接口调用无效，并将触发 onAudioDeviceWarning 回调。
• 采集后，你还需要调用 publishScreen 将采集到的屏幕音频推送到远端。
• 要关闭屏幕音频内部采集，调用 stopScreenAudioCapture。

virtual int bytertc::IRTCVideo::stopScreenAudioCapture()=0
cpp

在屏幕共享时，停止使用 RTC SDK 内部采集方式，采集屏幕音频。

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用本接口时，采集模式应为内部模式。在外部采集模式下调用无效，并将触发 onAudioDeviceWarning 回调。
• 本接口仅对内部采集生效。如果为外部采集模式，调用本接口失败。你需要在外部采集器中实现停止采集的逻辑。
• 要开始屏幕音频内部采集，调用 startScreenAudioCapture。

virtual int bytertc::IRTCVideo::setAudioAlignmentProperty(
    const RemoteStreamKey &stream_key,
    AudioAlignmentMode mode
)=0
cpp

在听众端，设置订阅的所有远端音频流精准对齐后播放。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 你必须在实时合唱场景下使用此功能。在加入房间时，所有人应设置 RoomProfileType 为 kRoomProfileTypeChorus。
• 订阅的所有远端流必须通过 startAudioMixing 开启了背景音乐混音，并将 AudioMixingConfig 中的 sync_progress_to_record_frame 设置为 true。
• 如果订阅的某个音频流延迟过大，可能无法实现精准对齐。
• 合唱的参与者不应调用此 API，因为调用此 API 会增加延迟。如果希望从听众变为合唱参与者，应关闭对齐功能。

virtual int bytertc::IRTCVideo::startPushPublicStream(
    const char* public_stream_id,
    IPublicStreamParam* param
)=0
cpp

发布一路公共流

用户可以指定房间内多个用户发布的媒体流合成一路公共流。使用同一 appID 的用户，可以调用 startPlayPublicStream 获取和播放指定的公共流。

传入参数

返回值

• 0: 成功。同时将收到 onPushPublicStreamResult 回调。
• !0: 失败。当参数不合法或参数为空，调用失败。

注意

• 同一用户使用同一公共流 ID 多次调用本接口无效。如果你希望更新公共流参数，调用 updatePublicStreamParam 接口。
• 不同用户使用同一公共流 ID 多次调用本接口时，RTC 将使用最后一次调用时传入的参数更新公共流。
• 使用不同的 ID 多次调用本接口可以发布多路公共流。
• 调用 stopPushPublicStream 停止发布公共流。
• 关于公共流功能的介绍，详见发布和订阅公共流

virtual int bytertc::IRTCVideo::stopPushPublicStream(const char* public_stream_id)=0
cpp

停止发布当前用户发布的公共流

关于发布公共流，查看 startPushPublicStream。

传入参数

返回值

• 0: 成功
• !0: 失败

virtual int bytertc::IRTCVideo::updatePublicStreamParam(
    const char* public_stream_id,
    IPublicStreamParam* param
)=0
cpp

更新公共流参数

关于发布公共流，查看 startPushPublicStream。

传入参数

返回值

• 0: 成功
• !0: 失败

注意

调用本接口前需要通过 onPushPublicStreamResult 确认公共流是否已经成功启动。

virtual int bytertc::IRTCVideo::enableAudioPropertiesReport(const AudioPropertiesConfig &config)=0
cpp

启用音频信息提示。开启提示后，你会收到 onLocalAudioPropertiesReport， onRemoteAudioPropertiesReport 和 onActiveSpeaker。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

virtual int bytertc::IRTCVideo::setRemoteAudioPlaybackVolume(
    const char* room_id,
    const char* user_id,
    int volume
)=0
cpp

调节来自指定远端用户的音频播放音量。

传入参数

返回值

方法调用结果：

• 0：成功；
• <0：失败。具体失败原因参看 ReturnStatus。

注意

假设某远端用户 A 始终在被调节的目标用户范围内，

• 该方法与 setRemoteRoomAudioPlaybackVolume 互斥，最新调用的任一方法设置的音量将覆盖此前已设置的音量，效果不叠加；
• 当该方法与 setPlaybackVolume 方法共同使用时，本地收听用户 A 的音量将为两次设置的音量效果的叠加。

virtual int bytertc::IRTCVideo::enableVocalInstrumentBalance(bool enable)=0
cpp

开启/关闭音量均衡功能。

开启音量均衡功能后，人声的响度会调整为 -16lufs。如果已调用 setAudioMixingLoudness 传入了混音音乐的原始响度，此音乐播放时，响度会调整为 -20lufs。（Linux 不支持）

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

该接口须在调用 startAudioMixing 开始播放音频文件之前调用。

virtual int bytertc::IRTCVideo::enablePlaybackDucking(bool enable)=0
cpp

打开/关闭音量闪避功能，适用于在 RTC 通话过程中会同时播放短视频或音乐的场景，如“一起看”、“在线 KTV”等。

开启该功能后，当检测到远端人声时，本地的媒体播放音量会自动减弱，从而保证远端人声的清晰可辨；当远端人声消失时，本地媒体音量会恢复到闪避前的音量水平。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

virtual int bytertc::IRTCVideo::registerLocalEncodedVideoFrameObserver(ILocalEncodedVideoFrameObserver* observer)=0
cpp

注册本地视频帧监测器。

无论使用内部采集还是自定义采集，调用该方法后，SDK 每监测到一帧本地视频帧时，都会将视频帧信息通过 onLocalEncodedVideoFrame 回调给用户

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

该方法可在进房前后的任意时间调用，在进房前调用可保证尽可能早地监测视频帧并触发回调

virtual int bytertc::IRTCVideo::registerRemoteEncodedVideoFrameObserver(IRemoteEncodedVideoFrameObserver* observer)=0
cpp

注册远端编码后视频数据回调。

完成注册后，当 SDK 监测到远端编码后视频帧时，会触发 onRemoteEncodedVideoFrame 回调

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 更多自定义解码功能说明参看 自定义视频编解码。
• 该方法适用于手动订阅，并且进房前后均可调用，建议在进房前调用。
• 引擎销毁前需取消注册，调用该方法将参数设置为 nullptr 即可。

virtual int bytertc::IRTCVideo::setExternalVideoEncoderEventHandler(IExternalVideoEncoderEventHandler* encoder_handler)=0
cpp

注册自定义编码帧推送事件回调

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 该方法需在进房前调用。
• 引擎销毁前需取消注册，调用该方法将参数设置为 nullptr 即可。

virtual int bytertc::IRTCVideo::pushExternalEncodedVideoFrame(
    StreamIndex index,
    int video_index,
    IEncodedVideoFrame* video_stream
)=0
cpp

推送自定义编码后的视频流

传入参数

返回值

方法调用结果：

• 0：成功；
• <0：失败。具体失败原因参看 ReturnStatus。

注意

• 目前仅支持推送 H264 和 ByteVC1 格式的视频帧，且视频流协议格式须为 Annex B 格式。
• 该函数运行在用户调用线程内
• 推送自定义编码视频帧前，必须调用 setVideoSourceType 将视频输入源切换至自定义编码视频源。

virtual int bytertc::IRTCVideo::setVideoDecoderConfig(
    RemoteStreamKey key,
    VideoDecoderConfig config
)=0
cpp

在订阅远端视频流之前，设置远端视频数据解码方式

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 当你想要对远端流进行自定义解码时，你需要先调用 registerRemoteEncodedVideoFrameObserver 注册远端视频流监测器，然后再调用该接口将解码方式设置为自定义解码。监测到的视频数据会通过 onRemoteEncodedVideoFrame 回调出来。
• 自 3.56 起，要用于自动订阅场景下，你可以设置 key 中的 RoomId 和 UserId 为 nullptr，此时，通过此接口设置的解码方式根据 key 中的 StreamIndex 值，适用于所有的远端主流或屏幕流的解码方式。

virtual int bytertc::IRTCVideo::requestRemoteVideoKeyFrame(const RemoteStreamKey &stream_info)=0
cpp

在订阅远端视频流之后，向远端请求关键帧

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 该方法仅适用于手动订阅模式，并且在成功订阅远端流之后使用。
• 该方法适用于调用 setVideoDecoderConfig 开启自定义解码功能后，并且自定义解码失败的情况下使用

virtual int bytertc::IRTCVideo::sendStreamSyncInfo(
    const uint8_t* data,
    int32_t length,
    const StreamSycnInfoConfig &config
)=0
cpp

发送音频流同步信息。将消息通过音频流发送到远端，并实现与音频流同步，该接口调用成功后，远端用户会收到 onStreamSyncInfoReceived 回调。

传入参数

返回值

• >=0: 消息发送成功。返回成功发送的次数。
• -1: 消息发送失败。消息长度大于 255 字节。
• -2: 消息发送失败。传入的消息内容为空。
• -3: 消息发送失败。通过屏幕流进行消息同步时，此屏幕流还未发布。
• -4: 消息发送失败。通过用麦克风或自定义设备采集到的音频流进行消息同步时，此音频流还未发布，详见错误码 ErrorCode。

注意

• 调用本接口的频率建议不超过 50 次每秒。
• 在 kRoomProfileTypeInteractivePodcast 房间模式下，此消息一定会送达。在其他房间模式下，如果本地用户未说话，此消息不一定会送达。

virtual int bytertc::IRTCVideo::setLocalVoicePitch(int pitch)=0
cpp

开启本地语音变调功能，多用于 K 歌场景。

使用该方法，你可以对本地语音的音调进行升调或降调等调整。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

virtual int bytertc::IRTCVideo::startPlayPublicStream(const char* public_stream_id)=0
cpp

订阅指定公共流

无论用户是否在房间内，都可以调用本接口获取和播放指定的公共流。

传入参数

返回值

• 0: 成功。同时将收到 onPlayPublicStreamResult 回调。
• !0: 失败。当参数不合法或参数为空，调用失败。

注意

• 一个客户端最多同时播放 5 路公共流，请及时调用 stopPlayPublicStream 取消订阅公共流，避免订阅的公共流数量超限。
• 在调用本接口之前，建议先绑定渲染视图。
  • 调用 setPublicStreamVideoCanvas 绑定内部渲染视图：
  • 调用 setPublicStreamVideoSink 绑定自定义渲染视图：
• 调用本接口后，可以通过 onFirstPublicStreamVideoFrameDecoded 和 onFirstPublicStreamAudioFrame 回调公共流的视频和音频首帧解码情况。
• 调用本接口后，可以通过 onPublicStreamSEIMessageReceived 回调公共流中包含的 SEI 信息。
• 订阅公共流之后，可以通过调用 stopPlayPublicStream 接口取消订阅公共流。

virtual int bytertc::IRTCVideo::stopPlayPublicStream(const char* public_stream_id)=0
cpp

取消订阅指定公共流

关于订阅公共流，查看 startPlayPublicStream。

传入参数

返回值

• 0：成功
• !0：失败

virtual int bytertc::IRTCVideo::setPublicStreamVideoCanvas(
    const char* public_stream_id,
    const VideoCanvas &canvas
)=0
cpp

为指定公共流绑定内部渲染视图。

传入参数

返回值

• 0：成功
• !0：失败

virtual int bytertc::IRTCVideo::setPublicStreamVideoSink(
    const char* public_stream_id,
    IVideoSink* video_sink,
    IVideoSink::PixelFormat format
)=0
cpp

为指定公共流绑定自定义渲染器。详见自定义视频渲染。

传入参数

返回值

方法调用结果：

• 0：成功；
• <0：失败。具体失败原因参看 ReturnStatus。

virtual int bytertc::IRTCVideo::setPublicStreamAudioPlaybackVolume(
    const char* public_stream_id,
    int volume
)=0
cpp

Available since 3.51

调节公共流的音频播放音量。

传入参数

返回值

• 0: 成功调用。
• -2: 参数错误。

virtual int bytertc::IRTCVideo::setVideoWatermark(
    StreamIndex stream_index,
    const char* image_path,
    RTCWatermarkConfig config
)=0
cpp

在指定视频流上添加水印。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 调用 clearVideoWatermark 移除指定视频流的水印。
• 同一路流只能设置一个水印，新设置的水印会代替上一次的设置。你可以多次调用本方法来设置不同流的水印。
• 若开启本地预览镜像，或开启本地预览和编码传输镜像，则远端水印均不镜像；在开启本地预览水印时，本端水印会镜像。
• 开启大小流后，水印对大小流均生效，且针对小流进行等比例缩小。

virtual int bytertc::IRTCVideo::clearVideoWatermark(StreamIndex stream_index)=0
cpp

移除指定视频流的水印。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

virtual int bytertc::IRTCVideo::setDummyCaptureImagePath(const char* file_path)=0
cpp

摄像头处于关闭状态时，使用静态图片填充本地推送的视频流。

调用 stopVideoCapture 接口时，会开始推静态图片。若要停止发送图片，可传入空字符串或启用内部摄像头采集。

可重复调用该接口来更新图片。

传入参数

返回值

• 0: 成功。
• -1: 失败。

注意

• 该接口只适用于 SDK 内部摄像头采集，不适用于自定义视频采集。
• 本地预览无法看到静态图片。
• 进入房间前后均可调用此方法。在多房间场景中，静态图片仅在发布的房间中生效。
• 针对该静态图片，滤镜和镜像效果不生效，水印效果生效。
• 只有主流能设置静态图片，屏幕流不支持设置。
• 开启大小流后，静态图片对大小流均生效，且针对小流进行等比例缩小。

virtual int bytertc::IRTCVideo::startCloudProxy(const CloudProxyConfiguration &configuration)=0
cpp

开启云代理

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• 在加入房间前调用此接口
• 在开启云代理后，进行通话前网络探测
• 开启云代理后，并成功链接云代理服务器后，会收到 onCloudProxyConnected。
• 要关闭云代理，调用 stopCloudProxy。

virtual int bytertc::IRTCVideo::stopCloudProxy()=0
cpp

关闭云代理

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

要开启云代理，调用 startCloudProxy。

virtual int bytertc::IRTCVideo::setLocalProxy(
    const LocalProxyConfiguration* configurations,
    int configuration_num
)=0
cpp

设置本地代理。

传入参数

注意

• 该方法需要在进房前调用。
• 调用该方法设置本地代理后，SDK 会触发 onLocalProxyStateChanged，返回代理连接的状态。

virtual int bytertc::IRTCVideo::setLowLightAdjusted(VideoEnhancementMode mode)=0
cpp

Available since 3.57

设置视频暗光增强模式。

对于光线不足、照明不均匀或背光等场景下推荐开启，可有效改善画面质量。

传入参数

返回值

• 0: API 调用成功。会立即生效，但需要等待下载和检测完成后才能看到增强后的效果。
• < 0: API 调用失败。查看 ReturnStatus 获得更多错误说明。

注意

• 开启后会影响设备性能，应根据实际需求和设备性能决定是否开启。
• 对 RTC SDK 内部采集的视频和自定义采集的视频都生效。

virtual int bytertc::IRTCVideo::setVideoEncoderConfig(
    StreamIndex index,
    const VideoSolution* solutions,
    int solution_num
)=0
cpp

Deprecated since 3.36 and will be deleted in 3.51, use setVideoEncoderConfig instead.

设置推送多路流时的各路视频参数，包括分辨率、帧率、码率、缩放模式、网络不佳时的回退策略等。

传入参数

返回值

• 0：成功
• !0：失败

注意

• 该接口已废弃，请使用同名新接口代替；若仍需使用该旧接口，请注意无需先调用 enableSimulcastMode 开启推送多路流模式。
• 当使用内部采集时，视频采集的分辨率、帧率会根据最大的编码分辨率、帧率进行适配
• 默认的视频编码参数为：分辨率 640px × 360px，帧率 15fps。
• 变更编码分辨率后马上生效，可能会引发相机重启。
• 屏幕流只取视频参数数组的第一组数据。

virtual int bytertc::IRTCVideo::updateRemoteStreamVideoCanvas(
    RemoteStreamKey stream_key,
    const enum RenderMode render_mode,
    const uint32_t background_color
)=0
cpp

Deprecated since 3.56 on iOS and Android, and will be deleted in 3.62.

修改远端视频帧的渲染设置，包括渲染模式和背景颜色。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

你可以在远端视频渲染过程中，调用此接口。调用结果会实时生效。

virtual int bytertc::IRTCVideo::setLocalVideoSink(
    StreamIndex index,
    IVideoSink* video_sink,
    IVideoSink::PixelFormat required_format
)=0
cpp

Deprecated since 3.57, use setLocalVideoRender instead.

将本地视频流与自定义渲染器绑定。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• RTC SDK 默认使用 RTC SDK 自带的渲染器（内部渲染器）进行视频渲染。
• 如果需要解除绑定，必须将 video_sink 设置为 null。退房时将清除绑定状态。
• 一般在收到 onFirstLocalVideoFrameCaptured 回调通知完成本地视频首帧采集后，调用此方法为视频流绑定自定义渲染器；然后加入房间。
• 本方法获取的是前处理后的视频帧，如需获取其他位置的视频帧（如采集后的视频帧），请调用 setLocalVideoRender。

virtual int bytertc::IRTCVideo::setRemoteVideoSink(
    RemoteStreamKey stream_key,
    IVideoSink* video_sink,
    IVideoSink::PixelFormat required_format
)=0
cpp

Deprecated since 3.57, use setRemoteVideoRender instead.

将远端视频流与自定义渲染器绑定。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

• RTC SDK 默认使用 RTC SDK 自带的渲染器（内部渲染器）进行视频渲染。
• 该方法进房前后均可以调用。若想在进房前调用，你需要在加入房间前获取远端流信息；若无法预先获取远端流信息，你可以在加入房间并通过 onUserPublishStream 回调获取到远端流信息之后，再调用该方法。
• 如果需要解除绑定，必须将 video_sink 设置为 null。退房时将清除绑定状态。
• 本方法获取的是后处理后的视频帧，如需获取其他位置的视频帧（如解码后的视频帧），请调用 setRemoteVideoRender。

virtual int bytertc::IRTCVideo::sendSEIMessage(
    StreamIndex stream_index,
    const uint8_t* message,
    int length,
    int repeat_count
)=0
cpp

Deprecated since 3.50 and will be deleted in 3.55, use sendSEIMessage instead.

通过视频帧发送 SEI 数据。

在视频通话场景下，SEI 数据会随视频帧发送；在语音通话场景下，SDK 会自动生成一路 16px × 16px 的黑帧视频流用来发送 SEI 数据。

传入参数

返回值

• >=0: 将被添加到视频帧中的 SEI 的数量
• <0: 发送失败

注意

• 语音通话场景中，仅支持在内部采集模式下调用该接口发送 SEI 数据，且调用频率需为 15/repeat_count FPS。
• 视频帧仅携带前后 2s 内收到的 SEI 数据；语音通话场景下，若调用此接口后 1min 内未有 SEI 数据发送，则 SDK 会自动取消发布视频黑帧。
• 消息发送成功后，远端会收到 onSEIMessageReceived 回调。
• 语音通话切换至视频通话时，会停止使用黑帧发送 SEI 数据，自动转为用采集到的正常视频帧发送 SEI 数据。

virtual IAudioMixingManager * bytertc::IRTCVideo::getAudioMixingManager()=0
cpp

Deprecated since 353.1, will be deleted in 359, use getAudioEffectPlayer or getMediaPlayer instead

混音管理接口创建

返回值

混音管理实例，详见 IAudioMixingManager

virtual int bytertc::IRTCVideo::muteAudioPlayback(MuteState mute_state)=0
cpp

Deprecated since 3.45 and will be deleted in 3.51, use setPlaybackVolume instead.

控制本地音频流播放状态：播放/不播放

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

注意

本方法仅控制本地收到音频流的播放状态，并不影响本地音频播放设备。

class bytertc::IAudioDeviceCollection
cpp

音频设备相关的信息

virtual int bytertc::IAudioDeviceCollection::getCount() override
cpp

获取当前系统内音频设备数量

返回值

音频设备数量

virtual int bytertc::IAudioDeviceCollection::getDevice(
    int index,
    char device_name[MAX_DEVICE_ID_LENGTH],
    char device_id[MAX_DEVICE_ID_LENGTH]
) override
cpp

根据索引号，获取设备信息

传入参数

返回值

• 0：方法调用成功
• !0：方法调用失败

virtual void bytertc::IAudioDeviceCollection::release() override
cpp

释放当前 IAudioDeviceCollection 对象占用的资源。

注意

不需要返回音频设备相关信息列表时应该调用本方法释放相关资源。

virtual int bytertc::IAudioDeviceCollection::getDevice(
    int index,
    AudioDeviceInfo* audio_device_info
)=0
cpp

根据索引号，获取设备信息

传入参数

返回值

• 0：方法调用成功
• !0：方法调用失败

class bytertc::IScreenCaptureSourceList
cpp

屏幕共享对象信息列表

共享对象相关数据将在调用 release 后被释放。

virtual int32_t bytertc::IScreenCaptureSourceList::getCount()=0
cpp

获取列表长度

返回值

可共享对象数量

virtual ScreenCaptureSourceInfo bytertc::IScreenCaptureSourceList::getSourceInfo(int32_t index)=0
cpp

根据索引号，获取屏幕共享列表中的元素

传入参数

返回值

屏幕源类型信息，详见 ScreenCaptureSourceInfo。

virtual void bytertc::IScreenCaptureSourceList::release()=0
cpp

IScreenCaptureSourceList 使用结束后，调用本接口删除对象，清空和释放内存。

class bytertc::IVideoDeviceCollection
cpp

视频设备相关的信息

virtual int bytertc::IVideoDeviceCollection::getCount() override
cpp

获取当前系统内视频设备数量

返回值

视频设备数量

virtual int bytertc::IVideoDeviceCollection::getDevice(
    int index,
    char device_name[MAX_DEVICE_ID_LENGTH],
    char device_id[MAX_DEVICE_ID_LENGTH]
) override
cpp

根据索引号，获取设备信息

传入参数

返回值

• 0：方法调用成功
• !0：方法调用失败

virtual void bytertc::IVideoDeviceCollection::release() override
cpp

释放当前 IVideoDeviceCollection 对象占用的资源。

注意

不需要返回视频设备相关信息列表时应该调用本方法释放相关资源。

virtual int bytertc::IVideoDeviceCollection::getDevice(
    int index,
    VideoDeviceInfo* video_device_info
)=0
cpp

根据索引号，获取设备信息

传入参数

返回值

• 0：方法调用成功
• !0：方法调用失败

class bytertc::IRTCRoom
cpp

房间接口

virtual void bytertc::IRTCRoom::destroy()=0
cpp

退出并销毁调用 createRTCRoom 所创建的房间实例。

virtual int bytertc::IRTCRoom::setUserVisibility(bool enable)=0
cpp

设置用户可见性。未调用该接口前，本地用户默认对他人可见。

默认情况下，一个 RTC 房间最多同时容纳 50 名可见用户，最多 30 人可同时上麦。更多信息参看用户和媒体流上限。

传入参数

返回值

• 0: 调用成功。
• < 0: 调用失败。参看 ReturnStatus 获得更多错误说明。

注意

• 在加入房间前后，用户均可调用此方法设置用户可见性。
• 设置用户可见性，会收到设置成功/失败回调 onUserVisibilityChanged。（v3.54 新增） • 在加入房间前设置用户可见性，若设置的可见性与默认值不同，将在加入房间时触发本回调。

• 在加入房间后设置用户可见性，若可见性前后不同，会触发本回调。

• 在断网重连后，若可见性发生改变，会触发本回调。

• 在房间内，调用此方法成功切换用户可见性后，房间内其他用户会收到相应的回调。 • 从可见换至不可见时，房间内其他用户会收到 onUserLeave。

• 从不可见切换至可见时，房间内其他用户会收到 onUserJoined。

• 若调用该方法将可见性设为 false，此时尝试发布流会收到 kWarningCodePublishStreamForbiden 警告。

virtual int bytertc::IRTCRoom::setRTCRoomEventHandler(IRTCRoomEventHandler* room_event_handler)=0
cpp

通过设置 IRTCRoom 对象的事件句柄，监听此对象对应的回调事件。

传入参数

返回值

• 0: 调用成功。
• < 0 : 调用失败。查看 ReturnStatus 获得更多错误说明

virtual int bytertc::IRTCRoom::joinRoom(
    const char* token,
    const UserInfo &user_info,
    const RTCRoomConfig &config
)=0
cpp

加入房间。

调用 createRTCRoom 创建房间后，调用此方法加入房间，同房间内其他用户进行音视频通话。

传入参数

返回值

• 0: 成功
• -1：room_id / user_info.uid 包含了无效的参数。
• -2：已经在房间内。接口调用成功后，只要收到返回值为 0 ，且未调用 leaveRoom: 成功，则再次调用进房接口时，无论填写的房间 ID 和用户 ID 是否重复，均触发此返回值。 调用失败时，具体失败原因会通过 onRoomStateChanged 回调告知。

注意

• 同一个 App ID 的同一个房间内，每个用户的用户 ID 必须是唯一的。如果两个用户的用户 ID 相同，则后进房的用户会将先进房的用户踢出房间，并且先进房的用户会收到 onRoomStateChanged 回调通知，错误类型详见 ErrorCode 中的 kErrorCodeDuplicateLogin。
• 本地用户调用此方法加入房间成功后，会收到 onRoomStateChanged 回调通知。若本地用户同时为可见用户，加入房间时远端用户会收到 onUserJoined 回调通知。
• 房间内不可见用户的容量远远大于可见用户，而且用户默认可见，因此对于不参与互动的用户，你需要在其进房后调用 setUserVisibility(https://www.volcengine.com/docs/6348/257549)。用户加入房间成功后，在本地网络状况不佳的情况下，SDK 可能会与服务器失去连接，并触发 onConnectionStateChanged #IRTCVideoEventHandler#onConnectionStateChanged$$]回调。此时 SDK 会自动重试，直到成功重连。重连成功后，本地会收到 onRoomStateChanged 回调通知。

virtual int bytertc::IRTCRoom::leaveRoom()=0
cpp

离开房间。
调用此方法结束通话过程，并释放所有通话相关的资源。

返回值

• 0: 调用成功。
• < 0: 调用失败，查看 ReturnStatus 获得更多错误说明。

注意

• 加入房间后，必须调用此方法结束通话，否则无法开始下一次通话。
• 此方法是异步操作，调用返回时并没有真正退出房间。真正退出房间后，本地会收到 onLeaveRoom 回调通知。你必须在收到 onLeaveRoom 回调后，再销毁房间或引擎，或调用 joinRoom 再次加入房间。
• 调用 setUserVisibility 将自身设为可见的用户离开房间后，房间内其他用户会收到 onUserLeave 回调通知。

virtual int bytertc::IRTCRoom::updateToken(const char* token)=0
cpp

更新 Token。

收到 onTokenWillExpire， onPublishPrivilegeTokenWillExpire， 或 onSubscribePrivilegeTokenWillExpire 时，你必须重新获取 Token，并调用此方法更新 Token，以保证通话的正常进行。

传入参数

返回值

方法调用结果：

• 0：成功；
• <0：失败。具体失败原因参看 ReturnStatus。

注意

• 3.50（不含）以前的版本中，Token 中的发布和订阅权限为保留参数，无实际控制权限；3.50 及以后版本开放 Token 发布订阅控制权限，如需通过 Token 控制连麦权限，请联系技术支持团队开通白名单后支持。
• 请勿同时调用 updateToken 和 joinRoom 方法更新 Token。若因 Token 过期或无效导致加入房间失败或已被移出房间，你应该在获取新的有效 Token 后调用 joinRoom 重新加入房间。

virtual int64_t bytertc::IRTCRoom::sendUserMessage(
    const char* uid,
    const char* message,
    MessageConfig config=kMessageConfigReliableOrdered
)=0
cpp

给房间内指定的用户发送点对点文本消息（P2P）。

传入参数

返回值

这次发送消息的编号，从 1 开始递增。

注意

• 在发送房间内文本消息前，必须先调用 joinRoom 加入房间。
• 调用该函数后会收到一次 onUserMessageSendResult 回调，通知消息发送方发送成功或失败；
• 若文本消息发送成功，则 uid 所指定的用户会收到 onUserMessageReceived 回调。

virtual int64_t bytertc::IRTCRoom::sendUserBinaryMessage(
    const char* uid,
    int length,
    const uint8_t* message,
    MessageConfig config=kMessageConfigReliableOrdered
)=0
cpp

给房间内指定的用户发送点对点二进制消息（P2P）。

传入参数

返回值

这次发送消息的编号，从 1 开始递增。

注意

• 在发送房间内二进制消息前，必须先调用 joinRoom 加入房间。
• 调用该函数后会收到一次 onUserMessageSendResult 回调，通知消息发送方发送成功或失败；
• 若二进制消息发送成功，则 uid 所指定的用户会收到 onUserBinaryMessageReceived 回调。