屏幕共享源获取和应用
功能介绍
开始屏幕共享前,通常需要让用户选择要共享的内容:整个屏幕、指定窗口或指定区域。
调用 getScreenCaptureSources 可获取当前系统下可选的采集源列表,用于构建选择界面。
1. 获取采集源列表
CRSize thumbSize;
thumbSize.cx = 160;
thumbSize.cy = 90;
CRSize iconSize;
iconSize.cx = 32;
iconSize.cy = 32;
// 获取屏幕和窗口类型的采集源
CRArray<CRScreenCaptureSourceInfo> sources = meeting.getScreenCaptureSources(
thumbSize, iconSize, CRVSDK_CAPSOURCE_SCREEN | CRVSDK_CAPSOURCE_WINDOW);
for (int i = 0; i < sources.getCount(); i++) {
const CRScreenCaptureSourceInfo& info = sources[i];
// info._type:类型(屏幕/窗口)
// info._sourceId:采集源ID,用于 setScreenShareCfg 的 monitorID 或 catchWnd
// info._sourceTitle:窗口标题(窗口类型有效)
// info._sourceName:采集源名称
// info._thumbImage:缩略图,用于展示
// info._iconImage:图标(窗口类型有效)
// info._primaryMonitor:是否主屏(屏幕类型有效)
}
- thumbSize:缩略图目标尺寸,用于在列表中展示采集源预览。
- iconSize:图标目标尺寸,窗口类型的图标(如应用图标)。
- types:源类型过滤,可取 CRVSDK_SCREENCAPTURESOURCE_TYPE,如 CRVSDK_CAPSOURCE_SCREEN(屏幕)、CRVSDK_CAPSOURCE_WINDOW(窗口),或 CRVSDK_CAPSOURCE_ALL 获取全部。
2. 采集源信息的应用
采集源信息,参见:CRScreenCaptureSourceInfo
其中_thumbImage, _iconImage 可转换成图像显示在ui上,以图像化供用户选择;
选择_sourceId 后,将其传入 setScreenShareCfg 的配置中:
- 共享整屏:使用屏幕类型的 _sourceId 传给 CRScreenShareCfg的 monitorID 参数;
- 共享指定窗口:使用窗口类型的 _sourceId 传给 CRScreenShareCfg的 catchWnd 参数;
- 共享区域:不需要采集源 ID,将区域传给CRScreenShareCfg的 catchRect 参数即可