音视频通话

视频大小流支持

功能介绍

SDK每一个视频设备,都支持出一路大流的同时,再出一路小流,供远端按需订阅显示,在清晰度与带宽之间做权衡。

1. 大小流概念

  • 大流:分辨率与码率较高,适合单人特写或需要高清的场景。每个视频设备的默认流,总是存在。
  • 小流:分辨率与码率较低,适合多路小图观看、弱网或省带宽场景。可选开启。

发送端在开启"小流"后,SDK 会具备同时编码并发送大流与小流的能力。但并不立即发送数据到网络,只有在房间内其他人订阅大流或小流时,SDK 才依据需求编码发送一路或两路。
订阅端在绑定视频组件时可指定请求大流或小流。
如果同时发送大小流时,会增加一定 CPU 与带宽开销。

2. 发送端开启大小流

大流默认都是开启的且不能关闭。其编码质量控制可参见 setVideoCfg 及 setLocVideoAttributes。
小流通过setLocVideoAttributes配置 quality2 开启或关闭。

配置示例(逻辑示意,具体字段以 API 文档为准):

import { CrSDK } from '@cr/react-native-rtc';

const videoID = 1; // 从 getAllVideoInfo 获取到的视频设备ID

const videoAttributes = await CrSDK.instance.getLocVideoAttributes(videoID);
// 开启小流,分辨率为288*160,码率为125000bps
videoAttributes.quality2Cfg = {
  size: { width: 288, height: 160 },
  fps: 15,
  maxbps: 125000,
};

await CrSDK.instance.setLocVideoAttributes(videoID, videoAttributes);

相关 API 与结构请参考:

3. 订阅端选择大流/小流

import { CrVideoView } from '@cr/react-native-rtc';

const qualityLv = 2; // 大流1,小流2

<CrVideoView
  usrVideoId={{ ...usrVideoId, qualityLv }}
  scaleType={0}
/>

4. 注意

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