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 是否重复，均触发此返回值。
• -3：room 为空。

注意

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

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

通过设置房间事件 handler，监听此对象对应的回调事件。

传入参数

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

离开房间。

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

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

注意

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

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

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

传入参数

注意

• 在加入房间前后，用户均可调用此方法设置用户可见性。
• 在房间内，调用此方法成功切换用户可见性后，房间内其他用户会收到相应的回调通知：

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

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

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

更新 Token。
在 Token 进房权限过期前 30 秒，会收到 onTokenWillExpire 回调，此时需要重新获取 Token，并调用此方法更新 Token，否则用户将因为 Token 过期被移出房间。

传入参数

注意
请勿同时调用 updateToken 和 joinRoom 方法更新 Token。若因 Token 过期或无效导致加入房间失败或已被移出房间，你应该在获取新的有效 Token 后调用 joinRoom 重新加入房间。

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

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

传入参数

返回值

• >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

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

传入参数

注意

• 在发送房间内二进制消息前，必须先调用 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：失败

注意

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

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

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

传入参数

注意

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

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

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

传入参数

返回值

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 void com.ss.bytertc.engine.RTCRoom.stopForwardStreamToRooms()
java

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

注意

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

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

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

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

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

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

注意
目标房间中的用户将接收到本地用户进房 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

获取空间音频接口实例。 空间音频相关 API 和调用时序详见空间音频。

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

注意

• 只有在使用支持真双声道播放的设备时，才能开启空间音频效果；
• 在网络状况不佳的情况下，即使开启了这一功能，也不会产生空间音频效果；
• 机型性能不足可能会导致音频卡顿，使用低端机时，不建议开启空间音频效果；
• 空间音频效果在启用服务端选路功能时，不生效。

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 必须在调用 createRTCVideo 之前创建，在调用 destroyRTCVideo 之后销毁。
• 通常不建议在移动端设备上创建多于 2 个引擎实例。

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 String com.ss.bytertc.engine.RTCVideo.getErrorDescription(
    int code)
java

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

传入参数

返回值
String 描述文字

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

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

传入参数

注意

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

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

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

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

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

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

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

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

注意

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

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

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

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

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

注意

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

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

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

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

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

注意

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

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

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

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

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

注意

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

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

设置音频场景类型

传入参数

注意
该方法在进房前后均可调用。

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

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

传入参数

注意

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

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

设置变声特效类型

传入参数

注意

• 在进房前后都可设置。
• 对 RTC SDK 内部采集的音频和自定义采集的音频都生效。
• 只对单声道音频生效。
• 只在包含美声特效能力的 SDK 中有效。
• 与 setVoiceReverbType 互斥，后设置的特效会覆盖先设置的特效。
• 使用本接口前，请联系 RTC 技术支持了解更多详情。

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

设置混响特效类型

传入参数

注意

• 在进房前后都可设置。
• 对 RTC SDK 内部采集的音频和自定义采集的音频都生效。
• 只对单声道音频生效。
• 只在包含美声特效能力的 SDK 中有效。
• 与 setVoiceChangerType 互斥，后设置的特效会覆盖先设置的特效。
• 使用本接口前，请联系 RTC 技术支持了解更多详情。

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 background_color)
java

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

传入参数

返回值

• 0: 成功
• -1: 失败。VideoCanvas 为空

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

public abstract void com.ss.bytertc.engine.RTCVideo.updateRemoteStreamVideoCanvas(
    String roomId,
    String userId,
    StreamIndex streamIndex,
    int renderMode,
    int background_color)
java

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

传入参数

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

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

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

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

传入参数

返回值

• 0：成功
• < 0：失败

注意

• 绑定远端用户的视频流，不应早于收到此用户加入房间的通知 onUserJoined
• 本地用户离开房间时，会解除调用此 API 建立的绑定关系；远端用户离开房间则不会影响。

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

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

传入参数

注意

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

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

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

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

传入参数

返回值

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

注意

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

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

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

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

传入参数

返回值

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

注意

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

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

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

传入参数

返回值

• 0: 方法调用成功
• < 0: 方法调用失败。失败原因参看 MediaDeviceWarning 回调。指定为 kAudioRouteUnknown 时将会失败。

