Public API

函数

函数说明

createRTCVideo

BYTERTC_API bytertc::IRTCVideo* bytertc::createRTCVideo(
    const char* app_id,
    bytertc::IRTCVideoEventHandler *event_handler,
    const char* parameters)

创建 IRTCVideo 实例。
如果当前线程中未创建引擎实例，那么你必须先使用此方法，以使用 RTC 提供的各种音视频能力。
如果当前线程中已创建了引擎实例，再次调用此方法时，会返回已创建的引擎实例。

传入参数

返回值

• IRTCVideo：创建成功。返回一个可用的 IRTCVideo 实例
• Null：创建失败。

destroyRTCVideo

BYTERTC_API void bytertc::destroyRTCVideo();

销毁由 createRTCVideo 创建的 IRTCVideo 实例，并释放所有相关资源。

注意

• 请确保和需要销毁的 IRTCVideo 实例相关的业务场景全部结束后，才调用此方法。如果在多线程场景下，调用此接口后，又调用了其他 IRTCVideo 相关接口，可能导致 SDK 崩溃。该方法在调用之后，会销毁所有和此 IRTCVideo 实例相关的内存，并且停止与媒体服务器的任何交互。
• 调用本方法会启动 SDK 退出逻辑。引擎线程会保留，直到退出逻辑完成。因此，不要在回调线程中直接调用此 API，也不要在回调中等待主线程的执行，并同时在主线程调用本方法。不然会造成死锁。

getErrorDescription

BYTERTC_API const char* bytertc::getErrorDescription(
    int code)

获取错误码的描述

传入参数

返回值 错误码的描述

注意 该接口是通用功能，调用时不需要依赖引擎对象。

getSDKVersion

BYTERTC_API const char* bytertc::getSDKVersion();

获取当前 SDK 版本信息。

返回值 当前 SDK 版本信息。

buildVideoFrame

BYTERTC_API IVideoFrame* bytertc::buildVideoFrame(
    const VideoFrameBuilder& builder)

创建 IVideoFrame

传入参数

返回值 IVideoFrame 实例

buildAudioFrame

BYTERTC_API IAudioFrame* bytertc::buildAudioFrame(
    const AudioFrameBuilder& builder)

创建 IAudioFrame

传入参数

返回值 详见 IAudioFrame

IRTCRoom

class bytertc::IRTCRoom

房间接口

成员函数

函数说明

destroy

virtual void bytertc::IRTCRoom::destroy()

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

setUserVisibility

virtual void bytertc::IRTCRoom::setUserVisibility(
    bool enable)

设置用户可见性。默认可见。

传入参数

注意

• 该方法在加入房间前后均可调用。
• 在房间内调用此方法，房间内其他用户会收到相应的回调通知：
• 从 false 切换至 true 时，房间内其他用户会收到 onUserJoined 回调通知；
• 从 true 切换至 false 时，房间内其他用户会收到 onUserLeave 回调通知。
• 若调用该方法将可见性设为 false，此时尝试发布流会收到 kWarningCodePublishStreamForbiden 警告。

setRTCRoomEventHandler

virtual void bytertc::IRTCRoom::setRTCRoomEventHandler(
    IRTCRoomEventHandler* room_event_handler)

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

传入参数

joinRoom

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

创建/加入房间：房间不存在时即创建房间；房间存在时，未加入房间的用户可加入这个房间。
同一房间内的用户间可以相互通话。

传入参数

返回值

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

注意

• 同一个 App ID 的同一个房间内，每个用户的用户 ID 必须是唯一的。如果两个用户的用户 ID 相同，则后进房的用户会将先进房的用户踢出房间，并且先进房的用户会收到 onStreamStateChanged 回调通知，错误类型详见 ErrorCode 中的 kErrorCodeDuplicateLogin。
• 本地用户调用此方法加入房间成功后，会收到 onRoomStateChanged 回调通知。
• 本地用户调用 setUserVisibility 将自身设为可见后加入房间，远端用户会收到 onUserJoined。
• 用户加入房间成功后，在本地网络状况不佳的情况下，SDK 可能会与服务器失去连接，此时 SDK 将会自动重连。重连成功后，本地会收到 onRoomStateChanged 回调通知。

leaveRoom

virtual void bytertc::IRTCRoom::leaveRoom()

离开房间。
用户调用此方法离开房间，结束通话过程，释放所有通话相关的资源。
加入房间后，必须调用此方法结束通话，否则无法开始下一次通话。无论当前是否在房间内，都可以调用此方法。重复调用此方法没有负面影响。
此方法是异步操作，调用返回时并没有真正退出房间。真正退出房间后，本地会收到 onLeaveRoom 回调通知。

注意

• 可见的用户离开房间后，房间内其他用户会收到 onUserLeave 回调通知。
• 如果调用此方法后立即销毁引擎，SDK 将无法触发 onLeaveRoom 回调。

updateToken

virtual void bytertc::IRTCRoom::updateToken(
    const char* token)

更新 Token。
用于加入房间的 Token 有一定的有效期。在 Token 过期前 30 秒，会收到 onTokenWillExpire 回调，此时需要重新获取 Token，并调用此方法更新 Token，否则用户将因为 Token 过期被移出房间。
调用 joinRoom 方法加入房间或断网重连进入房间时，如果 Token 过期或无效，将导致加入房间失败，并会收到 onRoomStateChanged 回调通知，回调错误码为 ErrorCode 中的 ERROR_CODE_INVALID_TOKEN。此时需要重新获取 Token，并调用此方法更新 Token。 更新 Token 后，SDK 会自动加入房间。

传入参数

返回值 方法调用结果。

• 0: 方法调用成功
• < 0: 方法调用失败

注意 当 Token 过期时，用户将被移出房间并将收到 onStreamStateChanged 回调， ERROR_CODE_EXPIRED_TOKEN，此时需要重新获取 Token，并调用 joinRoom 重新加入房间。

sendUserMessage

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

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

传入参数

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

注意

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

sendUserBinaryMessage

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

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

传入参数

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

注意

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

sendRoomMessage

virtual int64_t bytertc::IRTCRoom::sendRoomMessage(
    const char* message)

给房间内的所有其他用户发送广播消息。

传入参数

注意

• 在发送房间内二进制消息前，必须先调用 joinRoom 加入房间。
• 调用该函数后，会收到一次 onRoomMessageSendResult 回调。
• 同一房间内的其他用户会收到 onRoomMessageReceived 回调。

sendRoomBinaryMessage

virtual int64_t bytertc::IRTCRoom::sendRoomBinaryMessage(
    int size,
    const uint8_t* message)

给房间内的所有其他用户发送广播消息。

传入参数

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

注意

• 在发送房间内二进制消息前，必须先调用 joinRoom 加入房间。
• 调用该函数后，会收到一次 onRoomMessageSendResult 回调。
• 同一房间内的其他用户会收到 onRoomBinaryMessageReceived 回调。

publishStream

virtual void bytertc::IRTCRoom::publishStream(
    MediaStreamType type)

