视频大小流支持
功能介绍
SDK每一个视频设备,都支持出一路大流的同时,再出一路小流,供远端按需订阅显示,在清晰度与带宽之间做权衡。
1. 大小流概念
- 大流:分辨率与码率较高,适合单人特写或需要高清的场景。每个视频设备的默认流,总是存在。
- 小流:分辨率与码率较低,适合多路小图观看、弱网或省带宽场景。可选开启。
发送端在开启“小流”后,SDK 会具备同时编码并发送大流与小流的能力。但并不立即发送数据到网络,只有在房间内其他人订阅大流或小流时,SDK 才依据需求编码发送一路或两路。
订阅端在绑定 CLCameraView 时可指定请求大流或小流。
如果同时发送大小流时,会增加一定 CPU 与带宽开销。
2. 发送端开启大小流
大流默认都是开启的且不能关闭。其编码质量控制可参见 setVideoCfg 及 setLocVideoAttributes。
小流通过setLocVideoAttributes配置 quality2 开启或关闭。
配置示例(逻辑示意,具体字段以 Structs/API 文档为准):
// 开启小流,分辨率为288*160,码率为125000bps
RTCMeeting *meeting = [RTCMeeting shareInstance];
// 假设已从 getAllVideoInfo 获取到的视频设备ID
int videoID = videoDeviceID; // 替换为实际的视频设备ID
// 1. 先获取当前视频属性配置
CamAttribute *currentAttrs = [meeting getLocVideoAttributes:videoID];
// 2. 修改 quality2 配置(如果没有则创建)
if (currentAttrs.quality2_cfg == nil) {
currentAttrs.quality2_cfg = [[VideoCfg alloc] init];
}
currentAttrs.quality2_cfg.size = CGSizeMake(228, 160);
currentAttrs.quality2_cfg.maxbps = 120000;
// 3. 将修改后的配置设置回去
[meeting setLocVideoAttributes:videoID attributes:currentAttrs];
相关 API 与结构请参考:
3. 订阅端选择大流/小流
通过 CLCameraView.usrVideoId 绑定 userID、videoID 时,可指定请求大流或小流。未指定时为大流。
获取某路流的实时参数可使用 getVideoStreamInfo,用于展示分辨率、帧率、码率等。
相关 API 请参考:
4. 注意
- 开启大小流会增加图像缩放开销、编码开销、上行带宽开销,建议在需要多路预览或弱网场景下使用。
- 只有开启小流的端,才能被订阅,否则将订阅不到流看不到图像。
- 小流分辨率与码率建议根据业务与带宽情况合理设置。