public interface com.ss.bytertc.engine.IRTCAudioDeviceManager
java

IRTCAudioDeviceManager 接口

public abstract int com.ss.bytertc.engine.IRTCAudioDeviceManager.startAudioPlaybackDeviceTest(
    String testAudioFilePath,
    int interval)
java

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

传入参数

返回值
方法调用结果

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

注意

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

public abstract int com.ss.bytertc.engine.IRTCAudioDeviceManager.stopAudioPlaybackDeviceTest()
java

停止音频播放测试。

返回值
方法调用结果

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

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

public abstract int com.ss.bytertc.engine.IRTCAudioDeviceManager.startAudioDeviceRecordTest(
    int interval)
java

开始音频采集设备和音频播放设备测试。

传入参数

返回值
方法调用结果

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

注意

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

public abstract int com.ss.bytertc.engine.IRTCAudioDeviceManager.stopAudioDeviceRecordAndPlayTest()
java

停止采集本地音频，并开始播放采集到的声音。录音播放完毕后，设备测试流程结束。

调用 startAudioDeviceRecordTest 30 s 内调用本接口来停止采集并开始播放此前采集到的声音。

返回值
方法调用结果

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

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

public abstract int com.ss.bytertc.engine.IRTCAudioDeviceManager.stopAudioDevicePlayTest()
java

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

返回值
方法调用结果

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

public abstract class com.ss.bytertc.engine.RTCRoom
java

public abstract void com.ss.bytertc.engine.RTCRoom.destroy()
java

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

public abstract int com.ss.bytertc.engine.RTCRoom.joinRoom(
    String token,
    UserInfo userInfo,
    RTCRoomConfig roomConfig)
java

加入房间。

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

传入参数

返回值

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

注意

• 同一个 App ID 的同一个房间内，每个用户的用户 ID 必须是唯一的。如果两个用户的用户 ID 相同，则后进房的用户会将先进房的用户踢出房间，并且先进房的用户会收到 onRoomStateChanged 回调通知，错误类型详见 ERROR_CODE_DUPLICATE_LOGIN。
• 本地用户调用此方法加入房间成功后，会收到 onRoomStateChanged 回调通知。若本地用户同时为可见用户，加入房间时远端用户会收到 onUserJoined 回调通知。
• 房间内不可见用户的容量远远大于可见用户，而且用户默认可见，因此对于不参与互动的用户，你需要调用setUserVisibility 更改为不可见用户。从而避免因房间内用户达到数量上限所导致的进房失败。通常情况下，一个 RTC 房间最多同时容纳 50 名可见用户，其中最多 30 人可同时上麦。更多信息参看用户和媒体流上限。
• 用户加入房间成功后，在本地网络状况不佳的情况下，SDK 可能会与服务器失去连接，并触发 onConnectionStateChanged 回调。此时 SDK 会自动重试，直到成功重连。重连成功后，本地会收到 onRoomStateChanged 回调通知；如果加入房间的用户是可见用户，远端用户会收到 onUserJoined 回调通知。

public abstract int com.ss.bytertc.engine.RTCRoom.setRTCRoomEventHandler(
    IRTCRoomEventHandler rtcRoomEventHandler)
java

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

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCRoom.leaveRoom()
java

离开房间。

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

此方法是异步操作，调用返回时并没有真正退出房间。真正退出房间后，本地会收到 onLeaveRoom 回调通知。

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.setUserVisibility(
    boolean enable)
java

设置用户可见性。未调用该接口前，本地用户默认对他人可见。
默认情况下，一个 RTC 房间最多同时容纳 50 名可见用户，最多 30 人可同时上麦。更多信息参看用户和媒体流上限。

传入参数

返回值

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

注意

• 在加入房间前后，用户均可调用此方法设置用户可见性。
• 设置用户可见性，会收到设置成功/失败回调 onUserVisibilityChanged。（v3.54 新增）
  • 在加入房间前设置用户可见性，若设置的可见性与默认值不同，将在加入房间时触发本回调。
  • 在加入房间后设置用户可见性，若可见性前后不同，会触发本回调。
  • 在断网重连后，若可见性发生改变，会触发本回调。
• 在房间内，调用此方法成功切换用户可见性后，房间内其他用户会收到相应的回调。
  • 从可见换至不可见时，房间内其他用户会收到 onUserLeave。
  • 从不可见切换至可见时，房间内其他用户会收到 onUserJoined。
  • 若调用该方法将可见性设为 false，此时尝试发布流会收到 WARNING_CODE_PUBLISH_STREAM_FORBIDEN 警告。

public abstract int com.ss.bytertc.engine.RTCRoom.updateToken(
    String token)
java

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

传入参数

返回值
方法调用结果：

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

注意

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

public abstract long com.ss.bytertc.engine.RTCRoom.sendUserMessage(
    String userId,
    String messageStr,
    MessageConfig config)
java

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

传入参数

返回值

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

注意

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

public abstract long com.ss.bytertc.engine.RTCRoom.sendUserBinaryMessage(
    String userId,
    byte[] buffer,
    MessageConfig config)
java

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

传入参数

注意

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

public abstract long com.ss.bytertc.engine.RTCRoom.sendRoomMessage(
    String messageStr)
java

给房间内的所有其他用户群发文本消息。

传入参数

注意

• 在房间内广播文本消息前，必须先调用 joinRoom 加入房间。
• 调用后，会收到 onRoomMessageSendResult 回调；
• 同一房间内的其他用户会收到 onRoomMessageReceived 回调。

public abstract long com.ss.bytertc.engine.RTCRoom.sendRoomBinaryMessage(
    byte[] buffer)
java

给房间内的所有其他用户群发二进制消息。

传入参数

注意

• 在房间内广播二进制消息前，必须先调用 joinRoom 加入房间。
• 调用后，会收到 onRoomMessageSendResult 回调；
• 同一房间内的其他用户会收到 onRoomBinaryMessageReceived 回调。

public abstract int com.ss.bytertc.engine.RTCRoom.setMultiDeviceAVSync(
    String audioUserId)
java