在当前所在房间内发布本地通过摄像头/麦克风采集的媒体流

传入参数

注意

• 如果你已经在用户进房时通过调用 joinRoom 成功选择了自动发布，则无需再调用本接口。
• 调用 setUserVisibility 方法将自身设置为不可见后无法调用该方法，需将自身切换至可见后方可调用该方法发布摄像头音视频流。
• 如果你需要发布屏幕共享流，调用 publishScreen。(Linux 不适用)
• 如果你需要向多个房间发布流，调用 startForwardStreamToRooms。
• 调用此方法后，房间中的所有远端用户会收到 onUserPublishStream 回调通知，其中成功收到了音频流的远端用户会收到 onFirstRemoteAudioFrame 回调，订阅了视频流的远端用户会收到 onFirstRemoteVideoFrameDecoded 回调。
• 调用 unpublishStream 取消发布。

unpublishStream

virtual void bytertc::IRTCRoom::unpublishStream(
    MediaStreamType type)

停止将本地摄像头/麦克风采集的媒体流发布到当前所在房间中

传入参数

注意

• 调用 publishStream 手动发布摄像头音视频流后，你需调用此接口停止发布。
• 调用此方法停止发布音视频流后，房间中的其他用户将会收到 onUserUnpublishStream 回调通知。

setRemoteVideoConfig

virtual void bytertc::IRTCRoom::setRemoteVideoConfig(
    const char *user_id,
    const RemoteVideoConfig &remote_video_config)

设置期望订阅的远端视频流的参数。

传入参数

注意

• 若使用 342 及以前版本的 SDK，调用该方法前请联系技术支持人员通过配置下发开启按需订阅功能。
• 该方法仅在发布端调用 enableSimulcastMode 开启了发送多路视频流的情况下生效，此时订阅端将收到来自发布端与期望设置的参数最相近的一路流；否则订阅端只会收到一路参数为分辨率 640px × 360px、帧率 15fps 的视频流。
• 若发布端开启了推送多路流功能，但订阅端不对流参数进行设置，则默认接受发送端设置的分辨率最大的一路视频流。
• 该方法需在进房后调用，若想进房前设置，你需调用 joinRoom，并对 room_config 中的 remote_video_config 进行设置。
• SDK 会根据发布端和所有订阅端的设置灵活调整视频流的参数，具体调整策略详见推送多路流文档。

subscribeStream

virtual void bytertc::IRTCRoom::subscribeStream(
    const char *user_id,
    MediaStreamType type)

订阅房间内指定的通过摄像头/麦克风采集的媒体流，或更新对指定远端用户的订阅选项

传入参数

注意

• 当调用本接口时，当前用户已经订阅该远端用户，不论是通过手动订阅还是自动订阅，都将根据本次传入的参数，更新订阅配置。
• 你必须先通过 onUserPublishStream} 回调获取当前房间里的远端摄像头音视频流信息，然后调用本方法按需订阅。
• 调用该方法后，你会收到 onStreamSubscribed 通知方法调用结果。
• 成功订阅远端用户的媒体流后，订阅关系将持续到调用 unsubscribeStream 取消订阅或本端用户退房。
• 关于其他调用异常，你会收到 onStreamStateChanged 回调通知，具体异常原因参看 ErrorCode。

unsubscribeStream

virtual void bytertc::IRTCRoom::unsubscribeStream(
    const char *user_id,
    MediaStreamType type)

取消订阅房间内指定的通过摄像头/麦克风采集的媒体流。
该方法对自动订阅和手动订阅模式均适用。

传入参数

注意

• 调用该方法后，你会收到 onStreamSubscribed 通知方法调用结果。
• 关于其他调用异常，你会收到 onStreamStateChanged 回调通知，具体失败原因参看 ErrorCode。

subscribeScreen

virtual void bytertc::IRTCRoom::subscribeScreen(
    const char *user_id,
    MediaStreamType type)

订阅房间内指定的远端屏幕共享音视频流，或更新对指定远端用户的订阅选项

传入参数

注意

• 当调用本接口时，当前用户已经订阅该远端用户，不论是通过手动订阅还是自动订阅，都将根据本次传入的参数，更新订阅配置。
• 你必须先通过 onUserPublishScreen} 回调获取当前房间里的远端屏幕流信息，然后调用本方法按需订阅。
• 调用该方法后，你会收到 onStreamSubscribed 通知方法调用结果。
• 成功订阅远端用户的媒体流后，订阅关系将持续到调用 unsubscribeScreen 取消订阅或本端用户退房。
• 关于其他调用异常，你会收到 onStreamStateChanged 回调通知，具体异常原因参看 ErrorCode。

unsubscribeScreen

virtual void bytertc::IRTCRoom::unsubscribeScreen(
    const char *user_id,
    MediaStreamType type)

取消订阅房间内指定的远端屏幕共享音视频流。
该方法对自动订阅和手动订阅模式均适用。

传入参数

注意

• 调用该方法后，你会收到 onStreamSubscribed 通知方法调用结果。
• 关于其他调用异常，你会收到 onStreamStateChanged 回调通知，具体失败原因参看 ErrorCode。

pauseAllSubscribedStream

virtual void bytertc::IRTCRoom::pauseAllSubscribedStream(
    PauseResumeControlMediaType media_type)

暂停接收来自远端的媒体流。

传入参数

注意

• 该方法仅暂停远端流的接收，并不影响远端流的采集和发送；
• 该方法不改变用户的订阅状态以及订阅流的属性。
• 若想恢复接收远端流，需调用 resumeAllSubscribedStream。
• 多房间场景下，仅暂停接收发布在当前所在房间的流。

resumeAllSubscribedStream

virtual void bytertc::IRTCRoom::resumeAllSubscribedStream(
    PauseResumeControlMediaType media_type)

恢复接收来自远端的媒体流

传入参数

注意

• 该方法仅恢复远端流的接收，并不影响远端流的采集和发送；
• 该方法不改变用户的订阅状态以及订阅流的属性。

setMultiDeviceAVSync

virtual void bytertc::IRTCRoom::setMultiDeviceAVSync(
    const char* audio_user_id)

设置发流端音画同步。
当同一用户同时使用两个通话设备分别采集发送音频和视频时，有可能会因两个设备所处的网络环境不一致而导致发布的流不同步，此时你可以在视频发送端调用该接口，SDK 会根据音频流的时间戳自动校准视频流，以保证接收端听到音频和看到视频在时间上的同步性。

传入参数

注意

• 该方法在进房前后均可调用。
• 进行音画同步的音频发布用户 ID 和视频发布用户 ID 须在同一个 RTC 房间内。
• 调用该接口后音画同步状态发生改变时，你会收到 onAVSyncStateChange 回调。
• 同一 RTC 房间内允许存在多个音视频同步关系，但需注意单个音频源不支持与多个视频源同时同步。
• 如需更换同步音频源，再次调用该接口传入新的 audio_user_id 即可；如需更换同步视频源，需先解除当前的同步关系，后在新视频源端开启同步。

startForwardStreamToRooms

virtual int bytertc::IRTCRoom::startForwardStreamToRooms(
    const ForwardStreamConfiguration& configuration)

开始跨房间转发媒体流。 在用户进入房间后调用本接口，实现向多个房间转发媒体流，适用于跨房间连麦等场景。

传入参数

返回值

0: 方法调用成功
<0: 方法调用失败

注意

• 调用本方法后，将在本端触发 onForwardStreamStateChanged 回调。
• 调用本方法后，你可以通过监听 onForwardStreamEvent 回调来获取各个目标房间在转发媒体流过程中的相关事件。
• 开始转发后，目标房间中的用户将接收到本地用户进房 onUserJoined 和发流 onUserPublishStream/onUserPublishScreen 的回调。
• 调用本方法后，可以调用 updateForwardStreamToRooms 更新目标房间信息，例如，增加或减少目标房间等。
• 调用本方法后，可以调用 stopForwardStreamToRooms 停止向所有房间转发媒体流。
• 调用本方法后，可以调用 pauseForwardStreamToAllRooms 暂停向所有房间转发媒体流。

updateForwardStreamToRooms

virtual int bytertc::IRTCRoom::updateForwardStreamToRooms(
    const ForwardStreamConfiguration& configuration)

更新跨房间媒体流转发信息。
通过 startForwardStreamToRooms 发起媒体流转发后，可调用本方法增加或者减少目标房间，或更新房间密钥。 调用本方法增加或删减房间后，将在本端触发 onForwardStreamStateChanged 回调，包含发生了变动的目标房间中媒体流转发状态。

传入参数

返回值

0: 方法调用成功
<0: 方法调用失败

注意

• 增加目标房间后，新增目标房间中的用户将接收到本地用户进房 onUserJoined 和发布 onUserPublishStream/onUserPublishScreen 的回调。
• 删减目标房间后，原目标房间中的用户将接收到本地用户停止发布 onUserUnpublishStream/onUserUnpublishScreen 和退房 onUserLeave 的回调。

stopForwardStreamToRooms

virtual void bytertc::IRTCRoom::stopForwardStreamToRooms()

停止跨房间媒体流转发。 通过 startForwardStreamToRooms 发起媒体流转发后，可调用本方法停止向所有目标房间转发媒体流。

注意

• 调用本方法后，将在本端触发 onForwardStreamStateChanged 回调。
• 调用本方法后，原目标房间中的用户将接收到本地用户停止发布 onUserUnpublishStream/onUserUnpublishScreen 和退房 onUserLeave 的回调。
• 如果需要停止向指定的房间转发媒体流，请调用 updateForwardStreamToRooms 更新房间信息。
• 如果需要暂停转发，请调用 pauseForwardStreamToAllRooms，并在之后随时调用 resumeForwardStreamToAllRooms 快速恢复转发。

pauseForwardStreamToAllRooms

virtual void bytertc::IRTCRoom::pauseForwardStreamToAllRooms()

暂停跨房间媒体流转发。 通过 startForwardStreamToRooms 发起媒体流转发后，可调用本方法暂停向所有目标房间转发媒体流。 调用本方法暂停向所有目标房间转发后，你可以随时调用 resumeForwardStreamToAllRooms 快速恢复转发。

注意 调用本方法后，目标房间中的用户将接收到本地用户停止发布 onUserUnpublishStream/onUserUnpublishScreen 和退房 onUserLeave 的回调。

resumeForwardStreamToAllRooms

virtual void bytertc::IRTCRoom::resumeForwardStreamToAllRooms()

恢复跨房间媒体流转发。 调用 pauseForwardStreamToAllRooms 暂停转发之后，调用本方法恢复向所有目标房间转发媒体流。

注意 目标房间中的用户将接收到本地用户进房 onUserJoined 和发布 onUserPublishStream/onUserPublishScreen 的回调。

IRTCVideo

class bytertc::IRTCVideo

引擎 API

成员函数

函数说明

setCaptureVolume

virtual void bytertc::IRTCVideo::setCaptureVolume(
    StreamIndex index,
    int volume)

调节音频采集音量

传入参数

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

setPlaybackVolume

virtual void bytertc::IRTCVideo::setPlaybackVolume(
    const int volume)

调节本地播放的所有远端用户混音后的音量。播放音频前或播放音频时，你都可以使用此接口设定播放音量。

传入参数

startAudioCapture

virtual void bytertc::IRTCVideo::startAudioCapture()

开启内部音频采集。默认为关闭状态。
内部采集是指：使用 RTC SDK 内置的音频采集机制进行视频采集。 调用该方法开启后，本地用户会收到 onAudioDeviceStateChanged 的回调。
非隐身用户进房后调用该方法，房间中的其他用户会收到 onUserStartAudioCapture 的回调。

注意

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

stopAudioCapture

virtual void bytertc::IRTCVideo::stopAudioCapture()

立即关闭内部音频采集。默认为关闭状态。
内部采集是指：使用 RTC SDK 内置的音频采集机制进行视频采集。 调用该方法，本地用户会收到 onAudioDeviceStateChanged 的回调。
非隐身用户进房后调用该方法后，房间中的其他用户会收到 onUserStopAudioCapture 的回调。

注意

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

setAudioProfile

virtual void bytertc::IRTCVideo::setAudioProfile(
    AudioProfileType audio_profile)

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

传入参数

注意

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

setAudioSourceType

virtual int bytertc::IRTCVideo::setAudioSourceType (
    AudioSourceType type)

切换音频采集方式

传入参数

返回值 方法调用结果：

• >0: 切换成功。
• -1：切换失败。

注意

• 进房前后调用此方法均有效。
• 如果你调用此方法由内部采集切换至自定义采集，SDK 会自动关闭内部采集。然后，调用 pushExternalAudioFrame 推送自定义采集的音频数据到 RTC SDK 用于传输。
• 如果你调用此方法由自定义采集切换至内部采集，你必须再调用 startAudioCapture 手动开启内部采集。

setAudioRenderType

virtual int bytertc::IRTCVideo::setAudioRenderType (
    AudioRenderType type)

切换音频渲染方式

传入参数

返回值 方法调用结果：

• >0: 切换成功。
• -1：切换失败。

注意

• 进房前后调用此方法均有效。
• 如果你调用此方法切换至自定义渲染，调用 pullExternalAudioFrame 获取音频数据。

pushExternalAudioFrame

virtual bool bytertc::IRTCVideo::pushExternalAudioFrame(
    IAudioFrame* audioFrame)

推送自定义音频数据。

传入参数

返回值 方法调用结果

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

注意

• 推送自定义采集的音频数据前，必须先调用 setAudioSourceType 开启自定义采集。
• 你必须每 10 ms 推送一次数据。

pullExternalAudioFrame

virtual bool bytertc::IRTCVideo::pullExternalAudioFrame(
    IAudioFrame* audioFrame)

拉取远端音频数据。可用于自定义音频渲染。

