RTCEngine

public abstract class com.ss.bytertc.engine.RTCEngine

RtcEngine接口

静态函数

成员函数

函数说明

createEngine

public static synchronized RTCEngine com.ss.bytertc.engine.RTCEngine.createEngine(
    Context context,
    String appId,
    IRTCEngineEventHandler handler,
    Object eglContext,
    JSONObject parameters)

创建引擎对象
此方法应该作为正常 SDK 流程中的第一步操作，通过创建一个引擎实例，来使用 SDK 的其他能力

传入参数

返回值

• RtcEngine 创建成功。返回一个可用的 RtcEngineImpl 实例
• null so 加载失败，创建失败。返回 null

注意

• 调用者应注意保持 handler 的生命周期必须大于 RtcEngineRTCEngine 的生命周期，即 handler 必须在调用 createEngine 之前创建，在调用 destroyEngine 之后销毁

destroyEngine

public static synchronized void com.ss.bytertc.engine.RTCEngine.destroyEngine(
    RTCEngine engine)

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

注意

• 请确保一定是在所有业务场景的最后阶段才调用该方法
• 该方法在调用之后，会销毁所有SDK相关的内存，并且停止与媒体服务器的任何交互
• 本方法为阻塞调用，会阻塞当前线程直到SDK彻底完成退出逻辑，因而需要注意不要在回调线程中直接调用 本方法，也需要注意不要在回调方法中等待主线程的执行，而同时在主线程调用本方法，从而造成死锁

destroy

public static synchronized void com.ss.bytertc.engine.RTCEngine.destroy()

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

注意

• 请确保一定是在所有业务场景的最后阶段才调用该方法
• 该方法在调用之后，会销毁所有SDK相关的内存，并且停止与媒体服务器的任何交互

• 该方法不会销毁任何配置，在上一次 create 调用之后对SDK进行的任何配置， 在下一次有效执行 create 时依然生效

• 本方法为阻塞调用，会阻塞当前线程直到SDK彻底完成退出逻辑，因而需要注意不要在回调线程中直接调用 本方法，也需要注意不要在回调方法中等待主线程的执行，而同时在主线程调用本方法，从而造成死锁

getSdkVersion

public static String com.ss.bytertc.engine.RTCEngine.getSdkVersion()

获取 SDK 当前的版本号。

返回值 SDK 当前的版本号。

getErrorDescription

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

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

传入参数

返回值 String 描述文字

feedback

public static int com.ss.bytertc.engine.RTCEngine.feedback(
    Context context,
    int grade,
    int type,
    String problemDesc)

通话结束，用户反馈上报

传入参数

返回值 0: 成功；

-1: 还没加入过房间，上报失败； -2: 数据解析错误 -3: 字段缺失 -4: grade不合法

setRtcEngineEventHandler

public abstract void com.ss.bytertc.engine.RTCEngine.setRtcEngineEventHandler(
    IRTCEngineEventHandler engineEventHandler)

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

传入参数

注意

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

joinRoom

public abstract int com.ss.bytertc.engine.RTCEngine.joinRoom(
    String token,
    String roomId,
    UserInfo userInfo,
    ChannelProfile profile_type)

加入房间。用户调用此方法加入房间，同一房间内的用户间可以相互通话。
进房后重复调用无效，用户必须调用 leaveRoom 退出当前房间后，才能加入下一个房间。
本地用户调用此方法加入房间成功后，会收到 onJoinRoomResult 回调通知，远端用户会收到 onUserJoined 回调通知。

传入参数

返回值

0：方法调用成功

-1：roomID 为空 -2：userInfo 为空 -3：native engine 为空 -4：JoinRoom 不能重复调用

注意

• 使用不同 App ID 的 App 是不能互通的。
• 请务必保证生成 Token 使用的 App ID 和创建引擎时使用的 App ID 相同，否则会导致加入房间失败。
• 用户加入房间成功后，在本地网络状况不佳的情况下，SDK 可能会与服务器失去连接，此时 SDK 将会自动重连。重连成功后，本地会收到 OnJoinRoomResultonJoinRoomResult 回调通知。
• 同一个 App ID 的同一个房间内，每个用户的用户 ID 必须是唯一的。如果两个用户的用户 ID 相同，则后进房的用户会将先进房的用户踢出房间，并且先进房的用户会收到 onError 回调通知，错误类型详见 ErrorCode.kErrorCodeDuplicateLoginErrorCode。

leaveRoom

public abstract int com.ss.bytertc.engine.RTCEngine.leaveRoom()

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

返回值

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

注意

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

startVideoCapture

public abstract void com.ss.bytertc.engine.RTCEngine.startVideoCapture()

开启内部视频采集。默认为关闭状态。
进房前调用该方法，本地用户会收到 onMediaDeviceStateChanged 的回调。
进房后调用该方法，房间中的其他用户会收到 onUserStartVideoCapture 的回调。

注意

• 调用 stopVideoCapture 可以关闭视频采集设备，否则，SDK 只会在销毁引擎的时候自动关闭设备。
• 无论是否发布视频数据，你都可以调用该方法开启视频采集，并且调用后方可发布视频。
• 已使用自定义采集时，关闭自定义采集后并不会自动开启内部采集。你需调用此方法手动开启内部采集。

stopVideoCapture

public abstract void com.ss.bytertc.engine.RTCEngine.stopVideoCapture()

关闭本地视频采集。默认为关闭状态。
进房前调用该方法，本地用户会收到 onMediaDeviceStateChanged 的回调。
进房后调用该方法，房间中的其他用户会收到 onUserStopVideoCapture 的回调。

注意

• 调用 startVideoCapture 可以开启视频采集设备。
• 设备开启后若一直未调用该方法关闭，则 SDK 会在销毁引擎的时候自动关闭音频采集设备。

startAudioCapture

public abstract void com.ss.bytertc.engine.RTCEngine.startAudioCapture()

开启内部音频采集。默认为关闭状态。
进房前调用该方法，本地用户会收到 onMediaDeviceStateChanged 的回调。
进房后调用该方法，房间中的其他用户会收到 onUserStartAudioCapture 的回调。

注意

• 调用 stopAudioCapture 可以关闭音频采集设备，否则，SDK 只会在销毁引擎的时候自动关闭设备。
• 无论是否发布音频数据，你都可以调用该方法开启音频采集，并且调用后方可发布音频。
• 尚未进房并且已使用自定义采集时，关闭自定义采集后并不会自动开启内部采集。你需调用此方法手动开启内部采集。

stopAudioCapture

public abstract void com.ss.bytertc.engine.RTCEngine.stopAudioCapture()

