加入和离开房间

百家云 AndroidSDK 使用 engine 对象来管理一个本地用户在房间内的行为，在进入房间之前需要先创建并初始化一个 engine 对象。

相关函数接口在 android-sdk 2.8.9 及以上版本支持

创建BRTC实例对象

调用 BRTC.sharedInstance 即可创建 BRTC 实例对象。在创建 engine 对象时，需要指定 context 参数，它是 Android 系统提供的关于应用环境全局信息的接口，必须设置，否则无法生成 BRTC 实例对象。建议传入 Android 平台的 ApplicationContext 。 请确保在调用其他 API 前先调用该方法创建并初始化。

BRTCListener brtcListener = new BRTCBaseListener() {
  @Override
  public void onEnterRoom(long result) {
      Log.d(TAG, "onEnterRoom: ");
  }
  //...
};
BRTC engine = BRTC.sharedInstance(VideoForMultipleUsersLogin.this);
engine.setListener(brtcListener);
BRTCDef.BRTCParams BRTCParams = new BRTCDef.BRTCParams(String.valueOf(GenerateTestUserSig.SDKAPPID),roomID, userID, uSig, BRTCDef.BRTCRoleType.BRTCRoleAnchor);
engine.enterRoom(BRTCParams);

监听 SDK 的事件

通过设置事件回调接口 BRTCListener ，您可以监听 SDK 在运行期间所发生的错误信息、警告信息、以及各种音视频事件，根据这些回调决定业务的后续动作。

BRTCListener brtcListener = new BRTCBaseListener() {
  @Override
  public void onEnterRoom(long result) {
      if (result > 0) {
          Log.d(TAG, "Enter room succeed");
      } else {
          Log.d(TAG, "Enter room failed");
      }

  }
  @Override
  public void onError(int errCode, String errMsg, Bundle extraInfo) {
      Log.d(TAG, "onError, errCode: " + errCode + ", errMsg: " + errMsg);
  }
  //...
};
BRTC engine = BRTC.sharedInstance(VideoForMultipleUsersLogin.this);
engine.setListener(brtcListener);

进房间参数

在调用 enterRoom 接口时需要填写输入关键参数 BRTCDef.BRTCParams

进入房间

准备好参数后，就可以调用 enterRoom 接口函数进入房间了

BRTC engine = BRTC.sharedInstance(VideoForMultipleUsersLogin.this);
engine.setListener(brtcListener);
BRTCDef.BRTCParams BRTCParams = new BRTCDef.BRTCParams("DeG1efkl3","123456789", "111111", "EesdFwfwwf34Ge", BRTCDef.BRTCRoleType.BRTCRoleAnchor);
engine.enterRoom(BRTCParams);

进入房间事件回调

• 如果进入房间成功，SDK 会回调 onEnterRoom(result) 事件，其中 result 会是一个大于 0 的数值，代表加入房间所消耗的时间，单位为毫秒（ms）。
• 如果进入房间失败，SDK 同样会回调 onEnterRoom(result) 事件，但参数 result 会是一个负数，其数值为进房失败的错误码。

BRTCListener brtcListener = new BRTCBaseListener() {
  @Override
  public void onEnterRoom(long result) {
    if (result > 0) {
        Log.d(TAG, "Enter room succeed");
    } else {
        Log.d(TAG, "Enter room failed");
    }
  }
  //...
};
BRTC engine = BRTC.sharedInstance(VideoForMultipleUsersLogin.this);
engine.setListener(brtcListener);

退出房间

调用 exitRoom 接口即可退出当前的房间，SDK 会在退房结束后通过 onExitRoom(int reason) 回调事件通知您。

• 调用 exitRoom 接口会执行退出房间的相关逻辑，例如释放音视频设备资源和编解码器资源等
• 待资源释放完毕，SDK 会通过 BRTCListener 中的 onExitRoom() 回调通知到您
• 如果您要再次调用 enterRoom() 或者切换到其他的音视频 SDK，请等待 onExitRoom() 回调到来之后再执行相关操作，否则可能会遇到摄像头或麦克风被占用等各种异常问题
• onExitRoom 函数中用户离开房间的原因有四种： 用户主动退出房间； 被踢出房间； 当前房间整个被解散；相同用户从其他端加入房间。建议您在这种情况下主动处理一下同一个用户多端登录，避免意想不到的问题 。
• 通过 server 端的 restfulAPI 接口可以踢出教室内某个用户，或者解散房间。

//调用接口主动退出房间
engine.exitRoom();

@Override
public void onExitRoom(int reason) {
    //退出房间的回调
    Log.d(TAG, "onExitRoom, reason: "+ reason);
}