# ScreenCaptureParameters (/zh-CN/api-reference/rtc/cpp-all-platforms/class-screencaptureparameters) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ```cpp struct ScreenCaptureParameters { bool captureAudio; ScreenAudioParameters audioParams; VideoDimensions dimensions; int frameRate; int bitrate; bool captureMouseCursor; bool windowFocus; view_t* excludeWindowList; int excludeWindowCount; int highLightWidth; unsigned int highLightColor; bool enableHighLight; }; ``` ## 属性 [#属性] :::note 注: 在文档共享场景中设置编码分辨率时,请参考建议设置方式。 ::: 屏幕共享视频流的编码分辨率。默认值为 1920 × 1080,即 2,073,600 像素。声网会根据该参数的值计算费用。如果屏幕尺寸与该参数值不同,SDK 会采用以下编码策略。假设 `dimensions` 设置为 1920 × 1080: - 如果屏幕尺寸小于 `dimensions`,例如 1000 × 1000 像素,SDK 使用屏幕尺寸(即 1000 × 1000 像素)进行编码。 - 如果屏幕尺寸大于 `dimensions`,例如 2000 × 1500 像素,SDK 会在保持屏幕宽高比(4\:3)的前提下,使用不超过 `dimensions` 的最大值进行编码,即 1440 × 1080。 详见 [VideoDimensions](/zh-CN/api-reference/rtc/cpp-all-platforms/class-videodimensions)。 在 Windows 和 macOS 上,表示屏幕共享视频流的编码帧率(fps)。默认值为 5。声网不建议设置超过 15 的值。 在 Windows 和 macOS 上,表示屏幕共享视频流的编码码率(Kbps)。默认值为 0,表示 SDK 会根据当前屏幕的分辨率自动计算码率。 :::note 注: 由于 macOS 系统限制,在屏幕共享时设置为 false 无效(共享窗口时不受影响)。 ::: 是否在屏幕共享中捕获鼠标: - true:(默认)捕获鼠标。 - false:不捕获鼠标。 :::note 注: 由于 macOS 系统限制,当设置该参数将窗口置于前台时,如果当前应用有多个窗口,只有主窗口会被置于前台。 ::: 调用 [startScreenCaptureByWindowId](/zh-CN/api-reference/rtc/cpp-all-platforms/video/screencapture#api_irtcengine_startscreencapturebywindowid) 方法共享窗口时,是否将该窗口置于前台: - true:将窗口置于前台。 - false:(默认)不将窗口置于前台。 要屏蔽的窗口 ID 列表。调用 [startScreenCaptureByDisplayId](/zh-CN/api-reference/rtc/cpp-all-platforms/video/screencapture#api_irtcengine_startscreencapturebydisplayid) 开始屏幕共享时,可使用该参数屏蔽指定窗口。调用 [updateScreenCaptureParameters](/zh-CN/api-reference/rtc/cpp-all-platforms/video/screencapture#api_irtcengine_updatescreencaptureparameters) 更新屏幕共享配置时,也可使用该参数动态屏蔽指定窗口。 要排除的窗口数量。 :::note 注: 在 Windows 平台上,该参数的最大值为 24;若超过此值,窗口排除将失败。 ::: (仅适用于 macOS 和 Windows)边框的宽度(像素)。默认值为 5,取值范围为 (0, 50]。 :::note 注: 仅当 `highLighted` 设置为 true 时该参数才生效。 ::: (仅适用于 macOS 和 Windows) - 在 Windows 平台上,边框颜色为 ARGB 格式。默认值为 0xFF8CBF26。 - 在 macOS 上,`COLOR_CLASS` 表示 `NSColor`。 :::note 注: 当共享窗口或屏幕的部分区域时,若设置该参数为 true,SDK 会在整个窗口或屏幕周围显示边框。 ::: (仅适用于 macOS 和 Windows)是否在共享的窗口或屏幕周围显示边框: - true:显示边框。 - false:(默认)不显示边框。