加入和离开房间

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

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

创建BRTC实例对象

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

self.brtc = [BRTC sharedInstance];
self.brtc.delegate = self;

监听 SDK 的事件

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

@interface BRTCVideoForMultipleUsersViewController () <BRTCDelegate>
@end

@implementation BRTCVideoForMultipleUsersViewController

- (void)createEngine {
    self.brtc = [BRTC sharedInstance];
    self.brtc.delegate = self;
    NSLog(@"🚀创建实例");
}
#pragma mark - 质量监测
- (void)onStatistics:(BRTCStatistics *)statistics {
    //添加推拉流质量数据处理逻辑
}
- (void)onExitRoom:(NSInteger)reason {
    //添加本用户退出房间处理逻辑
}
- (void)onEnterRoom:(NSInteger)result {
    //添加本用户进入房间处理逻辑
}

#pragma -mark - 远端用户回调函数
- (void)onRemoteUserEnterRoom:(NSString *)userId {
    //添加远端用户加入房间处理逻辑
}
- (void)onRemoteUserLeaveRoom:(NSString *)userId reason:(NSInteger)reason {
    //添加远端用户退出房间处理逻辑
}

#pragma -mark - 远端用户发布/取消发布音视频回调函数
- (void)onUserAudioAvailable:(NSString *)userId available:(BOOL)available {
    //添加远端用户发布/取消音频回调处理逻辑
}
- (void)onUserVideoAvailable:(NSString *)userId available:(BOOL)available {
    //添加远端用户发布/取消视频回调处理逻辑
}
- (void)onUserSubStreamAvailable:(NSString *)userId available:(BOOL)available {
    //添加远端用户发布/取消屏幕共享回调处理逻辑
}

- (void)onError:(int)errCode errMsg:(nullable NSString *)errMsg extInfo:(nullable NSDictionary*)extInfo {
    NSString *str = [NSString stringWithFormat:@"!!!: brtc错误回调: errMsg: %@, errCode: %d", errMsg, errCode];
    [self appendLog:str];
}
// ... 其他回调函数实现
@end

进房间参数

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

进入房间

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

self.brtc = [BRTC sharedInstance];
self.brtc.delegate = self;
BRTCParams *params = [BRTCParams new];
params.appID = appID;
params.sign = sig;
params.roomID = roomId;
params.role = BRTCRoleAnchor;
params.userID = userId;
//进入房间
[self.brtc enterRoom:params];

进入房间事件回调

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

@interface BRTCVideoForMultipleUsersViewController () <BRTCDelegate>
@end

@implementation BRTCVideoForMultipleUsersViewController

- (void)createEngine {
    self.brtc = [BRTC sharedInstance];
    self.brtc.delegate = self;
    NSLog(@"🚀创建实例");
    BRTCParams *params = [BRTCParams new];
    params.appID = appID;
    params.sign = sig;
    params.roomID = tempRoomID;
    params.userID = userId;

    [self.brtc enterRoom:params];
}
- (void)onEnterRoom:(NSInteger)result {
    if (result > 0) {
        [self appendLog:@"🚩 🚪 Login room success, spend %d ms", result];
        [self appendLog:@"开始推流"];
        [self.brtc startLocalPreview:YES view:self.localVideoView];
        [self.brtc muteLocalVideo:NO];
        [self.brtc startLocalAudio:BRTCAudioQualityDefault];
        [self.brtc muteLocalAudio:NO];
    } else {
        [self appendLog:@"🚩 ❌ 🚪 Login room fail"];
    }
}
// ... 其他回调函数实现
@end

退出房间

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

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

//调用接口主动退出房间
[self.brtc exitRoom];

- (void)onExitRoom:(NSInteger)reason {
    if (reason == 0) {
        NSLog(@"退出房间成功");
    } else if (reason == 1) {
        NSLog(@"被服务器踢出当前房间");
    } else if (reason == 2) {
        NSLog(@"当前房间被解散");
    }
}