同时推送多路视频流
功能介绍
本节介绍如何在同一房间内同时推送多路视频画面,供远端选择观看。
多路视频流可来自系统摄像头、桌面摄像头、网络摄像头、自定义摄像头 等,可从getAllVideoInfo 获取。
注意:
成功进入房间后,才可以推送视频流;
1. 开启推送多路
- 先获取本端视频设备列表,得到除默认视频设备以外的,要额外推送的视频设备ID。
- 调用 setMutiVideos 设置额外推送的视频设备ID列表。
- 通过 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. 限制与注意
- 可推送的视频流数量、分辨率等限制与对应帐号授权有关。
- 同时推送多路视频流会增加编码与带宽开销,建议按需开启并合理设置分辨率与帧率(参见 视频推流质量配置)。