音视频通话

桌面摄像头

功能介绍

将指定屏幕、区域或窗口作为一路“摄像头”输入,与普通视频设备一样可设为默认或多路发送、被远端订阅观看。适用于想将屏幕分享到房间的场景。

1. 创建桌面摄像头

调用 createScreenCamDev(camName, jsonParam) 可添加一路桌面摄像头。

  • 返回值:≥0 表示成功,返回值为 videoID(视频设备 ID);<0 表示失败,参见 CRVSDK_ERR_DEF。
  • 数量:最多支持添加5路;创建的桌面摄像头在 CRVideoSDKMain 销毁时被删除。
  • 识别:通过 getAllVideoInfo 可获取本端视频设备列表,其中设备类型可区分桌面摄像头。

示例:

// 创建主屏为源的桌面摄像头
const char* name = "主屏";
const char* jsonParam = R"({"monitorID":-1})";
int videoID = meeting.createScreenCamDev(name, jsonParam);
if (videoID >= 0)
{
    // 可设为默认视频设备或加入 setMutiVideos 多路发送
}

相关 API 请参考:

2. 更新桌面摄像头

调用 updateScreenCamDev(videoID, jsonParam) 可调整该桌面摄像头对应的屏幕、区域或窗口,jsonParam 格式同 createScreenCamDev。

相关 API 请参考:

3. 删除桌面摄像头

调用 destroyScreenCamDev(videoID) 删除指定桌面摄像头。

相关 API 请参考:

4. 使用方式

  • 桌面摄像头创建后与普通视频设备一样出现在 getAllVideoInfo 中,可通过 setDefaultVideo 设为默认视频设备,或通过 setMutiVideos 作为多路之一发送。
  • 创建时若指定的 monitorID 对应屏幕不存在会失败;运行中若该屏幕关闭,画面会全黑,恢复后正常工作。

5. 与“屏幕共享”的对比

对比项 桌面摄像头 屏幕共享
分享数量 每个人都可以同时分享1~5个屏幕 整个房间同一时间只能有1人共享
屏幕声音 不支持 支持
远程协助 不支持 支持
协同标注 不支持 支持