设置发流端音画同步。

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.setRemoteVideoConfig(
    String userId,
    RemoteVideoConfig remoteVideoConfig)
java

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

传入参数

返回值
方法调用结果：

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.publishStream(
    MediaStreamType type)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.unpublishStream(
    MediaStreamType type)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.publishScreen(
    MediaStreamType type)
java

在当前所在房间内发布本地屏幕共享音视频流

传入参数

返回值

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

注意

• 即使你已经在用户进房时通过调用 joinRoom 成功选择了自动发布，也需要调用本接口发布屏幕流。
• 调用 setUserVisibility 方法将自身设置为不可见后无法调用该方法，需将自身切换至可见后方可调用该方法发布屏幕流。
• 调用该方法后，房间中的所有远端用户会收到 onUserPublishScreen 回调，其中成功收到音频流的远端用户会收到 onFirstRemoteAudioFrame 回调，订阅了视频流的远端用户会收到 onFirstRemoteVideoFrameDecoded 回调。
• 调用该方法后，本地用户会收到 onScreenVideoFrameSendStateChanged。
• 如果你需要向多个房间发布流，调用 startForwardStreamToRooms。
• 调用 unpublishScreen 取消发布。
• 查看 Android 端屏幕共享，获取更多信息。

public abstract int com.ss.bytertc.engine.RTCRoom.unpublishScreen(
    MediaStreamType type)
java

停止将本地屏幕共享音视频流发布到当前所在房间中

传入参数

返回值

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

注意

• 调用 publishScreen 发布屏幕流后，你需调用此接口停止发布。
• 调用此方法停止发布屏幕音视频流后，房间中的其他用户将会收到 onUserUnpublishScreen 回调。

public abstract int com.ss.bytertc.engine.RTCRoom.subscribeUserStream(
    String uid,
    StreamIndex streamType,
    SubscribeMediaType mediaType,
    SubscribeVideoConfig subscribeVideoConfig)
java

Deprecated since 3.36 and will be deleted in 3.51, use subscribeStream, unsubscribeStream, subscribeScreen and unsubscribeScreen instead.

订阅房间内指定的远端音视频流。

无论自动订阅还是手动订阅模式，用户都可以调用此方法按需订阅房间中的音视频流。

该方法也可用于更新已经订阅的流的属性、媒体类型等配置。

传入参数

注意

• 你必须通过 onStreamAdd 和 onStreamRemove 两个回调获取当前房间里的音视频流信息，并调用本方法按需订阅流或修改订阅配置。
• 若订阅失败，你会收到 onStreamStateChanged 回调通知，具体失败原因参看 ErrorCode。
• 若调用 pauseAllSubscribedStream 暂停接收远端音视频流，此时仍可使用该方法对暂停接收的流进行设置，你会在调用 resumeAllSubscribedStream 恢复接收流后收到修改设置后的流。

public abstract int com.ss.bytertc.engine.RTCRoom.subscribeStream(
    String uid,
    MediaStreamType type)
java

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

传入参数

返回值
方法调用结果：

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.subscribeAllStreams(
    MediaStreamType type)
java

订阅房间内所有通过摄像头/麦克风采集的媒体流，或更新订阅选项。

传入参数

返回值

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

注意

• 多次调用订阅接口时，将根据末次调用接口和传入的参数，更新订阅配置。
• 开启音频选路后，如果房间内的媒体流超过上限，建议通过调用 subscribeStream 逐一指定需要订阅的媒体流。
• 调用该方法后，你会收到 onStreamSubscribed 通知方法调用结果。
• 成功订阅远端用户的媒体流后，订阅关系将持续到调用 unsubscribeStream 取消订阅或本端用户退房。
• 关于其他调用异常，你会收到 onStreamStateChanged 回调通知，具体异常原因参看 ErrorCode。

public abstract int com.ss.bytertc.engine.RTCRoom.unsubscribeStream(
    String uid,
    MediaStreamType type)
java

取消订阅房间内指定的通过摄像头/麦克风采集的媒体流。

该方法对自动订阅和手动订阅模式均适用。

传入参数

返回值
方法调用结果：

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.unsubscribeAllStreams(
    MediaStreamType type)
java

取消订阅房间内所有的通过摄像头/麦克风采集的媒体流。

自动订阅和手动订阅的流都可以通过本方法取消订阅。

传入参数

返回值
方法调用结果：

• 0：成功
• !0：失败

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.subscribeScreen(
    String uid,
    MediaStreamType type)
java

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

传入参数

返回值
方法调用结果：

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.unsubscribeScreen(
    String uid,
    MediaStreamType type)
java

取消订阅房间内指定的远端屏幕共享音视频流。

该方法对自动订阅和手动订阅模式均适用。

传入参数

返回值
方法调用结果：

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.pauseAllSubscribedStream(
    PauseResumeControlMediaType mediaType)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.resumeAllSubscribedStream(
    PauseResumeControlMediaType mediaType)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.startForwardStreamToRooms(
    List<ForwardStreamInfo> forwardStreamInfos)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.updateForwardStreamToRooms(
    List<ForwardStreamInfo> forwardStreamInfos)
java

更新跨房间媒体流转发信息。

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.stopForwardStreamToRooms()
java

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

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCRoom.pauseForwardStreamToAllRooms()
java

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

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCRoom.resumeForwardStreamToAllRooms()
java

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

返回值

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

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

public abstract IRangeAudio com.ss.bytertc.engine.RTCRoom.getRangeAudio()
java

获取范围语音接口实例。

返回值
方法调用结果：

• IRangeAudio：成功，返回一个 IRangeAudio 实例。
• null：失败，当前 SDK 不支持范围语音功能。

注意
首次调用该方法须在创建房间后、加入房间前。范围语音相关 API 和调用时序详见范围语音。

public abstract ISpatialAudio com.ss.bytertc.engine.RTCRoom.getSpatialAudio()
java

获取空间音频接口实例。

返回值
空间音频管理接口实例。如果返回 NULL，则表示不支持空间音频，详见 ISpatialAudio 。

注意

• 首次调用该方法须在创建房间后、加入房间前。空间音频相关 API 和调用时序详见空间音频。
• 只有在使用支持真双声道播放的设备时，才能开启空间音频效果；
• 在网络状况不佳的情况下，即使开启了这一功能，也不会产生空间音频效果；
• 机型性能不足可能会导致音频卡顿，使用低端机时，不建议开启空间音频效果；
• 空间音频效果在启用服务端选路功能时，不生效。

public abstract int com.ss.bytertc.engine.RTCRoom.setRemoteRoomAudioPlaybackVolume(
    int volume)
java

调节某个房间内所有远端用户的音频播放音量。

传入参数

返回值

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

注意
假设某远端用户 A 始终在被调节的目标用户范围内，+ 当该方法与 setRemoteAudioPlaybackVolume 共同使用时，本地收听用户 A 的音量为后调用的方法设置的音量；

• 当该方法与 setPlaybackVolume 方法共同使用时，本地收听用户 A 的音量将为两次设置的音量效果的叠加。

public abstract int com.ss.bytertc.engine.RTCRoom.setAudioSelectionConfig(
    AudioSelectionPriority audioSelectionPriority)
java

Available since 3.52

设置本端发布流在音频选路中的优先级。

传入参数

注意
在控制台上为本 appId 开启音频选路后，调用本接口才会生效。进房前后调用均可生效。更多信息参见音频选路。
如果本端用户同时加入不同房间，使用本接口进行的设置相互独立。

public abstract long com.ss.bytertc.engine.RTCRoom.setRoomExtraInfo(
    String key,
    String value)
java

Available since 3.52

设置/更新房间附加信息，可用于标识房间状态或属性，或灵活实现各种业务逻辑。

传入参数

返回值

• 0: 方法调用成功，返回本次调用的任务编号；
• <0: 方法调用失败，具体原因详见 SetRoomExtraInfoResult。

注意

• 在设置房间附加信息前，必须先调用 joinRoom 加入房间。
• 调用该方法后，会收到一次 onSetRoomExtraInfoResult 回调，提示设置结果。
• 调用该方法成功设置附加信息后，同一房间内的其他用户会收到关于该信息的回调 onRoomExtraInfoUpdate。
• 新进房的用户会收到进房前房间内已有的全部附加信息通知。

public abstract int com.ss.bytertc.engine.RTCRoom.startSubtitle(
    SubtitleConfig subtitleConfig)
java

Available since 3.52

识别或翻译房间内所有用户的语音，形成字幕。

语音识别或翻译的结果会通过 onSubtitleMessageReceived 事件回调给你。

调用该方法后，你会收到 onSubtitleStateChanged 回调，通知字幕是否开启。

传入参数

返回值

• 0: 调用成功。
• !0: 调用失败。

注意

• 使用字幕功能前，你需要在 RTC 控制台 开启实时字幕功能。
• 如果你需要使用流式语音识别模式，你应在 语音技术控制台 创建流式语音识别应用。创建时，服务类型应选择 流式语音识别，而非 音视频字幕生成。创建后，在 RTC 控制台 上启动流式语音识别，并填写创建语音技术应用时获取的相关信息，包括：APP ID，Access Token，和 Cluster ID。
• 如果你需要使用实时语音翻译模式，你应开通机器翻译服务，参考 开通服务。完成开通后，在 RTC 控制台 上启用实时语音翻译模式。
• 此方法需要在进房后调用。
• 如需指定源语言，你需要在调用 joinRoom 接口进房时，通过 extraInfo 参数传入 "source_language": "zh" JSON 字符串，设置源语言为中文；传入 "source_language": "en"JSON 字符串，设置源语言为英文；传入 "source_language": "ja" JSON 字符串，设置源语言为日文。如未指定源语言，SDK 会将系统语种设定为源语言。如果你的系统语种不是中文、英文和日文，此时 SDK 会自动将中文设为源语言。

public abstract int com.ss.bytertc.engine.RTCRoom.stopSubtitle()
java

Available since 3.52

关闭字幕。

调用该方法后，用户会收到 onSubtitleStateChanged 回调，通知字幕是否关闭。

返回值

• 0: 调用成功。
• !0: 调用失败。

public abstract String com.ss.bytertc.engine.RTCRoom.getRoomId()
java

Available since 3.53

获取房间 ID。

返回值
房间 ID。

public abstract class com.ss.bytertc.engine.RTCVideo
java

RTCVideo Class

public static synchronized RTCVideo com.ss.bytertc.engine.RTCVideo.createRTCVideo(
    Context context,
    String appId,
    IRTCVideoEventHandler handler,
    Object eglContext,
    JSONObject parameters)
java

创建引擎对象

如果当前进程中未创建引擎实例，那么你必须先使用此方法，以使用 RTC 提供的各种音视频能力。

如果当前进程中已创建了引擎实例，再次调用此方法时，会返回已创建的引擎实例。

传入参数

返回值

• RTCVideo：创建成功。返回一个可用的 RTCVideo 实例
• Null：.so 文件加载失败，创建失败。

注意
你应注意保持 handler 的生命周期必须大于 RTCVideo 的生命周期，即 handler 必须在调用 destroyRTCVideo 之后销毁。

public static synchronized void com.ss.bytertc.engine.RTCVideo.destroyRTCVideo()
java

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

注意

• 请确保和需要销毁的 RTCVideo 实例相关的业务场景全部结束后，才调用此方法
• 该方法在调用之后，会销毁所有和此 RTCVideo 实例相关的内存，并且停止与媒体服务器的任何交互
• 调用本方法会启动 SDK 退出逻辑。引擎线程会保留，直到退出逻辑完成。因此，不要在回调线程中直接调用此 API，会导致死锁。同时此方法是耗时操作，不建议在主线程调用本方法，避免主线程阻塞。

public static String com.ss.bytertc.engine.RTCVideo.getSDKVersion()
java

获取 SDK 当前的版本号。

返回值
SDK 当前的版本号。

public static int com.ss.bytertc.engine.RTCVideo.setLogConfig(
    RTCLogConfig logConfig)
java

