远端用户流
订阅
使用 subscribeStreams
方法订阅房间内其他用户的资源,可选择订阅大流或小流,大小流通过 avStreams
和 tinyStreams
区分。
以下两个时机需要处理订阅逻辑:
- 加入房间成功后通过
RCRTCRoom
对象取得用户资源列表,需要处理订阅逻辑。 - 资源发布代理触发后需要处理订阅逻辑。
- (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 中的流进行重新订阅 |
取消订阅
使用 unsubscribeStream
方法取消订阅一个或多个音视频流 RCRTCInputStream
。
- (void)unsubscribeStream:(NSArray <RCRTCInputStream *> *)streams
completion:(nonnull RCRTCOperationCallback)completion;
参数 | 类型 | 说明 |
---|---|---|
streams | NSArray | 发布的音视频流 RCRTCInputStream 数组 |
completion | RCRTCOperationCallback | 取消订阅的音视频流的回调 |