public abstract class com.ss.bytertc.rts.engine.RTS
java

RTS engine API class

public static synchronized RTS com.ss.bytertc.rts.engine.RTS.createRTS(
    Context context,
    String appId,
    IRTSEventHandler handler,
    JSONObject parameters)
java

创建引擎对象。

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

如果当前进程中已创建了引擎实例，再次调用此方法时，会创建另一个独立的引擎实例。

传入参数

返回值

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

public static synchronized void com.ss.bytertc.rts.engine.RTS.destroyRTS()
java

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

注意

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

public static String com.ss.bytertc.rts.engine.RTS.getSdkVersion()
java

获取 SDK 当前的版本号。

返回值
SDK 当前的版本号。

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

配置 SDK 本地日志参数，包括日志级别、存储路径、可使用的最大缓存空间。

传入参数

返回值

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

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

public abstract void com.ss.bytertc.rts.engine.RTS.setRtsEventHandler(
    IRTSEventHandler engineEventHandler)
java

设置引擎事件回调的接收类。

传入参数

注意

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

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

登录 RTS 服务器。

必须先登录，才能收发消息。

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

传入参数

返回值

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

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

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

登出 RTS 服务器。

调用本接口登出后，无法再调用消息相关的方法或收到相关回调。

返回值

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

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

public abstract int com.ss.bytertc.rts.engine.RTS.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.rts.engine.RTS.setServerParams(
    String signature,
    String url)
java

设置应用服务器参数。

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

传入参数

返回值

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

注意

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

public abstract int com.ss.bytertc.rts.engine.RTS.getPeerOnlineStatus(
    String peer_user_id)
java

查询本地/远端用户的登录状态。

在发送消息之前，你可以通过本接口了解对端用户是否登录，从而决定是否发送消息。也可以通过本接口查询自己查看自己的登录状态。

传入参数

返回值

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

注意

• 必须调用 login 登录后，才能调用本接口。
• 调用本接口后，SDK 会使用 onGetPeerOnlineStatus 回调通知查询结果。

public abstract long com.ss.bytertc.rts.engine.RTS.sendMessage(
    String uid,
    String message,
    MessageConfig config)
java

给指定的用户发送点对点文本消息（p2p）。

传入参数

返回值

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

注意

• 在发送点对点文本消息前，必须先调用 login 完成登录。
• 用户调用本接口发送文本信息后，会收到一次 onMessageSendResult 回调，通知消息发送结果。
• 若文本消息发送成功，则 uid 所指定的用户会通过 onMessageReceived 回调收到该消息。

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

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

传入参数

返回值

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

注意

• 在发送点对点二进制消息前，必须先调用 login 完成登录。
• 用户调用本接口发送二进制消息后，会收到一次 onMessageSendResult 回调，通知消息发送结果。
• 若二进制消息发送成功，则 uid 所指定的用户会通过 onBinaryMessageReceived 回调收到该条消息。

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

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

传入参数

返回值

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

注意

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

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

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

传入参数

返回值

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

注意

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

public abstract RTSRoom com.ss.bytertc.rts.engine.RTS.createRoom(
    String roomId)
java

创建房间实例。

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

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

传入参数

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

注意

• 如果需要加入的房间已存在，你仍需先调用本方法来获取 RTSRoom 实例，再调用 joinRoom 加入房间。
• 多房间模式下，创建多个房间实例需要使用不同的 roomId，否则会导致创建房间失败。

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

设置业务标识参数。

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

传入参数

返回值

• 0： 成功
• -2: RETURN_STATUS_PARAMETER_ERR(-2)，参数非法。

注意
该方法需要在调用 joinRoom 之前调用。

public abstract int com.ss.bytertc.rts.engine.RTS.setRuntimeParameters(
    JSONObject params)
java

设置运行时的参数

传入参数

返回值

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

public abstract int com.ss.bytertc.rts.engine.RTS.setCellularEnhancement(
    boolean enhance)
java

启用蜂窝网络辅助增强，改善通话质量。

传入参数

返回值
方法调用结果：

• 0: 成功。
• -1：失败，内部错误。

public abstract int com.ss.bytertc.rts.engine.RTS.setLocalProxy(
    List<LocalProxyConfiguration> configurations)
java

设置本地代理。

传入参数

注意

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

public abstract class com.ss.bytertc.rts.engine.RTSRoom
java

RTS room API class

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

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

public abstract int com.ss.bytertc.rts.engine.RTSRoom.joinRoom()
java

加入房间。

调用 createRoom 创建房间后，可调用该方法进房，在房间内收发广播消息。

返回值
方法调用结果：

• 0：成功。
• -2：失败，已经在房间内。
• -3：Room 为空。

注意

• 你需在调用 login 登陆 RTS 服务器后再加入房间。
• 本地用户调用此方法加入房间成功后，会收到 onRoomStateChanged 回调通知。
• 用户加入房间成功后，在本地网络状况不佳的情况下，SDK 可能会与服务器失去连接，此时 SDK 将会自动重连。重连成功后，本地会收到 onRoomStateChanged 回调通知。

public abstract int com.ss.bytertc.rts.engine.RTSRoom.setRTSRoomEventHandler(
    IRTSRoomEventHandler rtsRoomEventHandler)
java

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

传入参数

返回值

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

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

离开房间。

用户调用此方法离开房间，结束实时消息通信，释放所有通信相关的资源。

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

返回值

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

注意
如果调用此方法后立即销毁引擎，SDK 将无法触发 onLeaveRoom 回调。

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

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

传入参数

注意

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

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

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

传入参数

注意

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