音视频通话

视频大小流支持

功能介绍

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. 注意

  • 开启大小流会增加图像缩放开销、编码开销、上行带宽开销,建议在需要多路预览或弱网场景下使用。
  • 只有开启小流的端,才能被订阅,否则将订阅不到流看不到图像。
  • 小流分辨率与码率建议根据业务与带宽情况合理设置。