实现一个音视频直播

本文介绍如何 实现一个音视频直播, 视频直播的 API 调用时序见下图：

开发环境要求

• AAndroid Studio 3.6 及以上版本
• Android 4.4（SDK API 19）及以上系统
• 有效的 AppID
• 已在 Android 项目成功集成 BRTC SDK,详见参考 一分钟集成 SDK

初始化 SDK 实例并监听事件回调

• 使用 sharedInstance() 接口创建 BRTC 实例

// 创建 BRTC 实例
mBRTC = BRTC.sharedInstance(getApplicationContext());
mBRTC.setListener(new BRTCListener(){
// 回调处理
...
});

• 设置 setListener 属性注册事件回调，并监听相关事件和错误通知

// 错误通知监听，错误通知意味着 SDK 不能继续运行
@Override
public void onError(int errCode, String errMsg, Bundle extraInfo) {
Log.d(TAG, "sdk callback onError");
if (activity != null) {
    Toast.makeText(activity, "onError: " + errMsg + "[" + errCode+ "]" , Toast.LENGTH_SHORT).show();
    if (errCode == BRTCAVError.BRTC_ERR_ROOM_ENTER_FAIL) {
        activity.exitRoom();
    }
}
}

进房间参数 BRTCParams

• 在调用 enterRoom() 接口时需要填写一个关键参数 BRTCParams，该参数包含的必填字段如下表所示

注意

• 同一个房间内用户 ID 相同时，后进入的用户会将前一个用户踢出房间

创建并进入房间

• 调用 enterRoom() 即可加入对应的音视频房间。如果该房间不存在，SDK 会自动创建一个以字段 roomId 的值为房间号的新房间
• 进房成功后，SDK 会回调 onEnterRoom(result)事件。其中，参数result大于0时表示进房成功，具体数值为加入房间所消耗的时间，单位为毫秒（ms）；当result小于0时表示进房失败，具体数值为进房失败的错误码

public void enterRoom() {
  BRTCDef.BRTCParams brtcParams = new BRTCDef.BRTCParams(appId, roomId, new BRTCDef.BRTCUser(userId), sig);
  mBRTC.enterRoom(brtcParams);
}
@Override
public void onEnterRoom(long result) {
  if (result > 0) {
      toastTip("进房成功，总计耗时[\(result)]ms")
  } else {
      toastTip("进房失败，错误码[\(result)]")
  }
}

注意

• 如果进房失败，SDK 同时还会回调 onError 事件，并返回参数 errCode（错误码）、errMsg（错误原因）以及extraInfo（保留参数）
• 如果已在某一个房间中，则必须先调用 exitRoom() 退出当前房间，才能进入下一个房间

发布本地的音视频流

• 调用 startLocalAudio() 可以开启本地的麦克风采集，并将采集到的声音编码并发送出去
• 调用 startLocalPreview() 可以开启本地的摄像头，并将采集到的画面编码并发送出去
• 调用 setLocalRenderParams() 可以设置本地图像的渲染模式;
• 调用 setVideoEncoderParam() 接口可以设定本地视频的编码参数，该参数将决定房间里其他用户观看您的画面时所感受到的 画面质量

//示例代码：发布本地的音视频流
mBRTC.startLocalPreview(mIsFrontCamera, mLocalView);
mBRTC.startLocalAudio();

订阅远端的音视频流

• 当房间中有其他用户在上行音频数据时，您会收到 onUserAudioAvailable() 事件通知
• 您可以通过 muteRemoteAudio(userId, true) 屏蔽某一个 userId 的音频数据，也可以通过 muteAllRemoteAudio(true) 屏蔽所有远端用户的音频数据，屏蔽后 SDK 不再继续拉取对应远端用户的音频数据
• 当房间中有其他用户在上行视频数据时，您会收到 onUserVideoAvailable() 事件通知，但此时 SDK 未收到该如何展示视频数据的指令，因此不会自动处理视频数据。您需要通过调用 startRemoteView(userId, view) 方法将远端用户的视频数据和显示view关联起来
• 您可以通过 stopRemoteView(userId) 屏蔽某一个 userId 的视频数据，也可以通过 stopAllRemoteView() 屏蔽所有远端用户的视频数据，屏蔽后 SDK 不再继续拉取对应远端用户的视频数据

退出当前房间

• 调用 exitRoom() 方法退出房间，SDK 在退房时需要关闭和释放摄像头、麦克风等硬件设备，因此退房动作并非瞬间完成的，需收到 onExitRoom() 回调后才算真正完成退房操作

// 调用退房后请等待 onExitRoom 事件回调
mBRTC.exitRoom()
@Override
public void onExitRoom(int reason) {
  Log.i(TAG, "onExitRoom: reason = " + reason);
}

注意

• 如果您的 App 中同时集成了多个音视频 SDK，请在收到onExitRoom回调后再启动其它音视频 SDK，否则可能会遇到硬件占用问题