大小流
大小流模式是指在发布资源时上传一大一小两道视频流。
SDK 默认为摄像头视频流打开发布大小流功能,即每个用户在发布视频资源时自动发布大小两个视频流。小流的分辨率默认跟随大流。
提示
在多人音视频通话过程中,大小流模式可有效减少下行带宽占用。订阅方可按需订阅小流。
小视频流与大视频流的分辨率对应关系如下:
大流分辨率 | 小流分辨率 | 比例 |
---|---|---|
176X144 | 176X144 | 11:9 |
180X180 | 180X180 | 1:1 |
256X144 | 256X144 | 16:9 |
240X180 | 240X180 | 4:3 |
320X180 | 256X144 | 16:9 |
240X240 | 180X180 | 1:1 |
320X240 | 240X180 | 4:3 |
360X360 | 180X180 | 1:1 |
480X360 | 240X180 | 4:3 |
640X360 | 256X144 | 16:9 |
480X480 | 180X180 | 1:1 |
640X480 | 240X180 | 4:3 |
720X480 | 240X180 | 3:2 |
848X480 | 256X144 | 9:5 |
960X720 | 240X180 | 4:3 |
1280X720 | 256X144 | 16:9 |
1920X1080 | 256X144 | 16:9 |
发布方开关大小流
发布本地视频流之前,可以通过 [RCRTCEngine sharedInstance].defaultVideoStream
取得将要发布的视频流。
设置 defaultVideoStream
对象中的 enableTinyStream
属性可以控制是否发布默认视频的小流视频,如下:
@property (nonatomic, assign, readwrite) BOOL enableTinyStream;
参数 | 类型 | 说明 |
---|---|---|
enableTinyStream | BOOL | 是否启用视频小流。 |
如果摄像头视频流,默认为开启。如果自定义视频流,默认为关闭。
[RCRTCEngine sharedInstance].defaultVideoStream.enableTinyStream = YES;
订阅方切换大小流
在订阅远端视频时或视频通话过程中,可通过 tinyStreams
和 avStreams
参数订阅或切换远端用户的大小视频流,同一个流只能填写在 avStreams 或 tinyStreams 中的一个数组中。
- (void)subscribeStream:(nullable NSArray<RCRTCInputStream *> *)avStreams
tinyStreams:(nullable NSArray<RCRTCInputStream *> *)tinyStreams
completion:(nullable RCRTCOperationCallback)completion;
参数 | 类型 | 说明 |
---|---|---|
avStreams | NSArray | 视频大流数组 |
tinyStreams | NSArray | 视频小流数组 |
completion | RCRTCOperationCallback | 订阅完成后回调 |
// avStreams 和 tinyAVStreams 中的 `RongInputAVStream` 对象可从上报的远端发布流的代理方法中取得
[[RCRTCEngine sharedInstance].room.localUser subscribeAVStream:avStreams
tinyStreams:tinyAVStreams
completion:^(BOOL isSuccess, RCRTCCode desc) {
}];