传入参数

返回值 方法调用结果：

• true: 方法调用成功
• false：方法调用失败

注意

• 获取音频数据用于自定义渲染前，必须先调用 setAudioRenderType 开启自定义渲染。
• 每隔 10 ms 获取一次音频数据。
• 该函数运行在用户调用线程内，是一个同步函数。

startVideoCapture

virtual void bytertc::IRTCVideo::startVideoCapture()

立即开启内部视频采集。默认为关闭状态。
内部视频采集指：使用 RTC SDK 内置视频采集模块，进行采集。
调用该方法后，本地用户会收到 onVideoDeviceStateChanged 的回调。
本地用户在非隐身状态下调用该方法后，房间中的其他用户会收到 onUserStartVideoCapture 的回调。

注意

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

stopVideoCapture

virtual void bytertc::IRTCVideo::stopVideoCapture()

立即关闭内部视频采集。默认为关闭状态。
内部视频采集指：使用 RTC SDK 内置视频采集模块，进行采集。
调用该方法后，本地用户会收到 onVideoDeviceStateChanged 的回调。
非隐身用户进房后调用该方法，房间中的其他用户会收到 onUserStopVideoCapture 的回调。

注意

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

setVideoCaptureConfig

virtual int bytertc::IRTCVideo::setVideoCaptureConfig(
    const VideoCaptureConfig& videoCaptureConfig)

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

传入参数

返回值

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

注意

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

enableSimulcastMode

virtual int bytertc::IRTCVideo::enableSimulcastMode(
    bool enabled)

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

传入参数

返回值 方法调用结果：

• 0: 成功
• <0: 失败

注意

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

setVideoEncoderConfig

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

视频发布端设置期望发布的最大分辨率视频流参数，包括分辨率、帧率、码率、缩放模式、网络不佳时的回退策略等。
该接口支持设置一路视频流参数，设置多路参数请使用重载 API：setVideoEncoderConfig。

传入参数

返回值 方法调用结果：

• 0：成功
• !0：失败

注意

• 若调用该方法设置了期望发布的最大分辨率的流参数之前，已调用 enableSimulcastMode 开启发布多路视频流的模式，SDK 会根据订阅端的设置自动调整发布的流数以及各路流的参数，其中最大分辨率为设置的分辨率，流数最多 4 条，具体参看推送多路流文档；否则仅发布该条最大分辨率的视频流。
• 调用该方法设置多路视频流参数前，SDK 默认仅发布一条分辨率为 640px × 360px，帧率为 15fps 的视频流。
• 该方法适用于摄像头采集的视频流，设置屏幕共享视频流参数参看 setScreenVideoEncoderConfig（Linux 不适用）。

setVideoEncoderConfig

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

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

传入参数

返回值 方法调用结果：

• 0：成功
• !0：失败

注意

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

setLocalVideoCanvas

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

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

传入参数

返回值

• 0：成功
• !0：失败

注意

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

updateLocalVideoCanvas

virtual void bytertc::IRTCVideo::updateLocalVideoCanvas(
    StreamIndex index,
    const enum RenderMode renderMode,
    const uint32_t backgroundColor)

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

传入参数

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

setRemoteStreamVideoCanvas

virtual void bytertc::IRTCVideo::setRemoteStreamVideoCanvas(
    RemoteStreamKey stream_key,
    const VideoCanvas& canvas)

设置渲染指定视频流 stream_key 时，使用的视图和渲染模式。
如果需要解除某个用户的绑定视图，你可以把 canvas 设置为空。

传入参数

返回值

• 0：成功
• !0：失败

注意

• 你应在收到 onUserJoined 或 onFirstRemoteVideoFrameDecoded 后，为远端视频绑定渲染视图。这两个回调的差别是：如果启用了视频录制功能，视频录制服务会作为一个哑客户端加入房间，因此其他客户端会收到对应的 onUserJoined 回调，而不会收到 onFirstRemoteVideoFrameDecoded 回调。你不应给录制的哑亚客户端绑定视图（因为它不会发送视频流）。
• 本地用户离开房间时，会解除调用此 API 建立的绑定关系；远端用户离开房间则不会影响。

updateRemoteStreamVideoCanvas

virtual void bytertc::IRTCVideo::updateRemoteStreamVideoCanvas(
    RemoteStreamKey stream_key,
    const enum RenderMode renderMode,
    const uint32_t backgroundColor)

修改远端视频渲染模式和背景色。

传入参数

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

setLocalVideoSink

virtual void bytertc::IRTCVideo::setLocalVideoSink(
    StreamIndex index,
    IVideoSink* video_sink,
    IVideoSink::PixelFormat required_format)

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

传入参数

注意

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

setRemoteVideoSink

virtual void bytertc::IRTCVideo::setRemoteVideoSink(
    RemoteStreamKey stream_key,
    IVideoSink* video_sink,
    IVideoSink::PixelFormat required_format)

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

传入参数

注意

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

setVideoSourceType

virtual void bytertc::IRTCVideo::setVideoSourceType(
    StreamIndex stream_index,
    VideoSourceType type)

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

传入参数

注意

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

pushExternalVideoFrame

virtual bool bytertc::IRTCVideo::pushExternalVideoFrame(
    IVideoFrame* frame)

发送外部源视频数据

传入参数

注意

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

createRTCRoom

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

创建房间 多次调用此方法以创建多个 IRTCRoom 实例。分别调用各 IRTCRoom 实例中的 joinRoom 方法，同时加入多个房间。多房间模式下，用户可以同时订阅各房间的音视频流。

传入参数

返回值 IRtcRoom 实例

注意 如果你需要在多个房间发布音视频流，无须创建多房间，直接调用 startForwardStreamToRooms。

setPublishFallbackOption

virtual int bytertc::IRTCVideo::setPublishFallbackOption(
    PublishFallbackOption option)

设置发布的音视频流的回退选项。
你可以调用该接口设置网络不佳或设备性能不足时从大流起进行降级处理，以保证通话质量。

传入参数

返回值 方法调用结果：

• 0：成功
• < 0：失败

注意

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

setSubscribeFallbackOption

virtual int bytertc::IRTCVideo::setSubscribeFallbackOption(
    SubscribeFallbackOption option)

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

传入参数

返回值 方法调用结果：

• 0：成功
• < 0：失败

注意

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

setRemoteUserPriority

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

设置用户优先级

传入参数

返回值 0: 方法调用成功

• < 0: 方法调用失败

注意

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

setBusinessId

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

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

传入参数

返回值

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

注意

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

getVideoEffectInterface

virtual IVideoEffect* bytertc::IRTCVideo::getVideoEffectInterface()

获取视频特效接口

返回值 视频特效接口指针，参看 IVideoEffect

setEncryptInfo

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

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

传入参数

注意

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

setCustomizeEncryptHandler

virtual void bytertc::IRTCVideo::setCustomizeEncryptHandler(
    IEncryptHandler* handler)

设置自定义加密
需要实现对应的加密/解密方法，详情参考 EncryptType 。

传入参数

注意

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

enableAudioFrameCallback

virtual void bytertc::IRTCVideo::enableAudioFrameCallback(
    AudioFrameCallbackMethod method,
    AudioFormat format)

开启音频回调

传入参数

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

disableAudioFrameCallback

virtual void bytertc::IRTCVideo::disableAudioFrameCallback(
    AudioFrameCallbackMethod method)

关闭音频回调

传入参数

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

registerAudioFrameObserver

virtual void bytertc::IRTCVideo::registerAudioFrameObserver(
    IAudioFrameObserver* observer)

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

传入参数

返回值

• 0: 方法调用成功
• < 0: 方法调用失败

注意 注册音频数据回调观察者并调用 enableAudioFrameCallback 后，IAudioFrameObserver 会收到对应的音频回调。

registerAudioProcessor

virtual void bytertc::IRTCVideo::registerAudioProcessor(
    IAudioFrameProcessor* processor)

注册自定义音频处理器。
注册完成后，你可以调用 enableAudioProcessor，对本地采集或接收到的远端音频进行处理。

传入参数

注意 重复调用此接口时，仅最后一次调用生效。

enableAudioProcessor

virtual void bytertc::IRTCVideo::enableAudioProcessor(
    AudioProcessorMethod method,
    AudioFormat format)

获取本地采集的音频帧或接收到的远端音频帧，进行自定义处理。

传入参数

注意

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

disableAudioProcessor

virtual void bytertc::IRTCVideo::disableAudioProcessor(
    AudioProcessorMethod method)

关闭自定义音频处理。

传入参数

registerVideoFrameObserver

virtual void bytertc::IRTCVideo::registerVideoFrameObserver(
    IVideoFrameObserver* observer)

注册视频数据回调观察者

传入参数

注意 该方法可以在任意时间调用，建议在 joinRoom 前。

registerLocalVideoProcessor

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

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

传入参数

返回值

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

注意

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

sendSEIMessage

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

在视频通信时，通过视频帧发送 SEI 数据。

传入参数

返回值

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

注意

• 你可以通过此接口对 RTC SDK 内部采集的视频帧添加 SEI。对于采用自定义采集获得的视频帧：如果原视频帧中没有添加 SEI 数据，那么你可以调用此接口为其中添加 SEI 信息后，进行编码传输；如果原视频帧中已添加了 SEI 数据，那么，调用此接口不生效。
• 如果调用此接口之后的 2s 内，没有可带 SEI 的视频帧（比如没有开启视频采集和传输），那么，SEI 数据不会被加进视频帧中。
• 消息发送成功后，远端会收到 onSEIMessageReceived 回调。

getVideoDeviceManager

virtual IVideoDeviceManager* bytertc::IRTCVideo::getVideoDeviceManager()

创建视频设备管理实例

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

注意 当不再使用IVideoDeviceManager实例时，调用该实例的 release 接口，以免资源泄露

getAudioDeviceManager

virtual IAudioDeviceManager* bytertc::IRTCVideo::getAudioDeviceManager()

设备音频管理接口创建

返回值 音频设备管理接口

enableExternalSoundCard

virtual void bytertc::IRTCVideo::enableExternalSoundCard(
    bool enable)

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

传入参数

注意

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

setRuntimeParameters

virtual void bytertc::IRTCVideo::setRuntimeParameters(
    const char * json_string)

设置运行时的参数

传入参数

feedback

virtual int bytertc::IRTCVideo::feedback(
    ProblemFeedbackOption *type,
    int count,
    const char* problem_desc)

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

传入参数

返回值

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

注意 如果用户上报时在房间内，那么问题会定位到用户当前所在的一个或多个房间；如果用户上报时不在房间内，那么问题会定位到引擎此前退出的房间。

getAudioMixingManager

virtual IAudioMixingManager* bytertc::IRTCVideo::getAudioMixingManager()

混音管理接口创建

返回值 混音管理实例，详见IAudioMixingManager

login

virtual int64_t bytertc::IRTCVideo::login(
    const char* token,
    const char* uid)

必须先登录，才能发送房间外点对点消息和向应用服务器发送消息
在调用本接口登录后，如果想要登出，需要调用 logout。

传入参数

返回值

• 0：成功
• -1：失败。无效参数
• -2：无效调用。用户已经登录。成功登录后再次调用本接口将收到此返回值

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

logout

virtual void bytertc::IRTCVideo::logout()

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

注意

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

updateLoginToken

virtual void bytertc::IRTCVideo::updateLoginToken(
    const char* token)

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

传入参数

注意

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

setServerParams

virtual void bytertc::IRTCVideo::setServerParams(
    const char* signature,
    const char* url)

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

传入参数

注意

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

getPeerOnlineStatus

virtual void bytertc::IRTCVideo::getPeerOnlineStatus(
    const char* peer_user_id)

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

传入参数

注意

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

sendUserMessageOutsideRoom

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

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

传入参数

返回值

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

注意

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

sendUserBinaryMessageOutsideRoom

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

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

传入参数

返回值

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

注意

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

sendServerMessage

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

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

传入参数

返回值

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

注意

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

sendServerBinaryMessage

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

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

传入参数

返回值

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

注意

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

startNetworkDetection

virtual NetworkDetectionStartReturn bytertc::IRTCVideo::startNetworkDetection(
    bool is_test_uplink,
    int expected_uplink_bitrate,
    bool is_test_downlink,
    int expected_downlink_biterate)

开启通话前网络探测

传入参数

返回值 开启通话前网络探测结果，详见 NetworkDetectionStartReturn

注意

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

stopNetworkDetection

virtual void bytertc::IRTCVideo::stopNetworkDetection()

停止通话前网络探测

注意

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

startLiveTranscoding

virtual void bytertc::IRTCVideo::startLiveTranscoding(
    const char* task_id,
    ITranscoderParam* param,
    ITranscoderObserver* observer)

新增转推直播任务，并设置合流的图片、视频视图布局和音频属性。
同一个任务中转推多路直播流时，SDK 会先将多路流合成一路流，然后再进行转推。

传入参数

注意

• 调用该方法后，关于启动结果和推流过程中的错误，会收到 onStreamMixingEvent 回调。
• 调用 stopLiveTranscoding 停止转推直播。

stopLiveTranscoding

virtual void bytertc::IRTCVideo::stopLiveTranscoding(
    const char* task_id)

停止转推直播，会收到 onStreamMixingEvent 回调。
关于启动转推直播，参看 startLiveTranscoding。

传入参数

updateLiveTranscoding

virtual void bytertc::IRTCVideo::updateLiveTranscoding(
    const char* task_id,
    ITranscoderParam* param)

更新转推直播参数，会收到 onStreamMixingEvent 回调。
使用 startLiveTranscoding 启用转推直播功能后，使用此方法更新功能配置参数。

传入参数

startPushPublicStream

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

发布一路公共流
公共流是指不属于任何房间，也不属于任何用户的媒体流。使用同一 appID 的用户，可以调用 startPlayPublicStream 获取和播放指定的公共流。

传入参数

返回值

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

注意

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

stopPushPublicStream

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

停止发布当前用户发布的公共流
关于发布公共流，查看 startPushPublicStream。

传入参数

返回值

• 0: 成功
• !0: 失败

updatePublicStreamParam

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

更新公共流参数
关于发布公共流，查看 startPushPublicStream。

传入参数

返回值

• 0: 成功
• !0: 失败

enableAudioPropertiesReport

virtual void bytertc::IRTCVideo::enableAudioPropertiesReport(
    const AudioPropertiesConfig& config)

启用音频信息提示。

传入参数

注意 开启提示后，你可以：

• 通过 onLocalAudioPropertiesReport 回调获取本地麦克风和屏幕音频流采集的音频信息；
• 通过 onRemoteAudioPropertiesReport 回调获取订阅的远端用户的音频信息。
• 通过 onActiveSpeaker 回调获取房间内的最活跃用户信息。

setRemoteAudioPlaybackVolume

virtual void bytertc::IRTCVideo::setRemoteAudioPlaybackVolume(
    const char* room_id,
    const char* user_id,
    int volume)

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

传入参数

enableVocalInstrumentBalance

virtual void bytertc::IRTCVideo::enableVocalInstrumentBalance(
    bool enable)

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

传入参数

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

enablePlaybackDucking

virtual void bytertc::IRTCVideo::enablePlaybackDucking(
    bool enable)

打开/关闭音量闪避功能，适用于“一起看”等场景。
开启该功能后，当检测到远端人声时，本地的媒体播放音量会自动减弱，从而保证远端人声的清晰可辨；当远端人声消失时，本地媒体音量会恢复到闪避前的音量水平。

传入参数

registerLocalEncodedVideoFrameObserver

virtual void bytertc::IRTCVideo::registerLocalEncodedVideoFrameObserver(
    ILocalEncodedVideoFrameObserver* observer)

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

传入参数

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

registerRemoteEncodedVideoFrameObserver

virtual void bytertc::IRTCVideo::registerRemoteEncodedVideoFrameObserver(
    IRemoteEncodedVideoFrameObserver* observer)

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

传入参数

注意

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

setExternalVideoEncoderEventHandler

virtual void bytertc::IRTCVideo::setExternalVideoEncoderEventHandler(
    IExternalVideoEncoderEventHandler* encoder_handler)

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

传入参数

注意

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

pushExternalEncodedVideoFrame

virtual bool bytertc::IRTCVideo::pushExternalEncodedVideoFrame(
    StreamIndex index,
    int video_index,
    IEncodedVideoFrame* video_stream)

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

传入参数

注意

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

setVideoDecoderConfig

virtual void bytertc::IRTCVideo::setVideoDecoderConfig(
    RemoteStreamKey key,
    VideoDecoderConfig config)

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

传入参数

注意

• 该方法仅适用于手动订阅模式，并且在订阅远端流之前使用。
• 当你想要对远端流进行自定义解码时，你需要先调用 registerRemoteEncodedVideoFrameObserver 注册远端视频流监测器，然后再调用该接口将解码方式设置为自定义解码。监测到的视频数据会通过 onRemoteEncodedVideoFrame 回调出来。

requestRemoteVideoKeyFrame

virtual void bytertc::IRTCVideo::requestRemoteVideoKeyFrame(
    const RemoteStreamKey& stream_info)

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

传入参数

注意

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

sendStreamSyncInfo

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

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

传入参数

返回值

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

注意 在采用 kRoomProfileTypeLiveBroadcasting 作为房间模式时，此消息一定会送达。在其他房间模式下，如果本地用户未说话，此消息不一定会送达。

setLocalVoicePitch

virtual void bytertc::IRTCVideo::setLocalVoicePitch(
    int pitch)

开启本地语音变调功能，多用于 K 歌场景。
使用该方法，你可以对本地语音的音调进行升调或降调等调整。

传入参数

muteAudioPlayback

virtual void bytertc::IRTCVideo::muteAudioPlayback(
    MuteState mute_state)

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

传入参数

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

startPlayPublicStream

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

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

传入参数

返回值

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

注意

• 在调用本接口之前，建议先绑定渲染视图。
• 调用 setPublicStreamVideoCanvas 绑定内部渲染视图：
• 调用 setPublicStreamVideoSink 绑定自定义渲染视图：
• 调用本接口后，可以通过 onFirstPublicStreamVideoFrameDecoded 和 onFirstPublicStreamAudioFrame 回调公共流的视频和音频首帧解码情况。
• 调用本接口后，可以通过 onPublicStreamSEIMessageReceived 回调公共流中包含的 SEI 信息。
• 订阅公共流之后，可以通过调用 stopPlayPublicStream 接口取消订阅公共流。

stopPlayPublicStream

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

取消订阅指定公共流
关于订阅公共流，查看 startPlayPublicStream。

传入参数

返回值

• 0：成功
• !0：失败

setPublicStreamVideoCanvas

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

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

传入参数

返回值

• 0：成功
• !0：失败

setPublicStreamVideoSink

virtual void bytertc::IRTCVideo::setPublicStreamVideoSink(
    const char* public_stream_id,
    IVideoSink* video_sink,
    IVideoSink::PixelFormat format)

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

传入参数

返回值

• 0：成功
• !0：失败

setVideoWatermark

virtual void bytertc::IRTCVideo::setVideoWatermark(
    StreamIndex streamIndex,
    const char* image_path,
    RTCWatermarkConfig config)

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

传入参数

注意

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

clearVideoWatermark

virtual void bytertc::IRTCVideo::clearVideoWatermark(
    StreamIndex streamIndex)

移除指定视频流的水印。

传入参数

startCloudProxy

virtual void bytertc::IRTCVideo::startCloudProxy(
    const CloudProxyConfiguration& configuration)

开启云代理

传入参数

注意

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

stopCloudProxy

virtual void bytertc::IRTCVideo::stopCloudProxy()

关闭云代理

注意 要开启云代理，调用 startCloudProxy。

IDeviceCollection

class bytertc::IDeviceCollection

音视频设备相关的信息

成员函数

函数说明

getCount

virtual int bytertc::IDeviceCollection::getCount()

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

返回值 音视频设备数量

getDevice

virtual int bytertc::IDeviceCollection::getDevice(
    int index,
    char device_name[MAX_DEVICE_ID_LENGTH],
    char device_id[MAX_DEVICE_ID_LENGTH])

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

传入参数

返回值

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

release

virtual void bytertc::IDeviceCollection::release()

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

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

IAudioDeviceCollection

class bytertc::IAudioDeviceCollection

音频设备相关的信息

成员函数

函数说明

getCount

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

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

返回值 音频设备数量

getDevice

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

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

传入参数

返回值

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

release

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

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

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

getDevice

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

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

传入参数

返回值

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

IAudioDeviceManager

class bytertc::IAudioDeviceManager