配置 SDK 本地日志参数，包括日志级别、存储路径、日志文件最大占用的总空间。

传入参数

返回值

• 0：成功。
• –1：失败，本方法必须在创建引擎前调用。
• –2：失败，参数填写错误。

注意
本方法必须在调用 createRTCVideo 之前调用。

public static String com.ss.bytertc.engine.RTCVideo.getErrorDescription(
    int code)
java

获取 SDK 内各种错误码、警告码的描述文字。

传入参数

返回值
String 描述文字

public static int com.ss.bytertc.engine.RTCVideo.setDeviceId(
    String deviceId)
java

Deprecated since 3.45 and will be deleted in 3.51.

设置设备 ID 。

传入参数

返回值

• 0： 成功。
• < 0： 失败。
• -1： deviceId 为空。

public static int com.ss.bytertc.engine.RTCVideo.setEnv(
    RTCEngine.Env env)
java

Deprecated since 3.45 and will be deleted in 3.51.

设置 SDK 当前使用的服务器环境。

传入参数

返回值

• 0： 成功。
• < 0： 失败。
• -1： native library 未加载。

注意

• 本函数是可选函数，默认使用正式环境。
• 本函数必须在创建引擎前调用。

public abstract int com.ss.bytertc.engine.RTCVideo.setInternalEventHandler(
    IRTCEngineInternalEventHandler handler)
java

Deprecated since 3.45 and will be deleted in 3.51.

设置内部事件回调 Handler

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.setRtcVideoEventHandler(
    IRTCVideoEventHandler engineEventHandler)
java

设置引擎事件回调的接收类，必须继承自 IRTCVideoEventHandler 。

传入参数

返回值

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

注意

• 调用方需要自行实现一个继承自 IRTCVideoEventHandler 的类，并重载其中需要关注的事件。
• 该回调为异步回调
• 所有的事件回调均会在独立的回调线程内触发，请接收回调事件时注意所有与线程运行环境有关的操作，如需要在 UI 线程内执行的操作等，
  请勿直接在回调函数的实现中直接进行操作。

public abstract IRTCAudioDeviceManager com.ss.bytertc.engine.RTCVideo.getAudioDeviceManager()
java

获取音频设备管理接口

返回值
音频设备管理接口 IRTCAudioDeviceManager

public abstract int com.ss.bytertc.engine.RTCVideo.startVideoCapture()
java

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

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

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

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

返回值

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

注意

• 自 v3.37.0 版本，使用本接口需要在 Gradle 里引入 Kotlin。
• 调用 stopVideoCapture 可以停止内部视频采集。否则，只有当销毁引擎实例时，内部视频采集才会停止。
• 创建引擎后，无论是否发布视频数据，你都可以调用该方法开启内部视频采集。只有当（内部或外部）视频采集开始以后视频流才会发布。
• 如果需要从自定义视频采集切换为内部视频采集，你必须先停止发布流，关闭自定义采集，再调用此方法手动开启内部采集。
• 内部视频采集使用的摄像头由 switchCamera 接口指定。
• 你还可以联系技术支持人员，帮助你在服务端配置采集格式并下发到 Android 端。

public abstract int com.ss.bytertc.engine.RTCVideo.stopVideoCapture()
java

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

内部视频采集指：使用 RTC SDK 内置视频采集模块，进行采集。
调用该方法，本地用户会收到 onVideoDeviceStateChanged 的回调。

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

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.startAudioCapture()
java

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

内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。
调用该方法开启后，本地用户会收到 onAudioDeviceStateChanged 的回调。

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

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.stopAudioCapture()
java

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

内部采集是指：使用 RTC SDK 内置的音频采集机制进行音频采集。
调用该方法，本地用户会收到 onAudioDeviceStateChanged 的回调。

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

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setAudioScenario(
    AudioScenarioType audioScenario)
java

设置音频场景类型。
你可以根据你的应用所在场景，选择合适的音频场景类型。
选择音频场景后，SDK 会自动根据客户端音频采集播放设备和状态，适用通话音量/媒体音量。

传入参数

返回值

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

注意

• 建议在加入房间和调用音频相关接口之前，调用此接口设置音频场景类型。如果在此之后调用此接口，可能会引入音频卡顿。
• 通话音量更适合通话、会议等对信息准确度更高的场景。通话音量会激活系统硬件信号处理，使通话声音更清晰。同时，音量无法降低到 0。
• 媒体音量更适合娱乐场景，因其声音的表现力会更强。媒体音量下，最低音量可以为 0。

public abstract int com.ss.bytertc.engine.RTCVideo.setAudioProfile(
    AudioProfileType audioProfile)
java

设置音质档位。

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setAnsMode(
    AnsMode ansMode)
java

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

传入参数

返回值

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

注意
该接口进房前后均可调用，可重复调用，仅最后一次调用生效。

public abstract int com.ss.bytertc.engine.RTCVideo.setVoiceChangerType(
    VoiceChangerType voiceChanger)
java

Available since 3.32

设置变声特效类型

传入参数

返回值
方法调用结果：

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

注意

• 在进房前后都可设置。
• 对 RTC SDK 内部采集的音频和自定义采集的音频都生效。
• 只对单声道音频生效。
• 与 setVoiceReverbType 互斥，后设置的特效会覆盖先设置的特效。

public abstract int com.ss.bytertc.engine.RTCVideo.setVoiceReverbType(
    VoiceReverbType voiceReverb)
java

Available since 3.32

设置混响特效类型

传入参数

返回值
方法调用结果：

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

注意

• 在进房前后都可设置。
• 对 RTC SDK 内部采集的音频和自定义采集的音频都生效。
• 只对单声道音频生效。
• 与 setVoiceChangerType 互斥，后设置的特效会覆盖先设置的特效。

public abstract int com.ss.bytertc.engine.RTCVideo.setLocalVoiceEqualization(
    VoiceEqualizationConfig voiceEqualizationConfig)
java

设置本地采集语音的均衡效果。包含内部采集和外部采集，但不包含混音音频文件。

传入参数

返回值

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

