音视频通话

同时推送多路视频流

功能介绍

本节介绍如何在同一房间内同时推送多路视频画面,供远端选择观看。
多路视频流可来自系统摄像头、桌面摄像头、网络摄像头、自定义摄像头 等,可从getAllVideoInfo 获取。

注意:

成功进入房间后,才可以推送视频流;

1. 开启推送多路

  1. 先获取本端视频设备列表,得到除默认视频设备以外的,要额外推送的视频设备ID。
  2. 调用 setMutiVideos 设置额外推送的视频设备ID列表。
  3. 通过 openVideo 打开本端视频(开启视频推送)。 在openVideo后,也可调用 setMutiVideos 更新。

示例:

CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

// 假设已从 getAllVideoInfo 得到要额外发送的视频设备 ID 列表
int extraVideoIDs[] = { 2, 3 };
int count = 2;
meeting.setMutiVideos(extraVideoIDs, count);

std::string myUserID = "12345678";
meeting.openVideo(myUserID.c_str());

相关 API 请参考:

2. 关闭推送多路

在 openVideo 前或后,随时可调用 setMutiVideos 设置空列表,即可关闭多路视频流,只保留默认视频流。

示例:

CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
meeting.setMutiVideos(nullptr, 0);

相关 API 请参考:

3. 限制与注意

  • 可推送的视频流数量、分辨率等限制与对应帐号授权有关。
  • 同时推送多路视频流会增加编码与带宽开销,建议按需开启并合理设置分辨率与帧率(参见 视频推流质量配置)。