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