音视频通话

同时推送多路视频流

功能介绍

本节介绍如何在同一房间内同时推送多路视频画面,供远端选择观看。

在移动端设备上,系统摄像头同一时间只能开启一个(前摄或后摄),无法同时推两路系统摄像头的画面。因此,如需推送多路视频流,通常采用系统摄像头 + 网络摄像头或系统摄像头 + 自定义摄像头的组合方式来实现。

多路视频流可来自系统摄像头、网络摄像头、自定义摄像头 等,可从getAllVideoInfo 获取。

注意:

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

1. 典型场景:系统摄像头 + 网络摄像头

以接入一路 RTSP 监控画面为例,同时推送本端摄像头和网络摄像头:

// 1. 添加一个网络摄像头作为额外视频源
const url = "rtsp://192.168.1.100:554/stream1";
const jsonParam = JSON.stringify({ name: "监控画面", maxRetry: -1 });
const ipCamVideoID = sdk_engine.addIPCam(url, jsonParam);

// 2. 将网络摄像头加入到多路推送列表
sdk_engine.setMutiVideos([ipCamVideoID], 1);

// 3. 打开本端视频(默认摄像头 + 额外列表中的设备)
const myUserID = "12345678";
sdk_engine.openVideo(myUserID);

远端可通过 videoID 分别订阅不同视频画面。

2. 典型场景:系统摄像头 + 自定义摄像头

如果视频源来自自定义采集(如 Canvas 绘制、第三方采集等),可创建自定义摄像头后加入多路推送:

// 1. 创建自定义摄像头
const customVideoID = sdk_engine.createCustomVideoDev("自定义画面", CRVSDK_VIDEO_FORMAT.CRVSDK_VFMT_YUV420P, 640, 480);
// 送入视频帧数据
// sdk_engine.inputCustomVideoDat(customVideoID, frame);

// 2. 将自定义摄像头加入到多路推送列表
sdk_engine.setMutiVideos([customVideoID], 1);

// 3. 打开本端视频
sdk_engine.openVideo(myUserID);

3. 关闭推送多路

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

示例:

sdk_engine.setMutiVideos([], 0);

相关 API 请参考:

4. 限制与注意

  • 移动端系统摄像头同一时间只能推送一路(前摄或后摄),多路场景需借助网络摄像头或自定义摄像头实现。
  • 可推送的视频流数量、分辨率等限制与对应帐号授权有关。
  • 同时推送多路视频流会增加编码与带宽开销,建议按需开启并合理设置分辨率与帧率(参见 视频推流质量配置)。
  • 网络摄像头或自定义摄像头的添加和管理,详见 网络摄像头、自定义视频采集。