音视频通话

桌面摄像头

功能介绍

桌面摄像头允许将本地显示器画面作为一路"视频源"送入房间,类似于系统摄像头,但采集的是桌面画面而非物理摄像头图像。

1. 添加桌面摄像头

使用 createScreenCamDev 创建桌面摄像头。

const rtcsdk = new RTCSDK();

// 创建桌面摄像头
const videoID = rtcsdk.createScreenCamDev("桌面摄像头", -1);
// 返回值 >= 0 表示成功,videoID 为摄像头ID
// monitor 参数:-1 代表主屏

if (videoID >= 0) {
    // 添加成功后,可设为默认摄像头或加入多路推送
    rtcsdk.setDefaultVideo(videoID);
}
  • 最多支持添加 5 个桌面摄像头;
  • 添加成功后与本地摄像头处理一致,本地可通过 getAllVideoInfo 区分哪些是桌面摄像头;
  • 添加的摄像头在反初始化时删除。

2. 调整桌面摄像头

使用 updateScreenCamDev 调整桌面摄像头对应的屏幕。

const rtcsdk = new RTCSDK();
const result = rtcsdk.updateScreenCamDev(videoID, 1);
// monitor 为显示器编号,与系统编号一致,-1 代表主屏

3. 删除桌面摄像头

使用 destroyScreenCamDev 删除桌面摄像头。

const rtcsdk = new RTCSDK();
rtcsdk.destroyScreenCamDev(videoID);

相关 API 请参考: