音视频通话

屏幕共享源获取和应用

功能介绍

开始屏幕共享前,通常需要让用户选择要共享的内容:整个屏幕、指定窗口或指定区域。
调用 getScreenCaptureSources 可获取当前系统下可选的采集源列表,用于构建选择界面。

注意:屏幕采集源枚举支持 Windows 和 macOS 平台。

1. 获取采集源列表

  • 调用接口:
// 缩略图与图标尺寸
int thumbWidth = 224;
int thumbHeight = 126;
int iconWidth = 32;
int iconHeight = 32;

ScreenCaptureSourceInfoList infos = g_sdkMain.getSDKMeeting().getScreenCaptureSources(
    thumbWidth, thumbHeight, iconWidth, iconHeight);

// 遍历采集源列表
foreach (var scsInfo in infos)
{
    // scsInfo._sourceId:采集源 ID,用于 setScreenShareCfg
    // scsInfo._sourceTitle:窗口标题(窗口类型有效)
    // scsInfo._sourceName:采集源名称
    // scsInfo._thumbImage:缩略图,可用于 UI 展示
}

相关 API 请参考:

2. 采集源信息的应用

选择 _sourceId 后,将其传入 setScreenShareCfg 的配置中:

  • 共享整屏:使用屏幕类型的 _sourceId 作为 CRScreenShareCfg 的 monitorID
  • 共享指定窗口:使用窗口类型的 _sourceId 作为 catchWnd
  • 共享区域:不需要采集源 ID,将区域传给 catchRect 即可

详细配置示例见 屏幕共享质量配置。

相关 API 请参考: