屏幕共享源获取和应用
功能介绍
开始屏幕共享前,通常需要让用户选择要共享的内容:整个屏幕、指定窗口或指定区域。
调用 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 参数;