关闭内部音频采集。默认为关闭状态。
进房前调用该方法，本地用户会收到 onMediaDeviceStateChanged 的回调。
进房后调用该方法，房间中的其他用户会收到 onUserStopAudioCapture 的回调。

注意

• 调用 startAudioCapture 可以开启音频采集设备。
• 设备开启后若一直未调用该方法关闭设备，则 SDK 会在销毁引擎的时候自动关闭音频采集设备。

setAudioScenario

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

设置音频场景类型

传入参数

setLocalVideoCanvas

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

设置本地视频渲染时，使用的视图，并设置渲染模式。
你应在加入房间前，绑定本地视图。退出房间后，此设置仍然有效。 如果需要解除绑定，你可以调用本方法绑定空视图。

传入参数

返回值

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

setupLocalVideoRender

public abstract int com.ss.bytertc.engine.RTCEngine.setupLocalVideoRender(
    IVideoSink videoSink,
    String uid)

设置本地视频外部渲染

传入参数

返回值

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

注意 该方法设置本地视频外部渲染。应用程序通过调用此接口绑定本地视频流的数据源回调。 在应用程序开发中，通常在 APP 收到 onFirstLocalVideoFrameCaptured 事件后调用该方法进行本地视频设置，然后再加入房间。 退出房间后，会收到 onStop 和 onDispose，如果需要手动提前 Dispose，需要设置 setupLocalVideoRender为 null，清除设置 。

setupLocalVideoRender

public abstract int com.ss.bytertc.engine.RTCEngine.setupLocalVideoRender(
    IVideoSink videoSink,
    String uid,
    boolean isInitialized)

设置本地视频外部渲染

传入参数

返回值

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

注意 该方法设置本地视频外部渲染。应用程序通过调用此接口绑定本地视频流的数据源回调。 在应用程序开发中，通常在 APP 收到 onFirstLocalVideoFrameCaptured 事件后调用该方法进行本地视频设置，然后再加入房间。 退出房间后，会收到 onStop 和 onDispose，如果需要手动提前 Dispose，需要设置 setupLocalVideoRender为 null，清除设置 。

setupLocalScreenRender

public abstract int com.ss.bytertc.engine.RTCEngine.setupLocalScreenRender(
    IVideoSink videoSink,
    String uid)

设置本地屏幕视频的外部渲染

传入参数

返回值

• 0: 方法调用成功
• -1: videoSink 为空
• -2: uid 为空

注意 该方法设置本地屏幕视频外部渲染。应用通过调用此接口绑定本地视频流的数据源回调。 在应用开发中，通常在应用收到 onFirstLocalVideoFrameCaptured 事件后调用该方法进行本地视频设置。 退出房间后，需要设置 setupLocalScreenRender 为 null，清除设置 。

setRemoteVideoCanvas

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

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

传入参数

返回值

• 0：成功
• <0：失败

setupRemoteVideoRender

public abstract int com.ss.bytertc.engine.RTCEngine.setupRemoteVideoRender(
    IVideoSink videoSink,
    String roomid,
    String uid)

设置远端视频的外部渲染

传入参数

返回值

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

注意 该方法设置远端视频外部渲染。应用程序通过调用此接口绑定远端视频流的数据源回调。 在应用程序开发中，通常在 APP 收到 onFirstRemoteVideoFrameRendered 事件后调用该方法进行远端视频设置，然后再加入房间。 退出房间后，会收到 onStop 和 onDispose，如果需要手动提前 Dispose，需要设置 setupRemoteVideoRender 为 null，清除设置。

setupRemoteVideoRender

public abstract int com.ss.bytertc.engine.RTCEngine.setupRemoteVideoRender(
    IVideoSink videoSink,
    String uid)

设置远端视频的外部渲染

传入参数

返回值

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

注意 该方法设置远端视频外部渲染。应用程序通过调用此接口绑定远端视频流的数据源回调。 在应用程序开发中，通常在 APP 收到 onFirstRemoteVideoFrameRendered 事件后调用该方法进行远端视频设置，然后再加入房间。 退出房间后，会收到 onStop 和 onDispose，如果需要手动提前 Dispose，需要设置 setupRemoteVideoRender 为 null，清除设置。

setupRemoteVideoRender

public abstract int com.ss.bytertc.engine.RTCEngine.setupRemoteVideoRender(
    IVideoSink videoSink,
    String roomid,
    String uid,
    boolean isInitialized)

设置远端视频的外部渲染

传入参数

返回值

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

注意 该方法设置远端视频外部渲染。应用程序通过调用此接口绑定远端视频流的数据源回调。 在应用程序开发中，通常在 APP 收到 onFirstRemoteVideoFrameRendered 事件后调用该方法进行远端视频设置，然后再加入房间。 退出房间后，会收到 onStop 和 onDispose，如果需要手动提前 Dispose，需要设置 setupRemoteVideoRender 为 null，清除设置。

setupRemoteVideoRender

public abstract int com.ss.bytertc.engine.RTCEngine.setupRemoteVideoRender(
    IVideoSink videoSink,
    String uid,
    boolean isInitialized)

设置远端视频的外部渲染

传入参数

返回值

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

注意 该方法设置远端视频外部渲染。应用程序通过调用此接口绑定远端视频流的数据源回调。 在应用程序开发中，通常在 APP 收到 onFirstRemoteVideoFrameRendered 事件后调用该方法进行远端视频设置，然后再加入房间。 退出房间后，会收到 onStop 和 onDispose，如果需要手动提前 Dispose，需要设置 setupRemoteVideoRender 为 null，清除设置。。

setupRemoteScreenRender

public abstract int com.ss.bytertc.engine.RTCEngine.setupRemoteScreenRender(
    IVideoSink videoSink,
    String roomid,
    String uid)

设置远端屏幕流视频的外部渲染

传入参数

返回值

• 0: 方法调用成功
• -1: videoSink 为空
• -2: uid 为空

注意 该方法设置远端屏幕视频外部渲染。应用通过调用此接口绑定远端视频流的数据源回调。 在应用开发中，通常在应用收到 onFirstRemoteVideoFrameRendered 事件后调用该方法进行远端视频设置。 退出房间后，需要设置 setupRemoteScreenRender 为 null，清除设置 。

setupRemoteScreenRender

public abstract int com.ss.bytertc.engine.RTCEngine.setupRemoteScreenRender(
    IVideoSink videoSink,
    String uid)

设置远端屏幕流视频的外部渲染

传入参数

返回值

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

注意 该方法设置远端屏幕视频外部渲染。应用程序通过调用此接口绑定远端视频流的数据源回调。 在应用开发中，通常在应用收到 onFirstRemoteVideoFrameRendered 事件后调用该方法进行远端视频设置。 退出房间后，需要设置 setupRemoteScreenRender 为 null，清除设置 。

