加入和离开房间

BRTC Android SDK 使用 BRTC（或 BRTCEx）类实例来管理一个本地用户在房间内的行为，在进入房间之前需要先创建并初始化一个 BRTC（或 BRTCEx）类实例对象。

创建 BRTC 实例对象

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

BRTCListener brtcListener = new BRTCListener() {
  @Override
  public void onEnterRoom(long result) {
    if (result > 0) {
      Log.d(TAG, "onEnterRoom: Enter room succeed");
    } else {
      Log.d(TAG, "onEnterRoom: Enter room failed");
    }
  }
  //...
};
BRTC engine = BRTC.sharedInstance(context);
engine.setListener(brtcListener);
BRTCDef.BRTCParams params = new BRTCDef.BRTCParams(APP_ID, ROOM_ID, USER_ID, USER_SIG, ROLE_TYPE, APP_SCENE);
engine.enterRoom(params);

监听 SDK 的事件

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

BRTCListener brtcListener = new BRTCListener() {
  @Override
  public void onEnterRoom(long result) {
      if (result > 0) {
        Log.d(TAG, "onEnterRoom: Enter room succeed");
      } else {
        Log.d(TAG, "onEnterRoom: 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(context);
engine.setListener(brtcListener);

进房间参数

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

进入房间

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

BRTC engine = BRTC.sharedInstance(context);
engine.setListener(brtcListener);
// 其中 ROLE_TYPE 和 APP_SCENE 是可选参数，如果不设置，默认值为 BRTCRoleAnchor 和 BRTCAppScene_VIDEOCALL
BRTCDef.BRTCParams params = new BRTCDef.BRTCParams(APP_ID, ROOM_ID, USER_ID, USER_SIG, ROLE_TYPE, APP_SCENE);
engine.enterRoom(params);

进入房间事件回调

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

BRTCListener brtcListener = new BRTCListener() {
  @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(context);
engine.setListener(brtcListener);

退出房间

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

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

engine.exitRoom();

@Override
public void onExitRoom(int reason) {
    Log.d(TAG, "onExitRoom, reason: "+ reason);
}