音频设备管理类

成员函数

函数说明

enumerateAudioPlaybackDevices

virtual IAudioDeviceCollection* bytertc::IAudioDeviceManager::enumerateAudioPlaybackDevices()

获取当前系统内音频播放设备列表。如果后续设备有变更，你会收到 OnMediaDeviceStateChanged 回调通知，然后需要重新调用本接口以获得新的设备列表。

返回值 包含系统中所有音频播放设备的列表，参看 IAudioDeviceCollection。

enumerateAudioCaptureDevices

virtual IAudioDeviceCollection* bytertc::IAudioDeviceManager::enumerateAudioCaptureDevices()

获取当前系统内音频采集设备列表。如果后续设备有变更，你需要重新调用本接口以获得新的设备列表。

返回值 一个包含系统中所有音频采集设备列表的对象，详见 IAudioDeviceCollection。

注意 当不再使用返回的对象时，你需要调用 release 进行释放。

followSystemPlaybackDevice

virtual void bytertc::IAudioDeviceManager::followSystemPlaybackDevice(
    bool followed)

设置音频播放路由是否跟随系统。

传入参数

followSystemCaptureDevice

virtual void bytertc::IAudioDeviceManager::followSystemCaptureDevice(
    bool followed)

设置音频采集路由是否跟随系统。

传入参数

setAudioPlaybackDevice

virtual int bytertc::IAudioDeviceManager::setAudioPlaybackDevice(
    const char device_id[MAX_DEVICE_ID_LENGTH])

设置音频播放设备。

传入参数

返回值

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

注意 当你调用 followSystemPlaybackDevice 设置音频播放设备跟随系统后，将无法调用此接口设置音频播放设备。

setAudioCaptureDevice

virtual int bytertc::IAudioDeviceManager::setAudioCaptureDevice(
    const char device_id[MAX_DEVICE_ID_LENGTH])

设置音频采集设备。

传入参数

返回值 方法调用结果

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

注意 当你调用 followSystemCaptureDevice 设置音频采集设备跟随系统后，将无法调用此接口设置音频采集设备。

setAudioPlaybackDeviceVolume

virtual int bytertc::IAudioDeviceManager::setAudioPlaybackDeviceVolume(
    unsigned int volume)

设置当前音频播放设备音量

传入参数

返回值 方法调用结果

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

getAudioPlaybackDeviceVolume

virtual int bytertc::IAudioDeviceManager::getAudioPlaybackDeviceVolume(
    unsigned int* volume)

获取当前音频播放设备音量

传入参数

返回值 方法调用结果

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

setAudioCaptureDeviceVolume

virtual int bytertc::IAudioDeviceManager::setAudioCaptureDeviceVolume(
    unsigned int volume)

设置当前音频采集设备音量

传入参数

返回值 方法调用结果

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

getAudioCaptureDeviceVolume

virtual int bytertc::IAudioDeviceManager::getAudioCaptureDeviceVolume(
    unsigned int* volume)

获取当前音频采集设备音量

传入参数

返回值 方法调用结果

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

setAudioPlaybackDeviceMute

virtual int bytertc::IAudioDeviceManager::setAudioPlaybackDeviceMute(
    bool mute)

设置当前音频播放设备静音状态，默认为非静音。

传入参数

返回值 方法调用结果

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

getAudioPlaybackDeviceMute

virtual int bytertc::IAudioDeviceManager::getAudioPlaybackDeviceMute(
    bool* mute)

获取当前音频播放设备是否静音的信息。

传入参数

返回值 方法调用结果

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

setAudioCaptureDeviceMute

virtual int bytertc::IAudioDeviceManager::setAudioCaptureDeviceMute(
    bool mute)

设置当前音频采集设备静音状态，默认为非静音。

传入参数

返回值 方法调用结果

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

getAudioCaptureDeviceMute

virtual int bytertc::IAudioDeviceManager::getAudioCaptureDeviceMute(
    bool* mute)

获取当前音频采集设备是否静音的信息。

传入参数

返回值 方法调用结果

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

getAudioPlaybackDevice

virtual int bytertc::IAudioDeviceManager::getAudioPlaybackDevice(
    char device_id[MAX_DEVICE_ID_LENGTH])

获取当前音频播放设备 ID。

传入参数

返回值 方法调用结果

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

getAudioCaptureDevice

virtual int bytertc::IAudioDeviceManager::getAudioCaptureDevice(
    char device_id[MAX_DEVICE_ID_LENGTH])

获取当前音频采集设备 ID。

传入参数

返回值 方法调用结果

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

initAudioPlaybackDeviceForTest

virtual int bytertc::IAudioDeviceManager::initAudioPlaybackDeviceForTest(
    const char deviceId[MAX_DEVICE_ID_LENGTH])

尝试初始化音频播放设备，可检测出设备不存在、权限被拒绝/禁用等异常问题。

传入参数

返回值 设备状态错误码

• 0: 设备检测结果正常
• -1: 接口状态不正确，例如在正常启动采集后再调用该接口进行检测
• -2: 采集设备无麦克风权限，尝试初始化设备失败
• -3: 设备不存在，当前没有设备或设备被移除时返回
• -4: 设备音频格式不支持
• -5: 其它原因错误

注意 1. 该接口需在进房前调用； 2. 检测成功不代表设备一定可以启动成功，还可能因设备被其他应用进程独占，或 CPU/内存不足等原因导致启动失败。

initAudioCaptureDeviceForTest

virtual int bytertc::IAudioDeviceManager::initAudioCaptureDeviceForTest(
    const char deviceId[MAX_DEVICE_ID_LENGTH])

尝试初始化音频采集设备，可检测设备不存在、权限被拒绝/禁用等异常问题。

传入参数

返回值 设备状态错误码

• 0: 设备检测结果正常
• -1: 接口状态不正确，例如在正常启动采集后再调用该接口进行检测
• -2: 采集设备无麦克风权限，尝试初始化设备失败
• -3: 设备不存在，当前没有设备或设备被移除时返回
• -4: 设备音频格式不支持
• -5: 其它原因错误

注意 1. 该接口需在进房前调用; 2. 检测成功不代表设备一定可以启动成功，还可能因设备被其他应用进程独占，或 CPU/内存不足等原因导致启动失败。

startAudioPlaybackDeviceTest

virtual int bytertc::IAudioDeviceManager::startAudioPlaybackDeviceTest(
    const char* test_audio_file_path,
    int indication_interval)

启动音频播放设备检测。测试启动后，循环播放指定的音频文件，同时将通过 onAudioPlaybackDeviceTestVolume 回调播放时的音量信息。

传入参数

返回值 方法调用结果

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

注意

• 该方法可在进房前和进房后调用，不可与其它音频设备测试功能同时应用。
• 调用 stopAudioPlaybackDeviceTest 可以停止测试。

stopAudioPlaybackDeviceTest

virtual int bytertc::IAudioDeviceManager::stopAudioPlaybackDeviceTest()

停止音频播放测试。