注意

• 你需要调用 setAudioScenario 将音频场景切换为 AUDIO_SCENARIO_COMMUNICATION 后再调用本接口。
• 连接有线或者蓝牙音频播放设备后，音频路由将自动切换至此设备。
• 移除后，音频设备会自动切换回原设备。
• 不同音频场景中，音频路由和发布订阅状态到音量类型的映射关系详见 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 void com.ss.bytertc.engine.RTCVideo.enableExternalSoundCard(
    boolean enable)
java

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

传入参数

注意

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

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

调节音频采集音量

传入参数

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

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

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

传入参数

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

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

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

传入参数

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

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

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

传入参数

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

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

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

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

传入参数

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

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

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

传入参数

返回值

• 0：成功
• -1：失败。无效参数
• -2：无效调用。用户已经登录。成功登录后再次调用本接口将收到此返回值
• -3：失败。Engine 为空。调用 createRTCVideo 创建引擎实例后再调用本接口。

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

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

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

注意

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

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

更新用户用于登录的 Token

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

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

传入参数

注意

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

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

设置应用服务器参数

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

传入参数

注意

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

public abstract void com.ss.bytertc.engine.RTCVideo.getPeerOnlineStatus(
    String peer_user_id)
java

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

传入参数

注意

• 必须调用 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 NetworkDetectionStartReturn com.ss.bytertc.engine.RTCVideo.startNetworkDetection(
    boolean isTestUplink,
    int expectedUplinkBitrate,
    boolean isTestDownlink,
    int expectedDownlinkBitrate)
java

开启通话前网络探测

传入参数

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

注意

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

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

停止通话前网络探测

注意

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

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

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

传入参数

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

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

关闭音频回调

传入参数

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

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

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

传入参数

返回值

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

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

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

注册自定义音频处理器。

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

传入参数

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

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

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

传入参数

注意

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

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

关闭自定义音频处理。

传入参数

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 void com.ss.bytertc.engine.RTCVideo.registerLocalEncodedVideoFrameObserver(
    ILocalEncodedVideoFrameObserver observer)
java

注册本地视频帧监测器。

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

传入参数

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

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

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

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

传入参数

注意

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

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

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

传入参数

注意

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

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

推送外部视频帧。

传入参数

返回值

• true: 成功
• false: 失败

注意

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

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

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

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

传入参数

注意

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

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

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

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

传入参数

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

更新转推直播参数，会收到 onStreamMixingEvent 回调。

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

传入参数

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

新增单流转推直播任务。

传入参数

注意

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

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

停止转推直播。

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

传入参数

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: 失败

注意

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

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

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

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

传入参数

返回值
方法调用结果：

• 0：成功
• !0：失败

注意

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

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

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

传入参数

返回值
方法调用结果：

• 0：成功
• !0：失败

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.setScreenVideoEncoderConfig(
    VideoEncoderConfig screen_solution)
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 boolean com.ss.bytertc.engine.RTCVideo.pushScreenFrame(
    VideoFrame videoFrame)
java

推送屏幕视频帧

传入参数

返回值

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

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

调节来自指定远端用户的音频播放音量，默认为 100。

传入参数

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：失败

注意

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

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

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

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

传入参数

返回值
方法调用结果：

• 0：成功
• < 0：失败

注意

• 你必须在进房前设置，进房后设置或更改设置无效。
• 设置回退选项后，订阅的音视频流发生回退或从回退中恢复时，会收到 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

通过视频帧发送 SEI 数据。

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

传入参数

返回值

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

注意

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

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

设置业务标识参数

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

传入参数

返回值

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

注意

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

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

设置AES加密算法和加密密钥

有四种内置的加密算法，为 AES-128-CBC，AES-256-CBC，AES-128-ECB，AES-256-ECB

传入参数

注意

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

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

设置自定义加密方法
自定义加密方法需要实现对应的加密/解密方法

传入参数

注意

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

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

视频特效许可证检查

传入参数

返回值

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

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

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

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

传入参数

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

创建/销毁视频特效引擎

传入参数

返回值

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

注意

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

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

设置视频特效素材包

传入参数

返回值

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

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

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

