音视频通话

屏幕共享源获取和应用

功能介绍

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

1. 获取采集源列表

NSSize thumbSize = NSMakeSize(160, 90);
NSSize iconSize = NSMakeSize(32, 32);

// 获取屏幕和窗口类型的采集源
NSArray<CLScreenCaptureSourceInfo *> *sources = [[RTCMeeting shareInstance] 
    getScreenCaptureSources:thumbSize 
                   iconSize:iconSize 
                      types:CL_CAPSOURCE_SCREEN | CL_CAPSOURCE_WINDOW];

// 遍历所有采集源
for (CLScreenCaptureSourceInfo *info in sources) {
    // info.type:类型(屏幕/窗口)
    // info.sourceId:采集源ID,用于 setScreenShareCfg 的 monitorID 或 catchWnd
    // info.sourceTitle:窗口标题(窗口类型有效)
    // info.sourceName:采集源名称
    // info.thumbImage:缩略图,用于展示
    // info.iconImage:图标(窗口类型有效)
    // info.primaryMonitor:是否主屏(屏幕类型有效)
}
  • thumbSize:缩略图目标尺寸,用于在列表中展示采集源预览。
  • iconSize:图标目标尺寸,窗口类型的图标(如应用图标)。
  • types:源类型过滤,可取 CRSCREENCAPTURESOURCE_TYPE,如 CRCAPSOURCE_SCREEN CRCAPSOURCE_ALL 获取全部。

2. 采集源信息的应用

采集源信息,参见:CLScreenCaptureSourceInfo
其中_thumbImage, _iconImage 可转换成图像显示在ui上,以图像化供用户选择;

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

  • 共享整屏:使用屏幕类型的 _sourceId 传给 ScreenShareCfg的 monitorID 参数;
  • 共享指定窗口:使用窗口类型的 _sourceId 传给 ScreenShareCfg的 catchWnd 参数;

3. 相关 API