视频大小流支持
功能介绍
SDK每一个视频设备,都支持出一路大流的同时,再出一路小流,供远端按需订阅显示,在清晰度与带宽之间做权衡。
1. 大小流概念
- 大流:分辨率与码率较高,适合单人特写或需要高清的场景。每个视频设备的默认流,总是存在。
- 小流:分辨率与码率较低,适合多路小图观看、弱网或省带宽场景。可选开启。
发送端在开启“小流”后,SDK 会具备同时编码并发送大流与小流的能力。但并不立即发送数据到网络,只有在房间内其他人订阅大流或小流时,SDK 才依据需求编码发送一路或两路。
订阅端在绑定视频组件时可指定请求大流或小流。
如果同时发送大小流时,会增加一定 CPU 与带宽开销。
2. 发送端开启大小流
大流默认都是开启的且不能关闭。其编码质量控制可参见 setVideoCfg 及 setLocVideoAttributes。
小流通过setLocVideoAttributes配置 quality2 开启或关闭。
配置示例(逻辑示意,具体字段以 API 文档为准):
// 开启小流,分辨率为288*160,码率为125000bps
int videoID = /* 从 getAllVideoInfo 获取到的视频设备ID */;
VideoAttributes videoAttributes = await RtcSDK.videoManager.getLocVideoAttributes(videoID);
videoAttributes.quality2Cfg = VideoCfg cfg = (size: VSize(width: 288, height: 160), fps: 15, maxbps: 125000);
RtcSDK.videoManager.setLocVideoAttributes(videoID, atvideoAttributestrs);
相关 API 与结构请参考:
3. 订阅端选择大流/小流
int qualityLv = 2; // 大流1,小流2
Widget videoComponent = RtcSDK.videoManager.createView((int vid) async {
viewID = vid;
// 视频组件订阅小流
await RtcSDK.videoManager.setUsrVideoId(vid, widget.usrVideoId,
qualityLv: qualityLv);
});
4. 注意
- 开启大小流会增加图像缩放开销、编码开销、上行带宽开销,建议在需要多路预览或弱网场景下使用。
- 只有开启小流的端,才能被订阅,否则将订阅不到流看不到图像。
- 小流分辨率与码率建议根据业务与带宽情况合理设置。