设置特效强度

传入参数

返回值

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

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

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

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

设置颜色滤镜

传入参数

返回值

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

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

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

传入参数

返回值

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

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

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

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

传入参数

返回值

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

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

开启/关闭基础美颜

传入参数

返回值

• 0: 开启/关闭成功。
• 1000: 未集成特效 SDK。
• 1001: RTC SDK 版本不支持此功能。
• 1002: 特效 SDK 当前版本不支持此功能，建议使用特效 SDK V4.3.1 版本。
• 1003: 联系技术支持人员。
• 1004: 正在下载相关资源，下载完成后生效。
• <0: 调用失败，特效 SDK 内部错误，具体错误码请参考错误码表。

注意

• 本方法不能与高级视频特效接口共用。如已购买高级视频特效，建议调用 enableVideoEffect 使用高级特效、贴纸功能等。
• 使用此功能需要集成特效 SDK，建议使用特效 SDK V4.3.1+ 版本。
• 调用 setBeautyIntensity 设置基础美颜强度。若在调用本方法前没有设置美颜强度，则初始美白、磨皮、锐化强度均为 0.5。
• 本方法仅适用于视频源，不适用于屏幕源。

public abstract int com.ss.bytertc.engine.RTCVideo.setBeautyIntensity(
    EffectBeautyMode beautyMode,
    float intensity)
java

调整基础美颜强度

传入参数

返回值

• 0: 开启成功。
• 1000: 未集成特效 SDK。
• 1001: RTC SDK 版本不支持此功能。
• <0: 调用失败，特效 SDK 内部错误，具体错误码请参考错误码表。

注意

• 若在调用 enableEffectBeauty 前设置美颜强度，则对应美颜功能的强度初始值会根据设置更新。
• 销毁引擎后，美颜功能强度恢复默认值。

public abstract void com.ss.bytertc.engine.RTCVideo.setVideoOrientation(
    VideoOrientation orientation)
java

在自定义视频前处理及编码前，设置 RTC 链路中的视频帧朝向，默认为 Adaptive 模式。
移动端开启视频特效贴纸，或使用自定义视频前处理时，建议固定视频帧朝向为 Portrait 模式。单流转推场景下，建议根据业务需要固定视频帧朝向为 Portrait 或 Landscape 模式。不同模式的具体显示效果参看视频帧朝向。

传入参数

注意

• 设置视频帧朝向仅对内部视频采集生效，不适用于外部视频源和屏幕源。
• 编码分辨率的更新与视频帧处理是异步操作，进房后切换视频帧朝向可能导致画面出现短暂的裁切异常，因此建议在进房前设置视频帧朝向，且不在进房后进行切换。

public abstract void com.ss.bytertc.engine.RTCVideo.setRuntimeParameters(
    JSONObject params)
java

设置运行时的参数

传入参数

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

public abstract int com.ss.bytertc.engine.RTCVideo.feedback(
    List<ProblemFeedback> types,
    String problemDesc)
java

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

传入参数

返回值

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

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

public abstract void com.ss.bytertc.engine.RTCVideo.startASR(
    RTCASRConfig asrConfig,
    IRTCASREngineEventHandler handler)
java

开启自动语音识别服务。该方法将识别后的用户语音转化成文字，并通过 onMessage 事件回调给用户。

传入参数

public abstract void com.ss.bytertc.engine.RTCVideo.stopASR()
java

关闭语音识别服务

public abstract int com.ss.bytertc.engine.RTCVideo.startFileRecording(
    StreamIndex type,
    RecordingConfig config,
    RecordingType recordingType)
java

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

传入参数

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

注意

• 调用该方法后，你会收到 onRecordingStateUpdate 回调。
• 如果录制正常，系统每秒钟会通过 onRecordingProgressUpdate 回调通知录制进度。
• 你需要在成功发流后才可以调用该方法进行录制。

public abstract void com.ss.bytertc.engine.RTCVideo.stopFileRecording(
    StreamIndex type)
java

停止本地录制

传入参数

注意

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

public abstract IAudioMixingManager com.ss.bytertc.engine.RTCVideo.getAudioMixingManager()
java

混音管理接口创建

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

public abstract void com.ss.bytertc.engine.RTCVideo.setScreenAudioSourceType(
    AudioSourceType sourceType)
java

在屏幕共享时，设置屏幕音频的采集方式（内部采集/自定义采集）

传入参数

注意

• 默认采集方式是 RTC SDK 内部采集。
• 你应该在 publishScreen 前，调用此方法。否则，你将收到 onWarning 的报错：WARNING_CODE_SET_SCREEN_AUDIO_SOURCE_TYPE_FAILED。
• 如果设定为内部采集，你必须再调用 startScreenCapture 开始采集。
• 如果设定为自定义采集，你必须再调用 pushScreenAudioFrame 将自定义采集到的屏幕音频帧推送到 RTC SDK。
• 无论是内部采集还是自定义采集，你都必须调用 publishScreen 发布采集到的屏幕音频流。

public abstract void com.ss.bytertc.engine.RTCVideo.setScreenAudioStreamIndex(
    StreamIndex index)
java

在屏幕共享时，设置屏幕音频流和麦克风采集到的音频流的混流方式

传入参数

注意
你应该在 publishScreen 之前，调用此方法。否则，你将收到 onWarning 的报错：WARNING_CODE_SET_SCREEN_STREAM_INDEX_FAILED

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

使用自定义采集方式，采集屏幕共享时的屏幕音频时，将音频帧推送至 RTC SDK 处进行编码等处理。

传入参数

返回值
方法调用结果

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

注意

• 调用此接口推送屏幕共享时的自定义采集的音频数据前，必须调用 setScreenAudioSourceType 开启屏幕音频自定义采集。
• 你应每隔 10 毫秒，调用一次此方法推送一次自定义采集的音频帧。一次推送的音频帧中应包含 frame.sample_rate / 100 个音频采样点。比如，假如采样率为 48000Hz，则每次应该推送 480 个采样点。
• 音频采样格式为 S16。音频缓冲区内的数据格式必须为 PCM 数据，其容量大小应该为 samples × frame.channel × 2。
• 调用此接口将自定义采集的音频帧推送到 RTC SDK 后，你必须调用 publishScreen 将采集到的屏幕音频推送到远端。在调用 publishScreen 前，推送到 RTC SDK 的音频帧信息会丢失。

public abstract void com.ss.bytertc.engine.RTCVideo.startScreenCapture(
    ScreenMediaType type,
    Intent mediaProjectionResultData)
java

使用 RTC SDK 内部采集模块开始采集屏幕音频流和（或）视频流。

传入参数

注意

• 采集后，你还需要调用 publishScreen 发布采集到的屏幕音视频。
• 开启屏幕音频/视频采集成功后，本地用户会收到 onVideoDeviceStateChanged 和 onAudioDeviceStateChanged 的回调。
• 要关闭屏幕音视频内部采集，调用 stopScreenCapture。

public abstract void com.ss.bytertc.engine.RTCVideo.updateScreenCapture(
    ScreenMediaType type)
java

使用 RTC SDK 内部屏幕采集后，更新采集的媒体类型。

传入参数

返回值

• 0: 成功
• -1: 失败

注意
在 startScreenCapture 后调用该方法。

public abstract void com.ss.bytertc.engine.RTCVideo.stopScreenCapture()
java

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

注意

• 要开始屏幕音视频内部采集，调用 startScreenCapture。

public abstract void com.ss.bytertc.engine.RTCVideo.setExternalVideoEncoderEventHandler(
    IExternalVideoEncoderEventHandler encoder_handler)
java

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

传入参数

注意

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

public abstract boolean com.ss.bytertc.engine.RTCVideo.pushExternalEncodedVideoFrame(
    StreamIndex index,
    int video_index,
    RTCEncodedVideoFrame video_stream)
java

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

传入参数

注意

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

public abstract void com.ss.bytertc.engine.RTCVideo.setVideoDecoderConfig(
    RemoteStreamKey key,
    VideoDecoderConfig config)
java

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

传入参数

注意

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

public abstract void com.ss.bytertc.engine.RTCVideo.requestRemoteVideoKeyFrame(
    RemoteStreamKey stream_info)
java

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

传入参数

注意

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

public abstract void com.ss.bytertc.engine.RTCVideo.setEarMonitorMode(
    EarMonitorMode mode)
java

打开/关闭耳返功能。

传入参数

注意

• 耳返功能仅适用于由 RTC SDK 内部采集的音频。
• 使用耳返功能必须佩戴耳机。为保证低延时耳返最佳体验，建议佩戴有线耳机。蓝牙耳机不支持硬件耳返。
• RTC SDK 支持硬件耳返和软件耳返。一般来说，硬件耳返延时低且音质好。如果 App 在手机厂商的硬件耳返白名单内，且运行环境存在支持硬件耳返的 SDK，RTC SDK 默认启用硬件耳返。使用华为手机硬件耳返功能时，请添加华为硬件耳返的依赖配置。

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

设置耳返音量。

传入参数

注意

• 设置耳返音量前，你必须先调用 setEarMonitorMode 打开耳返功能。

public abstract void com.ss.bytertc.engine.RTCVideo.enableAudioPropertiesReport(
    AudioPropertiesConfig config)
java

启用音频信息提示。

传入参数

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

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

public abstract int com.ss.bytertc.engine.RTCVideo.sendStreamSyncInfo(
    byte[] data,
    StreamSycnInfoConfig config)
java

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

传入参数

返回值

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

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

public abstract boolean com.ss.bytertc.engine.RTCVideo.isCameraTorchSupported()
java

检测当前使用的摄像头（前置/后置），是否支持闪光灯。

返回值

• true: 支持
• false: 不支持

注意
必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集时，才能检测闪光能力。

public abstract boolean com.ss.bytertc.engine.RTCVideo.isCameraZoomSupported()
java

检测当前使用的摄像头（前置/后置），是否支持变焦（数码/光学变焦）。

返回值

• true: 支持
• false: 不支持

注意
必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集时，才能检测摄像头变焦能力。

public abstract int com.ss.bytertc.engine.RTCVideo.setCameraZoomRatio(
    float zoom)
java

设置当前使用的摄像头（前置/后置）的变焦倍数

传入参数

返回值

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

注意

• 必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集时，才能设置摄像头变焦倍数。
• 设置结果在调用 stopVideoCapture 关闭内部采集后失效。

public abstract float com.ss.bytertc.engine.RTCVideo.getCameraZoomMaxRatio()
java

获取当前使用的摄像头（前置/后置）的最大变焦倍数

返回值
最大变焦倍数

注意
必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集时，才能检测摄像头最大变焦倍数。

public abstract int com.ss.bytertc.engine.RTCVideo.setCameraTorch(
    TorchState torch_state)
java

打开/关闭当前使用的摄像头（前置/后置）的闪光灯

传入参数

返回值

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

注意

• 必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集时，才能设置闪光灯。
• 设置结果在调用 stopVideoCapture 关闭内部采集后失效。

public abstract boolean com.ss.bytertc.engine.RTCVideo.isCameraFocusPositionSupported()
java

检查当前使用的摄像头是否支持手动对焦。

返回值

• true: 支持。
• false: 不支持。

注意
必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集，才能检查摄像头是否支持手动对焦。

public abstract int com.ss.bytertc.engine.RTCVideo.setCameraFocusPosition(
    float x,
    float y)
java

设置当前使用的摄像头的对焦点。

传入参数

返回值

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

注意

• 必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集，并且使用 SDK 内部渲染时，才能设置对焦点。
• 移动设备时，自动取消对焦点设置。
• 调用 stopVideoCapture 关闭内部采集后，设置的对焦点失效。

public abstract boolean com.ss.bytertc.engine.RTCVideo.isCameraExposurePositionSupported()
java

检查当前使用的摄像头是否支持手动设置曝光点。

返回值

• true: 支持。
• false: 不支持。

注意
必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集时，才能检查曝光点设置能力。

public abstract int com.ss.bytertc.engine.RTCVideo.setCameraExposurePosition(
    float x,
    float y)
java

设置当前使用的摄像头的曝光点

传入参数

返回值

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

注意

• 必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集，并且使用SDK内部渲染时，才能设置曝光点。
• 移动设备时，自动取消曝光点设置。
• 调用 stopVideoCapture 关闭内部采集后，设置的曝光点失效。

public abstract int com.ss.bytertc.engine.RTCVideo.setCameraExposureCompensation(
    float val)
java

设置当前使用的摄像头的曝光补偿。

传入参数

返回值

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

注意

• 必须已调用 startVideoCapture 使用 SDK 内部采集模块进行视频采集时，才能设置曝光补偿。
• 调用 stopVideoCapture 关闭内部采集后，设置的曝光补偿失效。

public abstract int com.ss.bytertc.engine.RTCVideo.startPushPublicStream(
    String publicStreamId,
    PublicStreaming publicStream)
java

发布一路公共流

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

传入参数

返回值
0: 成功。同时将收到 onPushPublicStreamResult 回调。

• !0: 失败。当参数不合法或参数为空，调用失败。

注意

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

public abstract int com.ss.bytertc.engine.RTCVideo.stopPushPublicStream(
    String publicStreamId)
java

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

关于发布公共流，查看 startPushPublicStream

传入参数

返回值

• 0: 成功
• !0: 失败

public abstract int com.ss.bytertc.engine.RTCVideo.updatePublicStreamParam(
    String publicStreamId,
    PublicStreaming transcoding)
java

更新公共流参数

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

传入参数

返回值

• 0: 成功
• !0: 失败

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

public abstract int com.ss.bytertc.engine.RTCVideo.startPlayPublicStream(
    String publicStreamId)
java

订阅指定公共流

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

传入参数

返回值

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

注意

• 在调用本接口之前，建议先绑定渲染视图。

• 调用 setPublicStreamVideoCanvas 绑定内部渲染视图：
• 调用 setPublicStreamVideoSink 绑定自定义渲染视图：

• 调用本接口后，可以通过 onFirstPublicStreamVideoFrameDecoded 和 onFirstPublicStreamAudioFrame 回调公共流的视频和音频首帧解码情况。
• 调用本接口后，可以通过 onPublicStreamSEIMessageReceived 回调公共流中包含的 SEI 信息。
• 调用 stopPlayPublicStream 取消订阅公共流。

public abstract int com.ss.bytertc.engine.RTCVideo.stopPlayPublicStream(
    String publicStreamId)
java

取消订阅指定公共流

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

传入参数

返回值

• 0：成功
• !0：失败

public abstract int com.ss.bytertc.engine.RTCVideo.setPublicStreamVideoCanvas(
    String publicStreamId,
    VideoCanvas canvas)
java

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

传入参数

返回值

• 0：成功
• <0：失败

public abstract void com.ss.bytertc.engine.RTCVideo.setPublicStreamVideoSink(
    String publicStreamId,
    IVideoSink videoSink,
    @IVideoSink.PixelFormat int requiredFormat)
java

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

传入参数

返回值

• 0: 成功
• <0: 失败

public abstract int com.ss.bytertc.engine.RTCVideo.startEchoTest(
    EchoTestConfig config,
    int delayTime)
java

开启音视频回路测试。

在进房前，用户可调用该接口对音视频通话全链路进行检测，包括对音视频设备以及用户上下行网络的检测，从而帮助用户判断是否可以正常发布和接收音视频流。

开始检测后，SDK 会录制你声音或视频。如果你在设置的延时范围内收到了回放，则视为音视频回路测试正常。

传入参数

返回值
方法调用结果：

• 0：成功
• -1：失败，当前用户已经在检测中
• -2：失败，用户已进房
• -3：失败，音视频均未采集
• -4：失败，参数异常
• -5：失败，已经存在相同 roomId 的房间

注意

• 调用该方法开始音视频回路检测后，你可以调用 stopEchoTest 立即结束测试，也可等待测试 60s 后自动结束，以更换设备进行下一次测试，或进房。
• 在该方法之前调用的所有跟设备控制、流控制相关的方法均在开始检测时失效，在结束检测后恢复生效。
• 在调用 startEchoTest 和 stopEchoTest 之间调用的所有跟设备采集、流控制、进房相关的方法均不生效，并会收到 onWarning 回调，提示警告码为 WARNING_CODE_IN_ECHO_TEST_MODE。
• 音视频回路检测的结果会通过 onEchoTestResult 回调通知。

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

停止音视频回路测试。

调用 startEchoTest 开启音视频回路检测后，你必须调用该方法停止检测。

返回值
方法调用结果：

• 0：成功
• -1：失败，未开启回路检测

注意
音视频回路检测结束后，所有对系统设备及音视频流的控制均会恢复到开始检测前的状态。

public abstract void com.ss.bytertc.engine.RTCVideo.setVideoWatermark(
    StreamIndex streamIndex,
    String imagePath,
    RTCWatermarkConfig watermarkConfig)
java

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

传入参数

注意

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

public abstract void com.ss.bytertc.engine.RTCVideo.clearVideoWatermark(
    StreamIndex streamIndex)
java

移除指定视频流的水印。

传入参数

public abstract long com.ss.bytertc.engine.RTCVideo.takeLocalSnapshot(
    StreamIndex streamIndex,
    ISnapshotResultCallback callback)
java

截取本地视频画面

传入参数

返回值
本地截图任务的编号，从 1 开始递增。

注意

• 对截取的画面，包含本地视频处理的全部效果，包含旋转，镜像，美颜等。
• 不管采用 SDK 内部采集，还是自定义采集，都可以进行截图。

public abstract long com.ss.bytertc.engine.RTCVideo.takeRemoteSnapshot(
    RemoteStreamKey streamKey,
    ISnapshotResultCallback callback)
java

截取远端视频画面

传入参数

返回值
远端截图任务的编号，从 1 开始递增。

public abstract void com.ss.bytertc.engine.RTCVideo.startCloudProxy(
    List<CloudProxyInfo> cloudProxiesInfo)
java

开启云代理

传入参数

注意

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

public abstract void com.ss.bytertc.engine.RTCVideo.stopCloudProxy()
java

关闭云代理

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

public abstract KTVManager com.ss.bytertc.engine.RTCVideo.getKTVManager()
java

创建 KTV 管理接口。

返回值
KTV 管理接口，参看 KTVManager。

public abstract ISingScoringManager com.ss.bytertc.engine.RTCVideo.getSingScoringManager()
java

创建 K 歌评分管理接口。

返回值
K 歌评分管理接口，参看 ISingScoringManager。

public abstract class com.ss.bytertc.engine.audio.IAudioMixingManager
java

混音管理类

public abstract void com.ss.bytertc.engine.audio.IAudioMixingManager.startAudioMixing(
    int mixId,
    String filePath,
    AudioMixingConfig config)
java

开始播放音频文件。

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

传入参数

注意

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

public abstract void com.ss.bytertc.engine.audio.IAudioMixingManager.stopAudioMixing(
    int mixId)
java

停止播放音频文件

传入参数

注意

• 调用 startAudioMixing 方法开始播放音频文件后，可以调用本方法停止播放音频文件。
• 调用本方法停止播放音频文件后，关于当前的混音状态，会收到回调 onAudioMixingStateChanged。
• 调用本方法停止播放音频文件后，该音频文件会被自动卸载。

public abstract void com.ss.bytertc.engine.audio.IAudioMixingManager.pauseAudioMixing(
    int mixId)
java

暂停播放音频文件

传入参数

注意

• 调用 startAudioMixing 方法开始播放音频文件后，可以通过调用本方法暂停播放音频文件。
• 调用本方法暂停播放音频文件后，可调用 resumeAudioMixing 方法恢复播放及混音。
• 调用本方法暂停播放音频文件后，关于当前的混音状态，会收到回调 onAudioMixingStateChanged。

public abstract void com.ss.bytertc.engine.audio.IAudioMixingManager.resumeAudioMixing(
    int mixId)
java

恢复播放音频文件

传入参数

注意

• 调用 pauseAudioMixing 方法暂停播放音频文件后，可以通过调用本方法恢复播放及混音。
• 调用本方法恢复播放音频文件后，关于当前的混音状态，会收到回调 onAudioMixingStateChanged。

public abstract void com.ss.bytertc.engine.audio.IAudioMixingManager.preloadAudioMixing(
    int mixId,
    String filePath)
java

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

传入参数