实现一个音视频直播

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

开发环境要求

• Xcode11 或更高版本
• iOS10 或者更高版本
• 有效的 AppID
• 已在 iOS 项目成功集成 BRTC SDK,详见参考 一分钟集成 SDK

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

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

// 创建 BRTC 实例
_brtcClient = [BRTC sharedInstance];
_brtcClient.delegate = self;

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

// 错误通知监听，错误通知意味着 SDK 不能继续运行
- (void)onError:(int)errCode errMsg:(nullable NSString *)errMsg extInfo:(nullable NSDictionary*)extInfo{
    if (BRTC_ERR_ROOM_ENTER_FAIL == errCode) {
        NSLog(@"进房失败");
        [self._brtcClient exitRoom];
    }
}

进房间参数 BRTCParams

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

注意

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

创建并进入房间

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

- (void)enterRoom() {
    BRTCParams *params = [BRTCParams new];
    params.appId = _appId;
    params.roomId = _roomId;
    BRTCUser *user = [[BRTCUser alloc] init];
    user.userId = _userId;
    params.user = user;
    params.sign = _sig;
    [self.brtcClient enterRoom:params];
}

- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        NSLog(@"进房成功");
    } else {
        NSLog(@"进房失败");
    }
}

注意

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

发布本地的音视频流

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

//示例代码：设置视频编码参数
BRTCVideoEncParam *videoEncode = [BRTCVideoEncParam new];
BRTCRenderParams *renderParams = [BRTCRenderParams new];
[self._brtcClient setVideoEncoderParam:videoEncode];
[self._brtcClient setLocalRenderParams:renderParams];

//示例代码：发布本地的音视频流
[self._brtcClient startLocalPreview:_isFrontCamera view:self.view];
[self._brtcClient startLocalAudio];

订阅远端的音视频流

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

退出当前房间

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

// 调用退房后请等待 onExitRoom 事件回调
[self._brtcClient exitRoom];

- (void)onExitRoom:(NSInteger)reason {
    NSLog(@"离开房间: reason: %ld", reason)
}

注意

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