加入和离开房间

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

创建 BRTC 实例对象

调用 getBRTCShareInstance 即可创建 BRTC 实例对象，请确保在调用其他 API 前先调用该方法创建并初始化。

⚠️ 不要用 delete 销毁该 BRTC 实例对象，应该调用 destroyBRTCShareInstance 来销毁实例。同时确保在同一个线程里调用 getBRTCShareInstance 和 destroyBRTCShareInstance。

class BRTCCore : public BRTCCallback {
public:
   // interface BRTCCallback
   void onEnterRoom(int result) override;
   void onExitRoom(uint32_t reason) override;
   void onUserAudioAvailable(const char* userId, bool available) override;
   void onUserVideoAvailable(const char* userId, bool available) override;
   void onStatistics(const BRTCStatistics& statistics) override;
   void onError(BRTCAVError errCode, const char* errMsg, void* extraInfo) override;
private:
   BRTC* m_pBrtc = nullptr;
}

BRTCCore::BRTCCore() {
  m_pBrtc = getBRTCShareInstance();
  m_pBrtc->setCallback(this);
}

BRTCCore::~BRTCCore() {
  destroyBRTCShareInstance();
  m_pBrtc = nullptr;
}

void BRTCCore::enterRoom() {
  BRTCParams params;
  params.appID = "klskd0sd8sdfooi7we";
  params.roomID = "123456";
  params.sign = "9sdw9sssq";
  BRTCUser user;
  user.userId = "111111";
  params.user = user;
  m_pBrtc->enterRoom(params);
}

监听 SDK 的事件

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

class BRTCCore : public BRTCCallback {
 public:
   // interface BRTCCallback
   void onEnterRoom(int result) override;
   void onExitRoom(uint32_t reason) override;
   void onUserAudioAvailable(const char* userId, bool available) override;
   void onUserVideoAvailable(const char* userId, bool available) override;
   void onStatistics(const BRTCStatistics& statistics) override;
   void onError(BRTCAVError errCode, const char* errMsg, void* extraInfo) override;

 private:
   BRTC* m_pBrtc = nullptr;
}

BRTCCore::BRTCCore() {
  m_pBrtc = getBRTCShareInstance();
  m_pBrtc->setCallback(this);
}

进房间参数

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

进入房间

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

void BRTCCore::enterRoom() {
  BRTCParams params;
  params.appID = "klskd0sd8sdfooi7we";
  params.roomID = "123456";
  params.sign = "9sdw9sssq";
  BRTCUser user;
  user.userId = "111111";
  params.user = user;
  m_pBrtc->enterRoom(params);
}

进入房间事件回调

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

void BRTCCore::onEnterRoom(int result) {
  LOG(INFO) << "onEnterRoom, result[" << result << "]";
  if (result > 0) {
    // Success
  } else {
    // Fail
  }
}

退出房间

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

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

// 调用接口主动退出房间
m_pBrtc->exitRoom();

void BRTCCore::onExitRoom(uint32_t reason) {
  LOG(INFO) << "reason[" << reason << "]";
  // 添加退出房间回调的处理逻辑
}