setLocalVideoMirrorMode

public abstract int com.ss.bytertc.engine.RTCEngine.setLocalVideoMirrorMode(
    MirrorMode mirrorMode)

设置采用前置摄像头采集时，是否开启镜像模式。
调用后，你会收到回调：OnMirrorStateChangedonMirrorStateChanged

传入参数

返回值

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

isLocalVideoMirrorOn

public abstract boolean com.ss.bytertc.engine.RTCEngine.isLocalVideoMirrorOn()

获取本地视频镜像。

返回值 当前镜像状态

• true：镜像为打开状态
• false：镜像为关闭状态

switchCamera

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

切换移动端前置/后置摄像头

传入参数

返回值

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

replaceBackground

public abstract int com.ss.bytertc.engine.RTCEngine.replaceBackground(
    BackgroundMode mode,
    DivideModel divide_model)

视频图像分割，替换背景

传入参数

setAudioPlaybackDevice

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

设置音频播放设备为扬声器或者听筒，默认使用扬声器。
音频播放设备发生变化时，会收到 onAudioPlaybackDeviceChanged 事件回调。

传入参数

返回值 方法调用结果

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

注意

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

isSpeakerphoneEnabled

public abstract boolean com.ss.bytertc.engine.RTCEngine.isSpeakerphoneEnabled()

查询扬声器启用状态

返回值 扬声器开启状态

• true：扬声器已开启，语音会输出到扬声器
• false：扬声器未开启，语音会输出到非扬声器（听筒，耳机等）

setAudioVolumeIndicationInterval

public abstract void com.ss.bytertc.engine.RTCEngine.setAudioVolumeIndicationInterval(
    int interval)

开启/关闭音量提示。默认关闭。
开启音量提示后，将按设置的时间间隔收到本地采集音量或订阅的远端用户的音量信息回调。 关于回调的具体信息，参看 onAudioVolumeIndication。

传入参数

muteLocalAudio

public abstract void com.ss.bytertc.engine.RTCEngine.muteLocalAudio(
    MuteState muteState)

控制本地音频流的发送状态：发送/不发送。
使用此方法后，房间中的其他用户会收到回调 onUserMuteAudio。

传入参数

注意 本方法仅控制本地音频流的发送状态，并不影响本地音频采集状态。

muteLocalVideo

public abstract int com.ss.bytertc.engine.RTCEngine.muteLocalVideo(
    MuteState muteState)

停止/启动发送本地视频流。
调用该方法后，房间中的其他用户会收到 onUserMuteVideo 的回调。

传入参数

返回值

• 0：成功
• <0：失败

muteAllRemoteVideo

public abstract int com.ss.bytertc.engine.RTCEngine.muteAllRemoteVideo(
    MuteState muteState)

设置是否播放所有远端视频流

传入参数

返回值

• 0：成功
• <0：失败

注意 本方法不影响远端视频采集和发送状态

muteAllRemoteAudio

public abstract void com.ss.bytertc.engine.RTCEngine.muteAllRemoteAudio(
    MuteState muteState)

设置对来自远端的所有音频流的接收状态。默认为接收。

传入参数

注意 本方法只控制本地是否接收远端音频流，并不影响远端音频设备的采集发送功能。

muteRemoteAudio

public abstract void com.ss.bytertc.engine.RTCEngine.muteRemoteAudio(
    String uid,
    MuteState muteState)

设置对来自指定远端用户的音频流的接收状态。默认为接收。

传入参数

muteRemoteVideo

public abstract int com.ss.bytertc.engine.RTCEngine.muteRemoteVideo(
    String uid,
    MuteState muteState)

设置是否播放远端视频流

传入参数

返回值

• 0：成功
• <0：失败

注意 本方法不影响远端视频采集和发送状态

updateToken

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

更新 Token。
Token 有一定的有效期，当 Token 过期时，用户需调用此方法更新房间的 Token 信息。
用户调用 joinRoom 方法加入房间时，如果使用了过期的 Token 将导致加入房间失败，并会收到 onError 回调通知，回调错误码为 ErrorCode.ERROR_CODE_INVALID_TOKENErrorCode。此时需要重新获取 Token，并调用此方法更新 Token。

传入参数

返回值 方法调用结果。

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

注意

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

setUserRole

public abstract int com.ss.bytertc.engine.RTCEngine.setUserRole(
    ClientRole clientRole)

设置用户角色。默认角色为主播。
通过设置不同的用户角色，可以控制用户在房间内的行为：

• 能否发布音视频流；
  
• 用户自身是否在房间中隐身。
  

传入参数

返回值

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

注意

• 在加入房间前后，用户均可调用此方法设置用户角色。
• 在房间内，调用此方法成功切换角色后，房间内其他用户会收到相应的回调通知：
• 从静默观众切换至主播时，房间内其他用户会收到 onUserJoined；
• 从主播切换至静默观众时，房间内其他用户会收到 onUserLeave 。

startAudioMixing

public abstract int com.ss.bytertc.engine.RTCEngine.startAudioMixing(
    String file,
    boolean loopback,
    boolean replace,
    int cycle)

开始播放音乐文件及混音。

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 该方法指定本地和麦克风采集的音频流进行混音或替换。替换是指用音频文件替换麦克风采集的音频流。
• 该方法可以选择是否让对方听到本地播放的音频，并指定循环播放的次数。 调用本方法播放音乐文件及混音结束后，应用会收到 onAudioMixingFinished 回调。
• 开始播放音乐文件及混音后，可以调用 stopAudioMixing 方法停止播放音乐文件。
• 该方法混音数据来源外部文件，且支持的文件格式有: mp3，aac，m4a，3gp，wav；而SetAudioPlayoutMixStreamsetAudioPlayoutMixStream 混音的数据来源外部缓存且音频格式为PCM；这两种混音方式可以共存。
• 单个房间只支持一路音乐文件的播放，多次调用该函数后，只有最后一次调用会生效。
• 请在房间内调用该方法。

stopAudioMixing

public abstract int com.ss.bytertc.engine.RTCEngine.stopAudioMixing()

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

返回值

• 0：成功
• <0：失败

注意

• 调用 startAudioMixing 方法开始播放音乐文件及混音后，调用该方法可以停止播放音乐文件及混音。
• 请在房间内调用该方法。

setRecordingVolume

public abstract void com.ss.bytertc.engine.RTCEngine.setRecordingVolume(
    int volume)

调节音频采集音量。

传入参数

注意 为保证更好的通话质量，建议将 volume 值设为 [0,100]。

setPlaybackVolume

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

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

传入参数

注意 为保证更好的通话质量，建议将 volume 值设为 [0,100]。

pauseAudioMixing

public abstract int com.ss.bytertc.engine.RTCEngine.pauseAudioMixing()