返回值 方法调用结果

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

注意 调用 startAudioPlaybackDeviceTest 后，调用本方法停止测试。

startAudioDeviceRecordTest

virtual int bytertc::IAudioDeviceManager::startAudioDeviceRecordTest(
    int indication_interval)

开始音频采集设备和音频播放设备测试。
建议提前调用 enableAudioPropertiesReport 启用音频信息提示，测试开始后，音频设备开始采集本地声音，可以通过 onLocalAudioPropertiesReport 获取采集音量。

传入参数

返回值 方法调用结果

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

注意

• 该方法在进房前后均可调用。且不可与其它音频设备测试功能同时应用。
• 调用本接口 30 s 后，采集自动停止，并开始播放采集到的声音。录音播放完毕后，设备测试流程自动结束。你也可以在 30 s 内调用 stopAudioDeviceRecordAndPlayTest 来停止采集并开始播放此前采集到的声音。
• 调用 stopAudioDevicePlayTest 可以停止音频设备采集和播放测试。
• 该方法仅在本地进行音频设备测试，不涉及网络连接。

stopAudioDeviceRecordAndPlayTest

virtual int bytertc::IAudioDeviceManager::stopAudioDeviceRecordAndPlayTest()

停止采集本地音频，并开始播放采集到的声音。录音播放完毕后，设备测试流程结束。
调用 startAudioDeviceRecordTest 30 s 内调用本接口来停止采集并开始播放此前采集到的声音。

返回值 方法调用结果

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

注意 调用本接口开始播放录音后，可以在播放过程中调用 stopAudioDevicePlayTest 停止播放。

stopAudioDevicePlayTest

virtual int bytertc::IAudioDeviceManager::stopAudioDevicePlayTest()

停止由调用 startAudioDeviceRecordTest 开始的音频播放设备测试。
在音频播放设备测试自动结束前，可调用本接口停止音频采集与播放测试。

返回值 方法调用结果

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

IAudioMixingManager

class bytertc::IAudioMixingManager

混音管理类

成员函数

函数说明

startAudioMixing

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

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

传入参数

注意

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

stopAudioMixing

virtual void bytertc::IAudioMixingManager::stopAudioMixing(
    int mix_id)

停止播放音乐文件及混音

传入参数

注意

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

pauseAudioMixing

virtual void bytertc::IAudioMixingManager::pauseAudioMixing(
    int mix_id)

暂停播放音乐文件及混音

传入参数

注意

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

resumeAudioMixing

virtual void bytertc::IAudioMixingManager::resumeAudioMixing(
    int mix_id)

恢复播放音乐文件及混音

传入参数

注意

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

preloadAudioMixing

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

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

传入参数

注意

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

unloadAudioMixing

virtual void bytertc::IAudioMixingManager::unloadAudioMixing(
    int mix_id)

卸载指定音乐文件

传入参数

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

getAudioMixingCurrentPosition

virtual int bytertc::IAudioMixingManager::getAudioMixingCurrentPosition(
    int mix_id)

获取音乐文件播放进度

传入参数

返回值

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

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

setAudioMixingPlaybackSpeed

virtual int bytertc::IAudioMixingManager::setAudioMixingPlaybackSpeed(
    int mix_id,
    int speed)

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

传入参数

注意

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

IVideoDeviceCollection

class bytertc::IVideoDeviceCollection

视频设备相关的信息

成员函数

函数说明

getCount

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

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

返回值 视频设备数量

getDevice

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

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

传入参数

返回值

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

release

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

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

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

getDevice

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

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

传入参数

返回值

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

IVideoDeviceManager

class bytertc::IVideoDeviceManager

主要用于枚举、设置视频采集设备

成员函数

函数说明

enumerateVideoCaptureDevices

virtual IVideoDeviceCollection* bytertc::IVideoDeviceManager::enumerateVideoCaptureDevices()

获取当前系统内视频采集设备列表。

返回值 包含系统中所有视频采集设备的列表，参看 IVideoDeviceCollection。

setVideoCaptureDevice

virtual int bytertc::IVideoDeviceManager::setVideoCaptureDevice(
    const char device_id[MAX_DEVICE_ID_LENGTH])

设置当前视频采集设备

传入参数

返回值

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

getVideoCaptureDevice

virtual int bytertc::IVideoDeviceManager::getVideoCaptureDevice(
    char device_id[MAX_DEVICE_ID_LENGTH])

获取当前 SDK 正在使用的视频采集设备信息

传入参数

返回值

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

IVideoEffect

class bytertc::IVideoEffect

视频特效接口

成员函数

函数说明

checkLicense

virtual int bytertc::IVideoEffect::checkLicense(
    void* androidContext,
    void* jnienv,
    const char* licensePath)

视频特效许可证检查

传入参数

返回值

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

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

getAuthMessage

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

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

传入参数

返回值

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

注意

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

freeAuthMessage

virtual int bytertc::IVideoEffect::freeAuthMessage(
    char * pmsg)

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

传入参数

返回值

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

enableEffect

virtual int bytertc::IVideoEffect::enableEffect(
    bool enabled)

开启关闭视频特效

传入参数

返回值

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

注意 在调用CheckLicensecheckLicense和SetAlgoModelPathsetAlgoModelPath后调用此方法

setAlgoModelPath

virtual void bytertc::IVideoEffect::setAlgoModelPath(
    const char* modelPath)

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

传入参数

setEffectNodes

virtual int bytertc::IVideoEffect::setEffectNodes(
    const char** effectNodePaths,
    int nodeNum)

设置视频特效素材包

传入参数

返回值

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

updateNode

virtual int bytertc::IVideoEffect::updateNode(
    const char* nodePath,
    const char* nodeKey,
    float nodeValue)

设置特效强度

传入参数

返回值

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

setColorFilter

virtual int bytertc::IVideoEffect::setColorFilter(
    const char* resPath)

设置颜色滤镜

传入参数

返回值

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

setColorFilterIntensity

virtual int bytertc::IVideoEffect::setColorFilterIntensity(
    float intensity)

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

传入参数

返回值

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

registerFaceDetectionObserver

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

注册人脸检测结果回调观察者
注册此观察者后，你会周期性收到 onFaceDetectResult 回调。

传入参数

返回值

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

IVideoProcessor

class bytertc::IVideoProcessor

成员函数

函数说明

processVideoFrame

virtual IVideoFrame* bytertc::IVideoProcessor::processVideoFrame(
    IVideoFrame* src_frame)

获取 RTC SDK 采集得到的视频帧，根据 registerLocalVideoProcessor 设置的视频前处理器，进行视频前处理，最终将处理后的视频帧给到 RTC SDK 用于编码传输。

传入参数

返回值 经过视频前处理后的视频帧，返回给 RTC SDK 供编码和传输，参看 IVideoFrame。

注意

• 在进行视频前处理前，你需要调用 registerLocalVideoProcessor 设置视频前处理器。
• 如果需要取消视频前处理，可以将视频前处理器设置为 nullptr。