注意
根据奈奎斯特采样率，音频采样率必须大于等于设置的中心频率的两倍，否则，设置不生效。

public abstract int com.ss.bytertc.engine.RTCVideo.setLocalVoiceReverbParam(
    VoiceReverbConfig config)
java

设置本地采集音频的混响效果。包含内部采集和外部采集，但不包含混音音频文件。

传入参数

返回值

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

注意
调用 enableLocalVoiceReverb 开启混响效果。

public abstract int com.ss.bytertc.engine.RTCVideo.enableLocalVoiceReverb(
    boolean enable)
java

开启本地音效混响效果

传入参数

返回值

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

注意
调用 setLocalVoiceReverbParam 设置混响效果。

public abstract int com.ss.bytertc.engine.RTCVideo.setLocalVideoCanvas(
    StreamIndex streamIndex,
    VideoCanvas videoCanvas)
java

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

传入参数

返回值

• 0: 成功
• -1: videoCanvas 为空

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.updateLocalVideoCanvas(
    StreamIndex streamIndex,
    int renderMode,
    int backgroundColor)
java

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.setLocalVideoSink(
    StreamIndex index,
    IVideoSink videoSink,
    @IVideoSink.PixelFormat int requiredFormat)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setRemoteVideoSink(
    RemoteStreamKey streamKey,
    IVideoSink videoSink,
    @IVideoSink.PixelFormat int requiredFormat)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.updateRemoteStreamVideoCanvas(
    RemoteStreamKey streamKey,
    int renderMode,
    int backgroundColor)
java

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.setRemoteVideoCanvas(
    RemoteStreamKey streamKey,
    VideoCanvas videoCanvas)
java

渲染来自指定远端用户的视频流时，设置使用的视图和渲染模式。

要解除绑定，将 videoCanvas 设置为空。

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.setRemoteVideoSuperResolution(
    RemoteStreamKey streamKey,
    VideoSuperResolutionMode mode)
java

Available since 3.54

设置远端视频超分模式。

传入参数

返回值

• 0: RETURN_STATUS_SUCCESS，SDK 调用成功，并不代表超分模式实际状态，需要根据回调 onRemoteVideoSuperResolutionModeChanged 判断实际状态。
• -1: RETURN_STATUS_NATIVE_IN_VALID，native library 未加载。
• -2: RETURN_STATUS_PARAMETER_ERR，参数非法，指针为空或字符串为空。
• -9: RETURN_STATUS_SCREEN_NOT_SUPPORT，不支持对屏幕流开启超分。

注意

• 该功能仅 arm 架构支持。
• 该方法须进房后调用。
• 远端用户视频流的原始分辨率不能超过 640 × 360 px。
• 支持对一路远端流开启超分，不支持对多路流开启超分。

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoDenoiser(
    VideoDenoiseMode mode)
java

Available since 3.54

设置视频降噪模式。

传入参数

返回值

• 0: API 调用成功。 用户可以根据回调函数 onVideoDenoiseModeChanged 判断视频降噪是否开启。
• < 0: API 调用失败。

注意
该功能仅 arm 架构支持。

public abstract int com.ss.bytertc.engine.RTCVideo.setLocalVideoMirrorType(
    MirrorType mirrorType)
java

为采集到的视频流开启镜像

传入参数

返回值

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

注意

• 切换视频源不影响镜像设置。
• 屏幕视频流始终不受镜像设置影响。
• 使用外部渲染器时，mirrorType 支持设置为 0（无镜像）和 3（本地预览和编码传输镜像），不支持设置为 1（本地预览镜像）。
• 该接口调用前，各视频源的初始状态如下：

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoRotationMode(
    VideoRotationMode rotationMode)
java

设置采集视频的旋转模式。默认以 App 方向为旋转参考系。

接收端渲染视频时，将按照和发送端相同的方式进行旋转。

传入参数

返回值

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

注意

• 旋转仅对内部视频采集生效，不适用于外部视频源和屏幕源。
• 调用该接口时已开启视频采集，将立即生效；调用该接口时未开启视频采集，则将在采集开启后生效。
• 更多信息请参考视频采集方向。

public abstract int com.ss.bytertc.engine.RTCVideo.switchCamera(
    CameraId cameraId)
java

切换视频内部采集时使用的前置/后置摄像头

调用此接口后，在本地会触发 onVideoDeviceStateChanged 回调。

传入参数

返回值

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

注意

• 默认使用前置摄像头。
• 如果你正在使用相机进行视频采集，切换操作当即生效；如果相机未启动，后续开启内部采集时，会打开设定的摄像头。

public abstract int com.ss.bytertc.engine.RTCVideo.replaceBackground(
    BackgroundMode mode,
    DivideModel divideModel)
java

Deprecated since 3.45 and will be deleted in 3.51.

视频图像分割，替换背景

传入参数

public abstract int com.ss.bytertc.engine.RTCVideo.setAudioPlaybackDevice(
    AudioPlaybackDevice audioPlaybackDevice)
java

Deprecated since 3.38 and will be deleted in 3.51, use setAudioRoute instead.

设置音频播放设备为扬声器或者听筒，默认使用扬声器。

音频播放设备发生变化时，会收到 onAudioPlaybackDeviceChanged 回调。

传入参数

返回值

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

注意

• 该方法适用于手机等移动设备。
• 听筒和扬声器为移动设备自带的音频播放设备。听筒一般用于通话，扬声器一般用于外放。
• 连接有线或者蓝牙音频播放设备后，音频路由将切换至有线耳机或者蓝牙耳机。不同音频场景中，音频路由和发布订阅状态到音量类型的映射关系详见 AudioScenarioType 。
• 进房前和进房后，均可调用此方法设置音频播放设备。

public abstract int com.ss.bytertc.engine.RTCVideo.setAudioRoute(
    AudioRoute audioRoute)
java

强制切换当前的音频播放路由。默认使用 setDefaultAudioRoute 中设置的音频路由。
音频播放路由发生变化时，会收到 onAudioRouteChanged 回调。

传入参数

返回值

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

注意

• 对于绝大多数音频场景，使用 setDefaultAudioRoute 设置默认音频路由，并借助 RTC SDK 的音频路由自动切换逻辑即可完成。切换逻辑参见移动端设置音频路由。你应仅在例外的场景下，使用此接口，比如在接入外接音频设备时，手动切换音频路由。
• 本接口仅支持在 AUDIO_SCENARIO_COMMUNICATION 音频场景下使用。你可以通过调用 setAudioScenario 切换音频场景。
• 不同音频场景中，音频路由和发布订阅状态到音量类型的映射关系详见 AudioScenarioType 。

public abstract AudioRoute com.ss.bytertc.engine.RTCVideo.getAudioRoute()
java

获取当前使用的音频播放路由。

返回值
详见 AudioRoute

注意
要设置音频路由，详见 setAudioRoute。

public abstract int com.ss.bytertc.engine.RTCVideo.setDefaultAudioRoute(
    AudioRoute route)
java

将默认的音频播放设备设置为听筒或扬声器。

传入参数

返回值

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

注意
对于音频路由切换逻辑，参见移动端设置音频路由。

public abstract int com.ss.bytertc.engine.RTCVideo.enableExternalSoundCard(
    boolean enable)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setCaptureVolume(
    StreamIndex index,
    int volume)
java

调节音频采集音量

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.setPlaybackVolume(
    int volume)
java

调节本地播放的所有远端用户混音后的音量。

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.setLocalVoicePitch(
    int pitch)
java

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

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

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.enableVocalInstrumentBalance(
    boolean enable)
java

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

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.enablePlaybackDucking(
    boolean enable)
java

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

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

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.login(
    String token,
    String uid)
java

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

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.logout()
java

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

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.updateLoginToken(
    String token)
java

更新用户用于登录的 Token

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

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setServerParams(
    String signature,
    String url)
java

设置应用服务器参数

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.getPeerOnlineStatus(
    String peerUserID)
java

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

传入参数

返回值

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

注意

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

public abstract long com.ss.bytertc.engine.RTCVideo.sendUserMessageOutsideRoom(
    String uid,
    String message,
    MessageConfig config)
java

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

传入参数

返回值

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

注意

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

public abstract long com.ss.bytertc.engine.RTCVideo.sendUserBinaryMessageOutsideRoom(
    String uid,
    byte[] buffer,
    MessageConfig config)
java

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

传入参数

返回值

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

注意

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

public abstract long com.ss.bytertc.engine.RTCVideo.sendServerMessage(
    String message)
java

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

传入参数

返回值

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

注意

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

public abstract long com.ss.bytertc.engine.RTCVideo.sendServerBinaryMessage(
    byte[] buffer)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.startNetworkDetection(
    boolean isTestUplink,
    int expectedUplinkBitrate,
    boolean isTestDownlink,
    int expectedDownlinkBitrate)
java

开启通话前网络探测

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.stopNetworkDetection()
java

停止通话前网络探测

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.enableAudioFrameCallback(
    AudioFrameCallbackMethod method,
    AudioFormat format)
java

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.disableAudioFrameCallback(
    AudioFrameCallbackMethod method)
java

关闭音频回调

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.registerAudioFrameObserver(
    IAudioFrameObserver observer)
java

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.registerLocalAudioProcessor(
    IAudioProcessor audioProcessor,
    AudioFormat audioFormat)
java

Deprecated since 3.42 and will be deleted in 3.51, use registerAudioProcessor instead.

设置自定义音频处理器。

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

SDK 只持有 processor 的弱引用，你应保证其生命周期。

传入参数

返回值

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

注意
重复调用此接口时，仅最后一次调用生效。效果不会叠加。

public abstract int com.ss.bytertc.engine.RTCVideo.registerAudioProcessor(
    IAudioFrameProcessor processor)
java

注册自定义音频处理器。

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.enableAudioProcessor(
    AudioProcessorMethod method,
    AudioFormat format)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.disableAudioProcessor(
    AudioProcessorMethod method)
java

关闭自定义音频处理。

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.registerLocalVideoProcessor(
    IVideoProcessor processor,
    VideoPreprocessorConfig config)
java

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

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

传入参数

返回值

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

注意
经前处理后，返回给 RTC SDK 的视频帧格式仅支持 I420 和 TEXTURE_2D。

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoDigitalZoomConfig(
    ZoomConfigType type,
    float size)
java

Available since 3.51

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoDigitalZoomControl(
    ZoomDirectionType direction)
java

Available since 3.51

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.startVideoDigitalZoomControl(
    ZoomDirectionType direction)
java

Available since 3.51

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.stopVideoDigitalZoomControl()
java

Available since 3.51

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

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.registerLocalEncodedVideoFrameObserver(
    ILocalEncodedVideoFrameObserver observer)
java

注册本地视频帧监测器。

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.registerRemoteEncodedVideoFrameObserver(
    IRemoteEncodedVideoFrameObserver observer)
java

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

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoSourceType(
    StreamIndex index,
    VideoSourceType type)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.pushExternalVideoFrame(
    VideoFrame frame)
java

推送外部视频帧。

传入参数

返回值
方法调用结果：

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

注意

• 该方法主动将视频帧数据用 VideoFrame 类封装后传递给 SDK。
• 请确保在你调用本方法前已调用 setVideoSourceType 设置为自定义视频采集。
• 当使用纹理数据时， 确保 createRTCVideo 中的 eglContext与 frame 中的 eglContext 为 sharedContext 或者相同，否则会无法编码。
• 支持的格式：Raw： I420, NV12, RGBA；纹理： Texture2D, TextureOES。

public abstract int com.ss.bytertc.engine.RTCVideo.startLiveTranscoding(
    String taskId,
    LiveTranscoding liveTranscode,
    ILiveTranscodingObserver observer)
java

Deprecated since 3.52, will be deleted in 3.58, use startPushMixedStreamToCDN instead.

新增转推直播任务，并设置合流的图片、视频视图布局和音频属性。

同一个任务中转推多路直播流时，SDK 会先将多路流合成一路流，然后再进行转推。

传入参数

返回值

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

注意

• 在调用该接口前，你需要在控制台开启转推直播功能。
• 调用该方法后，关于启动结果和推流过程中的错误，会收到 onStreamMixingEvent 回调。
• 调用 stopLiveTranscoding 停止转推直播。

public abstract int com.ss.bytertc.engine.RTCVideo.stopLiveTranscoding(
    String taskId)
java

Deprecated since 3.52, will be deleted in 3.58, use stopPushStreamToCDN instead.

停止转推直播，会收到 onStreamMixingEvent 回调。

关于启动转推直播，参看 startLiveTranscoding。

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.updateLiveTranscoding(
    String taskId,
    LiveTranscoding transcoding)
java

Deprecated since 3.52, will be deleted in 3.58, use updatePushMixedStreamToCDN instead.

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

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.startPushMixedStreamToCDN(
    String taskId,
    MixedStreamConfig mixedConfig,
    IMixedStreamObserver observer)
java

Available since 3.52

新增合流转推直播任务，并设置合流的图片、视频视图布局和音频属性。

同一个任务中转推多路直播流时，SDK 会先将多路流合成一路流，然后再进行转推。

传入参数

返回值
方法调用结果：

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

注意

• 在调用该接口前，你需要在控制台开启转推直播功能。
• 调用该方法后，关于启动结果和推流过程中的错误，会收到 onMixingEvent 回调。
• 调用 stopPushStreamToCDN 停止转推直播。

public abstract int com.ss.bytertc.engine.RTCVideo.updatePushMixedStreamToCDN(
    String taskId,
    MixedStreamConfig mixedConfig)
java

Available since 3.52

更新合流转推直播参数，会收到 onMixingEvent 回调。

使用 startPushMixedStreamToCDN 启用转推直播功能后，使用此方法更新功能配置参数。

传入参数

返回值
方法调用结果：

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

public abstract int com.ss.bytertc.engine.RTCVideo.startPushSingleStreamToCDN(
    String taskId,
    PushSingleStreamParam param,
    IPushSingleStreamToCDNObserver observer)
java

新增单流转推直播任务。

传入参数

返回值

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

注意

• 在调用该接口前，你需要在控制台开启转推直播功能。
• 调用该方法后，关于启动结果和推流过程中的错误，会收到 onStreamPushEvent 回调。
• 调用 stopPushStreamToCDN 停止任务。
• 由于本功能不进行编解码，所以推到 RTMP 的视频流会根据推流端的分辨率、编码方式、关闭摄像头等变化而变化。

public abstract int com.ss.bytertc.engine.RTCVideo.stopPushStreamToCDN(
    String taskId)
java

停止转推直播。

该方法可用于停止单流转推直播或停止合流转推直播，通过 taskId 区分需要停止的任务。

传入参数

返回值

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

注意

• 关于启动单流转推直播，参看 startPushSingleStreamToCDN。
• 关于启动合流转推直播，参看 startPushMixedStreamToCDN。

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoCaptureConfig(
    VideoCaptureConfig videoCaptureConfig)
java

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

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

传入参数

返回值

• 0: 成功
• < 0: 失败

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.enableSimulcastMode(
    boolean enabled)
java

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoEncoderConfig(
    List<VideoStreamDescription> videoStreamDescriptions,
    VideoEncoderConfiguration.OrientationMode orientationMode)
java

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

设置推送多路流时的各路视频参数，以及视频旋转角度。

传入参数

返回值

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

注意

• orientationMode 这个参数没有实现
• 该接口已废弃，请使用同名新接口代替；若仍需使用该旧接口，请注意无需先调用 enableSimulcastMode 开启推送多路流模式。

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoEncoderConfig(
    StreamIndex streamIndex,
    List<VideoStreamDescription> videoStreamDescriptions)
java

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

设置推送多路流时的各路视频参数，以及视频旋转角度。

传入参数

返回值

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

注意
该接口已经废弃，请使用同名新接口代替；若仍需使用该旧接口，请注意无需先调用 enableSimulcastMode 开启推送多路流模式。

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoEncoderConfig(
    VideoEncoderConfig maxSolution)
java

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

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

传入参数

返回值
方法调用结果：

• 0：成功
• !0：失败

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoEncoderConfig(
    VideoEncoderConfig[] channelSolutions)
java

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

传入参数

返回值
方法调用结果：

• 0：成功
• !0：失败

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setScreenVideoEncoderConfig(
    ScreenVideoEncoderConfig screenSolution)
java

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

传入参数

返回值

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.setAudioSourceType (
    AudioSourceType type)
java

切换音频采集方式

传入参数

返回值
方法调用结果：

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setAudioRenderType (
    AudioRenderType type)
java

切换音频渲染方式

传入参数

返回值
方法调用结果：

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.pushExternalAudioFrame(
    AudioFrame audioFrame)
java

推送自定义采集的音频数据到 RTC SDK。

传入参数

返回值
方法调用结果

• 0: 设置成功
• < 0: 设置失败

注意

• 推送自定义采集的音频数据前，必须先调用 setAudioSourceType 开启自定义采集。
• 你必须每隔 10 毫秒推送一次外部采集的音频数据。单次推送的 samples (音频采样点个数）应该为 audioFrame.sampleRate / 100。比如设置采样率为 48000 时， 每次应该推送 480 个采样点。
• 音频采样格式必须为 S16。音频缓冲区内的数据格式必须为 PCM，其容量大小应该为 audioFrame.samples × audioFrame.channel × 2。

public abstract int com.ss.bytertc.engine.RTCVideo.pullExternalAudioFrame(
    AudioFrame audioFrame)
java

拉取远端音频数据。

可用于自定义音频渲染。

传入参数

返回值
方法调用结果

• 0: 设置成功
• < 0: 设置失败

注意

• 拉取外部音频数据前，必须先调用 setAudioRenderType 启用自定义音频渲染。
• 由于 RTC SDK 的帧长为 10 毫秒，你应当每隔 10 毫秒拉取一次音频数据。确保音频采样点数（sample）x 拉取频率等于 audioFrame 的采样率 （sampleRate）。如设置采样率为 48000 时，每 10 毫秒调用本接口拉取数据，每次应拉取 480 个采样点。
• 音频采样格式为 S16。音频缓冲区内的数据格式为 PCM 数据，其容量大小为 audioFrame.samples × audioFrame.channel × 2。

public abstract int com.ss.bytertc.engine.RTCVideo.pushScreenVideoFrame(
    VideoFrame videoFrame)
java

推送屏幕视频帧

传入参数

返回值
方法调用结果：

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

public abstract int com.ss.bytertc.engine.RTCVideo.setOnDestroyCompletedCallback(
    Runnable callback)
java

Deprecated since 3.45 and will be deleted in 3.51.

设置引擎销毁后通知 App 的回调函数。

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.setRemoteAudioPlaybackVolume(
    String roomId,
    String uid,
    int volume)
java

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

传入参数

返回值
方法调用结果：

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

注意
假设某远端用户 A 始终在被调节的目标用户范围内，+ 当该方法与 setRemoteRoomAudioPlaybackVolume 共同使用时，本地收听用户 A 的音量为后调用的方法设置的音量；

• 当该方法与 setPlaybackVolume 方法共同使用时，本地收听用户 A 的音量将为两次设置的音量效果的叠加。

public abstract int com.ss.bytertc.engine.RTCVideo.setAudioAlignmentProperty(
    RemoteStreamKey streamKey,
    AudioAlignmentMode mode)
java

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

传入参数

返回值

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

注意

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

public abstract RTCRoom com.ss.bytertc.engine.RTCVideo.createRTCRoom(
    String roomId)
java

创建房间实例。
调用此方法仅返回一个房间实例，你仍需调用 joinRoom 才能真正地创建/加入房间。
多次调用此方法以创建多个 RTCRoom 实例。分别调用各 RTCRoom 实例中的 joinRoom 方法，同时加入多个房间。
多房间模式下，用户可以同时订阅各房间的音视频流。

传入参数

返回值
创建的 RTCRoom 房间实例。

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setPublishFallbackOption(
    PublishFallbackOption option)
java

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

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setSubscribeFallbackOption(
    SubscribeFallbackOptions option)
java

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

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setRemoteUserPriority(
    String roomid,
    String uid,
    RemoteUserPriority priority)
java

设置用户优先级。

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.sendSEIMessage(
    StreamIndex streamIndex,
    byte[] message,
    int repeatCount)
java

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 数据。

public abstract int com.ss.bytertc.engine.RTCVideo.sendSEIMessage(
    StreamIndex streamIndex,
    byte[] message,
    int repeatCount,
    SEICountPerFrame mode)
java

通过视频帧发送 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 数据。

public abstract int com.ss.bytertc.engine.RTCVideo.setBusinessId(
    String businessId)
java

设置业务标识参数

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

传入参数

返回值

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

注意

• 需要在进房前调用，进房后调用该方法无效。

public abstract int com.ss.bytertc.engine.RTCVideo.setEncryptInfo(
    int aesType,
    String key)
java

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

传入参数

返回值

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

注意

• 该方法与 setCustomizeEncryptHandler 为互斥关系，即按照调用顺序，最后一个调用的方法为最终生效的版本。
• 该方法必须在调用 joinRoom 之前调用，可重复调用，以最后调用的参数作为生效参数

public abstract int com.ss.bytertc.engine.RTCVideo.setCustomizeEncryptHandler(
    RTCEncryptHandler handler)
java

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

传入参数

返回值

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

注意

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

public abstract IVideoEffect com.ss.bytertc.engine.RTCVideo.getVideoEffectInterface()
java

获取视频特效接口。

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

public abstract int com.ss.bytertc.engine.RTCVideo.checkVideoEffectLicense(
    Context context,
    String licenseFile)
java

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

视频特效许可证检查

传入参数

返回值

• 0: 许可证验证成功
• 1000: 未集成特效 SDK。
• 1001: 特效 SDK 不支持该功能。
• <0: 其他错误，具体参看错误码表

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

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoEffectAlgoModelPath(
    String modelPath)
java

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

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

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.enableVideoEffect(
    boolean enable)
java

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

创建/销毁视频特效引擎

传入参数

返回值

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

注意

• 该方法须在调用 checkVideoEffectLicense 和 setVideoEffectAlgoModelPath 后调用。
• 该方法不直接开启/关闭视频特效，你须在调用该方法后，调用 setVideoEffectNodes 开启视频特效。
• 通用场景下，特效引擎会随 RTC 引擎销毁而销毁。当你对性能有较高要求时，可在不使用特效相关功能时调用该方法中 false 单独销毁特效引擎。

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoEffectNodes(
    List<String> effectNodes)
java

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

设置视频特效素材包

传入参数

返回值

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

注意
你须在调用 enableVideoEffect 后调用该方法。

public abstract int com.ss.bytertc.engine.RTCVideo.updateVideoEffectNode(
    String effectNode,
    String key,
    float value)
java

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

设置特效强度

传入参数

返回值

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

注意
该接口仅适用于同时含有上述三个参数的特效资源，对于如大部分贴纸类等没有强度参数的特效，该接口调用无效。

public abstract int com.ss.bytertc.engine.RTCVideo.setBackgroundSticker(
    String modelPath,
    VirtualBackgroundSource source)
java

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

将摄像头采集画面中的人像背景替换为指定图片或纯色背景。
若要取消背景特效，将背景贴纸特效素材路径设置为null。

传入参数

返回值

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

注意
调用此接口前需依次调用以下接口：1、检查视频特效许可证 checkVideoEffectLicense；2、设置视频特效算法模型路径 setVideoEffectAlgoModelPath；3、开启视频特效 enableVideoEffect。

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoEffectColorFilter(
    String resFile)
java

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

设置颜色滤镜

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.setVideoEffectColorFilterIntensity(
    float intensity)
java

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

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

传入参数

返回值

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

public abstract int com.ss.bytertc.engine.RTCVideo.registerFaceDetectionObserver(
    IFaceDetectionObserver observer,
    int interval)
java

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

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

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

传入参数

返回值

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