暂停播放音乐文件

返回值

• 0: 成功
• <0: 失败

注意

• 调用 startAudioMixing 方法开始播放音乐文件及混音后，可以通过调用该方法暂停播放音乐文件。
• 调用该方法暂停播放音乐文件后，可调用 resumeAudioMixing 方法恢复播放。
• 请在房间内调用该方法。

resumeAudioMixing

public abstract int com.ss.bytertc.engine.RTCEngine.resumeAudioMixing()

恢复播放音乐文件

返回值

• 0: 成功
• <0: 失败

注意

• 调用 pauseAudioMixing 方法暂停播放音乐文件后，可以通过调用该方法恢复播放。
• 请在房间内调用该方法

sendRoomMessage

public abstract long com.ss.bytertc.engine.RTCEngine.sendRoomMessage(
    String messgaeStr)

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

传入参数

返回值

>0：发送成功，返回这次发送消息的编号，从 1 开始递增

-1：发送失败

注意 1.调用该函数后会收到一次 onRoomMessageSendResult 回调； 2.同一房间内的其他用户会收到 onRoomMessageReceived 回调。

sendRoomBinaryMessage

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

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

传入参数

返回值 >0：发送成功，返回这次发送消息的编号，从 1 开始递增

-1：发送失败

注意 1.调用该函数后会收到一次 onRoomMessageSendResult 回调； 2.同一房间内的其他用户会收到 onRoomBinaryMessageReceived 回调。

sendUserMessage

public abstract long com.ss.bytertc.engine.RTCEngine.sendUserMessage(
    String userId,
    String messageStr)

给房间内指定的用户发送文本消息（P2P），返回这次发送消息的编号。

传入参数

返回值

>0：发送成功，返回这次发送消息的编号，从 1 开始递增

-1：发送失败，RtcEngine 实例未创建
-2：发送失败，userId 为空

注意 1. 调用该函数后会收到一次 onUserMessageSendResult 回调，通知消息发送方发送成功或失败；
2. 若文本消息发送成功，则 uid 所指定的用户会收到 onUserMessageReceived 回调。

sendUserBinaryMessage

public abstract long com.ss.bytertc.engine.RTCEngine.sendUserBinaryMessage(
    String userId,
    byte[] buffer)

给房间内指定的用户发送二进制消息（P2P），返回这次发送消息的编号。

传入参数

返回值

>0：发送成功，返回这次发送消息的编号，从 1 开始递增

-1：发送失败，RtcEngine 实例未创建
-2：发送失败，uid 为空

注意 1. 调用该函数后会收到一次 onUserMessageSendResult 回调，通知消息发送方发送成功或失败；
2. 若二进制消息发送成功，则 userId 所指定的用户会收到 onUserBinaryMessageReceived 回调。

adjustAudioMixingVolume

public abstract int com.ss.bytertc.engine.RTCEngine.adjustAudioMixingVolume(
    int volume)

调节音乐文件的文件音量。为保证更好的音质，建议将 volume 值设为 [0,100]。

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 调用该方法可同时调节的是本地和远端播放音量。仅调节本端音量可使用 adjustAudioMixingPlayoutVolume ， 仅调节远端音量可使用 adjustAudioMixingPublishVolume。
• 该方法对 adjustAudioMixingPlayoutVolume 和 adjustAudioMixingPublishVolume 的音量调节影响是乘积关系。
• 请在房间内调用该方法。

getAudioMixingDuration

public abstract int com.ss.bytertc.engine.RTCEngine.getAudioMixingDuration()

获取音乐文件时长

返回值

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

注意 请在房间内调用该方法。

getAudioMixingCurrentPosition

public abstract int com.ss.bytertc.engine.RTCEngine.getAudioMixingCurrentPosition()

获取音乐文件播放进度

返回值

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

注意 请在房间内调用该方法。

setAudioMixingPosition

public abstract int com.ss.bytertc.engine.RTCEngine.setAudioMixingPosition(
    int pos)

设置音频文件的播放位置

传入参数

返回值

• 0: 成功
• <0: 失败

注意 该方法可以设置音频文件的播放位置，这样你可以根据实际情况从指定的位置播放音乐文件，无需从头到尾完整播放一个音乐文件。

adjustAudioMixingPlayoutVolume

public abstract int com.ss.bytertc.engine.RTCEngine.adjustAudioMixingPlayoutVolume(
    int volume)

调节音乐文件的本地播放音量。为保证更好的音质，建议将 volume 值设为 [0,100]。

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 调用该方法可以调节混音的音乐文件在本地播放的音量大小。如果需要同时调节本地和远端播放音量可使用 adjustAudioMixingVolume 方法。
• 请在房间内调用该方法。

adjustAudioMixingPublishVolume

public abstract int com.ss.bytertc.engine.RTCEngine.adjustAudioMixingPublishVolume(
    int volume)

调节音乐文件的远端播放音量。为保证更好的音质，建议将 volume 值设为 [0,100]。

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 该方法调节混音的音乐文件在远端播放的音量大小。如果需要同时调节本地和远端播放音量可使用 adjustAudioMixingVolume 方法。
• 请在房间内调用该方法。

getEffectVolume

public abstract int com.ss.bytertc.engine.RTCEngine.getEffectVolume(
    int soundId)

获取指定音效文件的文件音量

传入参数

返回值

• >0: 成功，文件音量，音量范围为 0~400。
• <0: 失败

注意 请在房间内调用该方法。

setVolumeOfEffect

public abstract int com.ss.bytertc.engine.RTCEngine.setVolumeOfEffect(
    int soundId,
    int volume)

调节指定音效文件的文件音量。为保证更好的音质，建议将 volume 值设为 [0,100]。

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 该方法调节音效文件在本地和远端播放的音量大小。
• 请在房间内调用该方法。

setEffectsVolume

public abstract int com.ss.bytertc.engine.RTCEngine.setEffectsVolume(
    int volume)

调节所有音效文件的文件音量。为保证更好的音质，建议将 volume 值设为 [0,100]。

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 该方法调节混音的所有音效文件在本地和远端播放的音量大小。
• 请在房间内调用该方法。

playEffect

public abstract int com.ss.bytertc.engine.RTCEngine.playEffect(
    int soundId,
    String filePath,
    boolean loopback,
    int cycle,
    int volume)

开始播放指定音效文件。你可以在该方法中设置音效文件的播放次数、音量大小，以及远端用户是否能听到该音效。

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 调用该方法播放音效结束后，应用会收到 onAudioEffectFinished 回调。
• 可以多次调用该方法，通过传入不同的音效文件的 soundId 和 filePath，以实现同时播放多个音效文件，实现音效叠加。
• 可以通过 stopEffect 方法停止播放指定音效文件。
• 请在房间内调用该方法。

preloadEffect

public abstract int com.ss.bytertc.engine.RTCEngine.preloadEffect(
    int soundId,
    String filePath)

预加载指定音效文件

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 调用该方法预加载播放指定音效文件。预加载操作可以在进房间之前完成（所有混音相关接口，如果没有标注请在房间内调用都可在没有进入房间的时候调用）。如果音效文件很长，加载操作可能会耗时较长，建议应用开发者将预加载操作放在子线程进行。
• 该方法只是预加载播放指定音效文件，只有通过 playEffect 才开始播放指定音效文件。
• 该方法预加载指定音效文件可以通过 unloadEffect 来卸载。

unloadEffect

public abstract int com.ss.bytertc.engine.RTCEngine.unloadEffect(
    int soundId)

卸载指定音效文件

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 该方法卸载指定音效文件。
• 如果调用 stopEffect 方法时音效文件没有被卸载，SDK会自动调用该方法卸载音效文件。

stopEffect

public abstract int com.ss.bytertc.engine.RTCEngine.stopEffect(
    int soundId)

停止播放指定音效文件

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 该方法停止播放指定音效文件。
• 该方法内部会主动调用 unloadEffect 来卸载指定音效文。

pauseEffect

public abstract int com.ss.bytertc.engine.RTCEngine.pauseEffect(
    int soundId)

暂停播放指定音效文件

传入参数

返回值

• 0: 成功
• <0: 失败

注意 调用该方法暂停播放指定音效文件，可以调用 resumeEffect 方法恢复播放。

resumeEffect

public abstract int com.ss.bytertc.engine.RTCEngine.resumeEffect(
    int soundId)

恢复播放指定音效文件

传入参数

返回值

• 0: 成功
• <0: 失败

注意

• 调用 pauseEffect 方法暂停播放指定音效文件后， 可以通过该方法恢复播放。
• 调用 pauseAllEffects 方法暂停所有音效文件的播放后，也可以通过该方法恢复单个音效文件播放。

stopAllEffects

public abstract int com.ss.bytertc.engine.RTCEngine.stopAllEffects()

停止所有音效文件的播放

返回值

• 0: 成功
• <0: 失败

注意 该方法停止所有音效文件的播放。

unloadAllEffects

public abstract int com.ss.bytertc.engine.RTCEngine.unloadAllEffects()

卸载所有音效文件

返回值

• 0: 成功
• <0: 失败

注意

• 调用该方法卸载所有音效文件。如果引擎被销毁时有音效文件没有被卸载，SDK会自动调用该方法卸载所有音效文件。
• 调用 leaveRoom 离开房间后，不会自动调用该方法卸载所有音效文件。如果需要在离开房间后卸载所有音效文件，需要应用主动调用该方法。

pauseAllEffects

public abstract int com.ss.bytertc.engine.RTCEngine.pauseAllEffects()

暂停所有音效文件的播放

返回值

• 0: 成功
• <0: 失败

注意 该方法暂停所有音效文件的播放，可调用 resumeAllEffects 方法恢复播放。

resumeAllEffects

public abstract int com.ss.bytertc.engine.RTCEngine.resumeAllEffects()

恢复所有音效文件的播放

返回值

• 0: 成功
• <0: 失败

注意

• 调用该方法恢复所有音效文件的播放。在调用 pauseAllEffects 暂停所有音效文件的播放后，可以调用该方法可恢复所有音效文件的播放。
• 调用 pauseEffect 方法暂停单个指定音效文件的播放后，也可以调用该方法恢复播放，但是效率太低，不推荐这么使用。

setRecordingAudioFrameParameters

public abstract boolean com.ss.bytertc.engine.RTCEngine.setRecordingAudioFrameParameters(
    int sampleRate,
    int channels)

设置本地麦克风录制的音频数据回调参数

传入参数

返回值 方法调用结果

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

注意 使用本方法设置参数，并使用registerAudioFrameObserver注册数据观察者，之后可以在IAudioFrameObserver的 onRecordAudioFrame收到数据

setPlaybackAudioFrameParameters

public abstract boolean com.ss.bytertc.engine.RTCEngine.setPlaybackAudioFrameParameters(
    int sampleRate,
    int channels)

设置远端所有用户音频数据混音后的音频数据回调参数

传入参数

返回值 方法调用结果

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

注意 使用本方法设置参数，并使用registerAudioFrameObserver注册数据观察者，之后可以在IAudioFrameObserver的 onPlaybackAudioFrame收到数据

setMixedAudioFrameParameters

public abstract boolean com.ss.bytertc.engine.RTCEngine.setMixedAudioFrameParameters(
    int sampleRate,
    int channels)

设置本地麦克风录制音频数据和远端所有用户音频数据混音后的音频数据回调参数

传入参数

返回值 方法调用结果

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

注意 使用本方法设置参数，并使用registerAudioFrameObserver注册数据观察者，之后可以在IAudioFrameObserver的 onMixedAudioFrame收到数据

registerAudioFrameObserver

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

注册音频数据回调观察者

传入参数

返回值 方法调用结果

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

注意 本方法需要与下面3个方法配合使用：setRecordingAudioFrameParameters、 setPlaybackAudioFrameParameters、 setMixedAudioFrameParameters

setVideoInputType

public abstract void com.ss.bytertc.engine.RTCEngine.setVideoInputType(
    MediaInputType type)

配置视频采集源。

传入参数

注意

• 1. 该方法在进房前后均可以调用。
• 1. 当你已调用 startVideoCapture 开启内部采集后，再调用此方法切换至自定义采集时，SDK 会自动关闭内部采集。
• 1. 当你已开启自定义采集后，想要切换至内部采集，你必须先调用此方法指定使用内部采集，然后调用 startVideoCapture 手动开启内部采集。

pushExternalVideoFrame

public abstract boolean com.ss.bytertc.engine.RTCEngine.pushExternalVideoFrame(
    RTCVideoFrame frame)

推送外部视频帧。

传入参数

返回值

• true: 成功
• false: 失败

注意

• 该方法主动将视频帧数据用 RTCVideoFrame 类封装后传递给 SDK。
• 请确保在你调用本方法前已调用 setVideoInputType，并将参数 pushMode 设为 true，不然调用本方法后会一直报错。
• 当使用纹理数据时， 确保 createEngine中的eglContext与frame中的eglContext为sharedContext或者相同，否则会无法编码

pushExternalVideoFrame

public abstract boolean com.ss.bytertc.engine.RTCEngine.pushExternalVideoFrame(
    RTCVideoFrame frame,
    boolean isDirectEncode)

推送外部视频帧。

传入参数

返回值

• true: 成功
• false: 失败

注意

