音视频通话

视频大小流支持

功能介绍

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

1. 大小流概念

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

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

2. 发送端开启大小流

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

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

// 开启小流,分辨率为288*160,码率为125000bps

CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

int videoID = /* 从 getAllVideoInfo 获取到的视频设备ID */;
const char* attrs = R"({"quality2":{"size":"228*160", "maxbps":120000}})";
meeting.setLocVideoAttributes(videoID, attrs);

相关 API 与结构请参考:

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

通过 CRCanvas.setVideoID 或 CRCustomRenderHandler.setVideoID 绑定 userID、videoID 时,可指定请求大流或小流(如通过流类型参数或枚举 CRVSDK_VSTEAMLV_TYPE)。未指定时为大流。

获取某路流的实时参数可使用 getVideoStreamInfo,用于展示分辨率、帧率、码率等,参见 流质量与网络监测。

相关 API 请参考:

4. 注意

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