观众端
获取资源
直播模式中主播发布的音视频流,会在服务端另行合并生成一道音频合流和一道视频合流。观众既可以直接订阅原始音视频流(简称“分流”),也可订阅“合流”。下面将分别介绍这两种订阅方式的区别和适用场景。
观众被定义为只能订阅不能发布,如需发布必须先转为主播身份,再进行资源的发布。
获取分流
分流订阅跟会议模式的订阅一样,适合小众玩法灵活的直播业务场景。比如观众被分成多种角色,需要选择性观看或收听部分主播发布的资源;又或者不同观众的展示布局并不相同,甚至可以随时切换布局的情况,SDK 提供视频展示 View 的创建和与流绑定接口,开发者自行编写展示逻辑。
观众的订阅需要在两个地方进行处理:一是在加入直播间的成功回调里,需要遍历得到房间内已经存在用户发布的流,并订阅;二是在收到主播刚刚发布流的通知,即 didPublishStreams 时订阅。
-
加入房间成功后,在回调中获取分流。
[[RCRTCEngine sharedInstance] joinRoom:@"你的房间id"
config:config
completion:^(RCRTCRoom * _Nullable room, RCRTCCode code) {
if (room.remoteUsers.count) {
NSMutableArray *streamArray = [NSMutableArray array];
for (RCRTCRemoteUser *user in room.remoteUsers) {
if (user.remoteStreams.count) {
[streamArray addObjectsFromArray:user.remoteStreams];
}
}
// 可以在此订阅streamArray
[self subscribeRemoteResource:streamArray];
}
}]; -
通过实现 RCRTCRoomEventDelegate 的 didPublishStreams 获取分流。
- (void)didPublishStreams:(NSArray<RCRTCInputStream *> *)streams {
//可以在此订阅streams
[self subscribeRemoteResource:streams];
}
获取合流
-
加入房间前远端直播合流已经发布,则通过加入房间后 RCRTCRoom 对象的 getLiveStreams 方法获得已经存在的直播合流。
[[RCRTCEngine sharedInstance] joinRoom:@"你的房间id"
config:config
completion:^(RCRTCRoom * _Nullable room, RCRTCCode code) {
// 观众获取 live 合流
NSArray *liveStreams = [room getLiveStreams];
if (liveStreams.count) {
// 观众可以在此订阅合流
}
}]; -
加入房间后远端直播合流发布,可以通过房间代理方法取得音视频流数组。
- (void)didPublishLiveStreams:(NSArray<RCRTCInputStream*> *)streams {
// 观众可以在此订阅合流
}
订阅资源
远端用户发布音视频流后,可以通过加入房间后返回的 RCRTCRoom 中的 subscribeStreams
方法订阅多路远端指定音视频流。同一个流只能填写在 avStreams
或 tinyStreams
中的一个数组中。
- (void)subscribeRemoteResource:(NSArray<RCRTCInputStream*> *)streams {
NSArray *tinyStream = isTiny ? streams : @[];
NSArray *ordinaryStream = isTiny ? @[] : streams;
// 订阅房间中远端用户音视频流资源
[[RCRTCEngine sharedInstance].room.localUser subscribeStreams:ordinaryStream
tinyStreams:tinyStream
callback:^(BOOL isSuccess, RCRTCCode desc, NSArray<RCRTCInputStream *> * _Nullable subscribeErrorList) {
if (desc != RCRTCCodeSuccess) {
return;
}
if (subscribeErrorList.count) {
// 您可以根据业务决定是否对 subscribeErrorList 中的流进行重新订阅,或仅作提示
}
// 创建并设置远端视频预览视图
NSInteger i = 0;
for (RCRTCInputStream *stream in streams) {
if (stream.mediaType == RTCMediaTypeVideo) {
BOOL isSubErrorStream = NO;
for (RCRTCInputStream *subErrorStream in subscribeErrorList) {
if ([stream.streamId isEqualToString:subErrorStream.streamId] && stream.mediaType == subErrorStream.mediaType) {
isSubErrorStream = YES;
break;
}
}
if (isSubErrorStream) {
continue;
}
if (i==0) {
// 1.初始化渲染远端视频的 view
RCRTCRemoteVideoView *view = [[RCRTCRemoteVideoView alloc] initWithFrame:CGRectMake(100, 400, 100, 100)];
// 2.设置视频流的渲染视图
[(RCRTCVideoInputStream *)stream setVideoView:view];
// 3.添加渲染视图
[self.view addSubview:view];
}else{
// 其他远端视图逻辑
}
i++;
}
}
}];
}
参数 | 类型 | 说明 |
---|---|---|
avStreams | RCRTCInputStream | 普通流 |
tinyStreams | RCRTCInputStream | 需要携带小流的流数组 |
callback | RCRTCSubscribeOperationCallback | 订阅资源完成的回调。callback 中 subscribeErrorList 为服务器返回的订阅失败列表。如果 isSuccess 为 YES 但是 subscribeErrorList 不为空,表示部分订阅成功,您可以根据业务决定是否对 subscribeErrorList 中的流进行重新订阅 |
取消订阅
观众可以调用 RCRTCRoom 的 unsubscribeStreams
方法取消订阅,取消订阅该用户的音视频流。退出房间时不需要取消订阅,SDK 内部会处理。
[[RCRTCEngine sharedInstance].room.localUser unsubscribeStreams:streams
completion:^(BOOL isSuccess, RCRTCCode code) {
}];
参数 | 类型 | 说明 |
---|---|---|
streams | NSArray | 音视频流 RCRTCInputStream 集合 |
completion | RCRTCOperationCallback | 取消订阅完成的回调 |
也可以取消订阅远端指定音视频流 RCRTCInputStream 对象。
[[RCRTCEngine sharedInstance].room.localUser unsubscribeStream:stream
completion:^(BOOL isSuccess,RCRTCCode desc) {
}];