• 该方法主动将视频帧数据用 RTCVideoFrame 类封装后传递给 SDK。
• 请确保在你调用本方法前已调用 setVideoInputType，并将参数 pushMode 设为true，不然调用本方法后会一直报错。
• 当使用纹理数据时， 确保 createEngine中的eglContext与frame中的eglContext为sharedContext或者相同，否则会无法编码

startLiveTranscoding

public abstract void com.ss.bytertc.engine.RTCEngine.startLiveTranscoding(
    LiveTranscoding liveTranscode,
    ILiveTranscodingObserver observer)

开启合流转推，并设置合流的视频视图布局和音频属性。

传入参数

注意

• 启用服务端转推时，设置 observer 为 null。
• 调用该方法后，启动结果和推流过程中的错误均会通过回调 onLiveTranscodingResult 通知用户。

stopLiveTranscoding

public abstract void com.ss.bytertc.engine.RTCEngine.stopLiveTranscoding()

停止合流转推。

updateLiveTranscoding

public abstract void com.ss.bytertc.engine.RTCEngine.updateLiveTranscoding(
    LiveTranscoding transcoding)

更新合流转推参数。
启用合流转推功能后，你可以使用此方法更新合流转推功能配置参数。

传入参数

setVideoEncoderConfig

public abstract int com.ss.bytertc.engine.RTCEngine.setVideoEncoderConfig(
    List<VideoStreamDescription> videoStreamDescriptions)

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

传入参数

返回值

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

setVideoEncoderConfig

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

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

传入参数

返回值

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

enableAutoSubscribe

public abstract void com.ss.bytertc.engine.RTCEngine.enableAutoSubscribe(
    SubscribeMode audioMode,
    SubscribeMode videoMode)

开启/关闭自动订阅功能。
用户调用此方法设置房间中是否开启自动订阅功能。SDK 默认开启自动订阅功能。
如需关闭自动订阅功能，建议在调用 joinRoom 方法加入房间前设置完成。

传入参数

注意

• SDK 提供两种订阅模式：1.自动订阅模式，开启自动订阅功能时，SDK 自动帮助用户订阅房间中所有其他用户发布的音视频流；2.手动订阅模式，关闭自动订阅功能时，SDK不会自动订阅房间内的音视频流，只通过 onStreamAdd 和 onStreamRemove 回调通知用户当前所在房间中有哪些音视频流，由用户根据自己的需要调用 subscribeStream 方法手动订阅其他用户发布的音视频流。

subscribeStream

public abstract void com.ss.bytertc.engine.RTCEngine.subscribeStream(
    String userId,
    SubscribeConfig info)

订阅指定的房间内远端音视频流。
关闭自动订阅功能，使用手动订阅模式时用户调用此方法按需订阅房间中的音视频流。
此方法仅在关闭自动订阅功能时生效。用户需在加入房间前调用 enableAutoSubscribe 方法关闭自动订阅功能以使用手动订阅模式。
订阅流失败时，SDK 会按失败原因回调 onError 通知用户，具体错误可参考错误码 ErrorCode 描述。

传入参数

注意

• 此方法仅支持订阅当前房间中的远端音视频流。如果指定的流在当前房间内不曾存在，则 SDK 不会订阅。
• 用户调用 joinRoom 方法加入房间后：1.当房间内有新的音视频流发布时，本端会收到 onStreamAdd 回调通知；2.当房间内音视频流停止发布时，本端会收到 onStreamRemove 回调通知。通过这两个回调用户可以获得当前房间中的音视频流信息，并在需要时调用此方法订阅该音视频流。

unSubscribe

public abstract void com.ss.bytertc.engine.RTCEngine.unSubscribe(
    String userId,
    boolean isScreen)

停止订阅指定的房间内远端音视频流。
关闭自动订阅功能，使用手动订阅模式时用户调用此方法停止订阅已订阅的音视频流。
此方法仅在开启手动订阅功能时生效，用户需在加入房间前调用 enableAutoSubscribe 方法关闭自动订阅功能以使用手动订阅模式。

传入参数

注意

• 不管是否订阅了指定的远端音视频流，都可以调用此方法停止订阅。停止订阅的 streamId 无效或未订阅时，SDK不会做任何处理，没有负面影响。

enableExternalAudioDevice

public abstract void com.ss.bytertc.engine.RTCEngine.enableExternalAudioDevice(
    AudioFormat recordingFormat,
    AudioFormat playbackFormat)

启用自定义音频采集渲染

传入参数

注意

• 此方法需要在进房前调用。
• 启用自定义音频采集渲染的状态在离开房间后仍然有效，会一直持续到调用 disableExternalAudioDevice 关闭自定义音频采集渲染为止。
• 启用自定义音频采集渲染后，仍需要使用 pushExternalAudioFrame，推送外部音频数据，再使用 pullExternalAudioFrame 拉取外部音频数据。
• 当你已调用 startAudioCapture 开启内部采集后，再调用此方法切换至自定义采集时，SDK 会自动关闭内部采集。
• 当你调用此方法开启自定义采集后，想要切换至内部采集，你必须先调用 disableExternalAudioDevice 关闭自定义采集，然后调用 startVideoCapture 手动开启内部采集。

disableExternalAudioDevice

public abstract void com.ss.bytertc.engine.RTCEngine.disableExternalAudioDevice()

禁用已开启的自定义音频采集渲染，将音频采集渲染由自定义模块切换至内部模块。

注意

• 如果你已开启自定义音频采集渲染，你可以在进房前，使用本接口将音频采集渲染由自定义模块切换至内部模块。
• 使用该 API 禁用自定义音频采集渲染后， SDK 不会自动开启内部的音频采集，需要开启 SDK 内部采集请使用 startAudioCapture。
• 启用自定义音频采集渲染请使用 enableExternalAudioDevice。此方法需要在进房前调用。

pushExternalAudioFrame

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

推送外部音频数据。

传入参数

返回值 方法调用结果

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

注意

• 推送外部音频数据前，必须开启自定义采集。
• 本方法中设置的 sampleRate（音频采样率） 和 channel（音频声道） 必须与 enableExternalAudioDevice 中设置的 sampleRate 和 channel 保持一致。

• 此方法推送音频数据的间隔为 10 毫秒。 samples (音频采样点个数）应该为 audioFrame.sampleRate / 100， 如设置采样率为 48000 时， 每次应该推送 480 个采样点。

• 音频采样格式为 S16。音频缓冲区内的数据格式必须为 PCM 数据，其容量大小应该为 audioFrame.samples

• 该函数运行在用户级线程内。若同时运行其他进程，将导致本进程中断。

pullExternalAudioFrame

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

拉取外部音频数据。

传入参数

返回值 方法调用结果

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

注意

• 拉取外部音频数据前，必须开启自定义采集。
• 本方法中设置的 sampleRate（音频采样率） 和 channel（音频声道） 必须与 enableExternalAudioDevice 中设置的 sampleRate 和 channel 保持一致。

• 此方法拉取音频数据的间隔为 10 毫秒，音频采样格式为 S16。 samples (音频采样点个数）应该为 audioFrame.sampleRate / 100， 如设置采样率为 48000 时， 每次应该拉取 480 个采样点。

• 音频采样格式为 S16。音频缓冲区内的数据格式必须为 PCM 数据，其容量大小应该为 audioFrame.samples

• 该函数运行在用户级线程内。若同时运行其他进程，将导致本进程中断。

publishScreen

public abstract int com.ss.bytertc.engine.RTCEngine.publishScreen()

发布本地屏幕共享流。

返回值 0 :发布成功

-1 :发布失败

注意 1. 直播、游戏、云游戏房间模式下，此方法仅适用于角色为主播的用户。应用可以通过调用 setUserRole 方法设置用户角色。 2. 调用此方法发布本端屏幕共享流后，用户还需要通过设置定时任务周期性调用 pushScreenFrame 方法，将需要发送的屏幕数据推送给 SDK。 3. 调用该接口后远端能收到 onFirstRemoteVideoFrameRendered 和 onStreamAdd 事件。 4. 调用该接口后本地能收到 onFirstLocalVideoFrameCaptured 事件。

unpublishScreen

public abstract int com.ss.bytertc.engine.RTCEngine.unpublishScreen()

停止发布本地屏幕共享流。

返回值 0 :发布成功

-1 :发布失败

注意 调用该接口后远端会收到 onStreamRemove 事件

startScreenSharing

public abstract int com.ss.bytertc.engine.RTCEngine.startScreenSharing(
    Intent mediaProjectionResultData,
    ScreenSharingParameters parameters)

开启屏幕共享。

传入参数

返回值 0 :开启成功

-1 :开启失败

注意 1. 直播、游戏、云游戏房间模式下，此方法仅适用于角色为主播的用户。应用可以通过调用 setUserRole 方法设置用户角色。 2. 调用此方法发布本端屏幕共享流后，内部会自动采集当前屏幕数据 3. 调用该接口后远端能收到 onFirstRemoteVideoFrameRendered 和 onStreamAdd 事件。 4. 调用该接口后本地能收到 onFirstLocalVideoFrameCaptured 事件。

updateScreenSharingParameters

public abstract int com.ss.bytertc.engine.RTCEngine.updateScreenSharingParameters(
    ScreenSharingParameters parameters)

修改屏幕共享流参数。

传入参数

返回值 0 :开启成功

-1 :开启失败

stopScreenSharing

public abstract int com.ss.bytertc.engine.RTCEngine.stopScreenSharing()

关闭屏幕共享。

返回值 0 :关闭成功

-1 :关闭失败

注意 调用该接口后远端会收到 onStreamRemove 事件

pushScreenFrame

public abstract boolean com.ss.bytertc.engine.RTCEngine.pushScreenFrame(
    RTCVideoFrame videoFrame)

发布共享屏幕视频帧

传入参数

返回值 true :发布成功 false :发布失败

setOnDestroyCompletedCallback

public abstract void com.ss.bytertc.engine.RTCEngine.setOnDestroyCompletedCallback(
    Runnable callback)

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

传入参数

setAudioPlayoutMixStream

public abstract void com.ss.bytertc.engine.RTCEngine.setAudioPlayoutMixStream(
    boolean enable,
    int sampleRate,
    int channelNum)

启动/停止外部音频流混音， 并设置混音数据格式

传入参数

注意

• 调用该方法设置外部音频混音的PCM格式，即 pushAudioMixingStreamData 的 audioFrame 的音频数据格式。
• 调用该方法混音的数据来源外部缓存，且音频格式为PCM； startAudioMixing 方法混音数据来源外部文件，且支持的文件格式有: mp3，aac，m4a，3gp，wav。这两种混音方式可以共存。
• enable 为 false 时，停止外部音频流混音。 或者引擎释放时，SDK内部会停止混音。
• 该方法启动的外部音频流混音不支持音量调节，暂停，暂停恢复操作。

getAudioMixingStreamCachedFrameNum

public abstract int com.ss.bytertc.engine.RTCEngine.getAudioMixingStreamCachedFrameNum()

获取SDK当前缓冲数据

返回值

• >0: 成功，缓冲的音频采样点个数。
• 0: 失败

注意 调用该方法可以实时获取缓存数据量，并以此数据为基准调整数据推送节奏来避免内存溢出

pushAudioMixingStreamData

public abstract boolean com.ss.bytertc.engine.RTCEngine.pushAudioMixingStreamData(
    byte[] audioFrame,
    int frameNum)

向SDK推送混音的音频数据

传入参数

返回值

• true: 成功
• false: 失败

注意

• 调用该方法前，必须通过 setAudioPlayoutMixStream 方法设置 audioFrame 的数据格式。
• 调用该方法前，先通过 getAudioMixingStreamCachedFrameNum 获取缓存的数据量，并调整推送数据的节奏以避免内部缓存溢出导致推送失败。
• 使用参考建议：首次推送数据，请在应用侧先缓存一定数据（如 200 毫秒）， 然后一次性推送过去；此后的推送操作定时 10 毫秒一次，并且每次的音频数据量为 10 毫秒数据量。

setRemoteAudioPlaybackVolume

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

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

传入参数

setPublishFallbackOption

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

设置发布的音视频流回退选项。
你可以调用这个接口来设置网络情况不佳或性能不足时只发送小流，以保证通话质量。

传入参数

返回值

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

注意

• 这个方法只在设置了发送多个流的情况下有效。
• 你必须在进房前设置，进房后设置或更改设置无效。

• 设置回退选项后，本端发布的音视频流发生回退或从回退中恢复时，对端会收到 onSimulcastSubscribeFallback 回调通知。

• 你可以调用 API 或者在服务端下发策略设置回退。当使用服务端下发配置实现时，下发配置优先级高于在客户端使用 API 设定的配置。

setRemoteSubscribeFallbackOption

public abstract int com.ss.bytertc.engine.RTCEngine.setRemoteSubscribeFallbackOption(
    SubscribeFallbackOptions option)

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

传入参数

返回值

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

注意

• 在网络情况不理想、设备性能不足时，实时音视频的质量会下降。通过这个接口来设置网络情况不佳或性能不足时只订阅小流或音频流，以保证通话质量。
• 必须在进房前设置，进房后设置或更改设置无效。
• 设置回退选项后，本端订阅的音视频流发生回退或从回退中恢复时，会收到 onSimulcastSubscribeFallback 回调通知。
• 设置回退选项后，本端订阅的视频流因为回退分辨率发生变化时，会收到 onRemoteVideoSizeChanged 回调通知。

setRemoteUserPriority

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

设置用户优先级。

传入参数

返回值

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

注意

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

registerMetadataObserver

public abstract void com.ss.bytertc.engine.RTCEngine.registerMetadataObserver(
    IMetadataObserver observer)

注册 metadata 观察者，用于接收或发送 metadata，底层通过在视频帧中添加 SEI 数据实现该功能。
注册观察者后，发送的视频帧里面没有 SEI 信息， 会触发 onReadyToSendMetadata 回调。
注册观察者后，接收的视频帧里面有 SEI 信息，会触发接收 onMetadataReceived 回调。

传入参数

注意

• 使用视频自定义采集与渲染时，可以直接在视频帧中添加与获取 metadata，不建议使用本接口。
• 本接口支持动态取消注册，将参数设置为 nullptr 取消注册。

setBusinessId

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

设置业务标识参数。
可通过 businessId 区分不同的业务场景（角色/策略等）。businessId 由客户自定义，相当于一个“标签”，可以分担和细化现在 AppId 的逻辑划分的功能。

传入参数

返回值

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

注意

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

setAudioPerformanceProfile

public abstract void com.ss.bytertc.engine.RTCEngine.setAudioPerformanceProfile(
    AudioPerformanceProfile profile)

通过设置音频处理策略等级，获得不同的音频处理质量，默认为 auto 模式。
auto 模式下，SDK 会根据应用所在机型等级，自动适配音频处理策略。一般情况下，使用 auto 模式就可满足你的音视频通话需求。
你应使用此方法，实现音频体验和系统性能占用之间的平衡:
如果你希望系统性能占用较低，你应设置较低的策略等级；如果你更在意音频质量，你应选择设置更高的策略等级。
音频处理策略详见 AudioPerformanceProfile。

传入参数

注意

• 如果你希望在此次音视频通话中设置音频处理策略等级，你必须在进房前调用此方法。
• 此设置会影响音频采集端在音频采集后，发送前对音频的处理策略，也会影响音频接收端在音频流接收后，播放前对音频的处理策略，达成不同的处理效果。
• 如果在进房后调用此方法，下次进房时才会应用你设置的策略等级。
• 如果以下策略无法满足需求，请联系技术支持人员实现自定义配置。

setEncryptInfo

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

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

传入参数

注意

• 该方法与 setCustomizeEncryptHandler 为互斥关系, 即按照调用顺序，最后一个调用的方法为最终生效的版本。

• 该方法必须在调用 joinRoom 之前调用，可重复调用，以最后调用的参数作为生效参数

• AES加密算法限制，超过36位的key会被截断，仅取前36位

setCustomizeEncryptHandler

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

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

传入参数

注意

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

• 无论加密或者解密，其对原始数据的长度修改，需要控制在90%-120%之间，即如果输入数据为100字节，则处理完成后的数据必须在 90至120自己之间，如果加密或解密结果超出该长度限制，则该音视频帧会被丢弃

• 数据加密/解密为串行执行，因而视实现方式不同，可能会影响到最终渲染效率，是否使用该方法，需要由使用方谨慎评估

checkVideoEffectLicense

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

视频特效许可证检查

传入参数

返回值 0: 许可证验证成功 !0: 许可证验证验证失败

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

setVideoEffectAlgoModelPath

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

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

传入参数

enableVideoEffect

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

创建/销毁视频特效引擎

传入参数

返回值 方法调用结果

• 0: 成功
• !0: 失败

注意

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

setVideoEffectPath

public abstract void com.ss.bytertc.engine.RTCEngine.setVideoEffectPath(
    List<String> effectPaths)

设置视频特效包，支持同时设置多个特效包

传入参数

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

addVideoEffectPath

public abstract void com.ss.bytertc.engine.RTCEngine.addVideoEffectPath(
    List<String> effectPaths)

增加特效包，支持同时增加多个特效包

传入参数

removeVideoEffectPath

public abstract void com.ss.bytertc.engine.RTCEngine.removeVideoEffectPath(
    List<String> effectPaths)

移除特效包，支持同时移除多个特效包

传入参数

updateVideoEffect

public abstract void com.ss.bytertc.engine.RTCEngine.updateVideoEffect(
    String effectPath,
    String key,
    float value)

设置特效强度

传入参数

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

setVideoEffectColorFilter

public abstract void com.ss.bytertc.engine.RTCEngine.setVideoEffectColorFilter(
    String resFile)

设置颜色滤镜

传入参数

setVideoEffectColorFilterIntensity

public abstract void com.ss.bytertc.engine.RTCEngine.setVideoEffectColorFilterIntensity(
    float intensity)

设置颜色滤镜强度

传入参数

startCloudRendering

public abstract void com.ss.bytertc.engine.RTCEngine.startCloudRendering(
    String effectInfo)

传入参数

updateCloudRendering

public abstract void com.ss.bytertc.engine.RTCEngine.updateCloudRendering(
    String effectInfo)

传入参数

stopCloudRendering

public abstract void com.ss.bytertc.engine.RTCEngine.stopCloudRendering()

setRuntimeParameters

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

设置运行时的参数

AudioFrame

public class com.ss.bytertc.engine.utils.AudioFrame

音频帧数据封装

成员变量

变量说明

buffer

public byte[] com.ss.bytertc.engine.utils.AudioFrame.buffer;

音频 PCM 数据

samples

public int com.ss.bytertc.engine.utils.AudioFrame.samples;

音频数据的采样点个数

sampleRate

public AudioSampleRate com.ss.bytertc.engine.utils.AudioFrame.sampleRate;

音频采样率

channel

public AudioChannel com.ss.bytertc.engine.utils.AudioFrame.channel;

音频声道

VideoStreamDescription

public class com.ss.bytertc.engine.VideoStreamDescription

视频流参数描述

成员变量

变量说明

videoSize

public Pair<Integer, Integer> com.ss.bytertc.engine.VideoStreamDescription.videoSize;

视频大小

frameRate

public int com.ss.bytertc.engine.VideoStreamDescription.frameRate;

视频帧率

maxKbps

public int com.ss.bytertc.engine.VideoStreamDescription.maxKbps;

最大码率

scaleMode

public ScaleMode com.ss.bytertc.engine.VideoStreamDescription.scaleMode = ScaleMode.SCALE_MODE_AUTO;

缩放策略，默认是拉伸

encodePreference

public EncoderPreference com.ss.bytertc.engine.VideoStreamDescription.encodePreference = EncoderPreference.MaintainFramerate;

编码策略偏好