# VideoCaptureParameters (/zh-CN/api-reference/rtc/android/class-screenvideoparameters)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="class_screenvideoparameters__prototype"></a>

```java
public static class VideoCaptureParameters {
    public int bitrate = 0;
    public int framerate = 15;
    public int width = 1280;
    public int height = 720;
    public int contentHint = Constants.SCREEN_CAPTURE_CONTENT_HINT_MOTION;
  }
```

<a id="class_screenvideoparameters__detailed_desc"></a>

:::info[自从]
自 v3.7.0 版本新增。
:::

仅当参数 `captureVideo` 为 true 时可用。

<a id="class_screenvideoparameters__parameters"></a>

## 属性 [#属性]

<ParameterList>
<a id="bitrate"></a>
<Parameter name="bitrate">

视频编码码率（单位：Kbps）。

</Parameter>
<a id="framerate"></a>
<Parameter name="framerate">

视频编码帧率（单位：fps），默认值为 15。

</Parameter>
<a id="width"></a>
<Parameter name="width">

:::note
注： 屏幕共享流的计费基于此参数值。当不传入该参数时，声网按 1280 × 720 收费；传入该参数时，声网按设置值计费。
该参数不代表输出视频的旋转方向，设置方向详见 [ORIENTATION_MODE](/zh-CN/api-reference/rtc/android/enum-orientationmode)。
是否支持 720p 或更高分辨率取决于设备性能，如设备不支持，则帧率可能低于设置值。
在文档共享（`SCREEN_SCENARIO_DOCUMENT`）场景中设置编码分辨率时，建议如下：

- 追求最佳画质：建议编码分辨率与采集分辨率一致；
- 平衡画质、带宽和系统性能：

  - 若采集分辨率大于 1920 × 1080，编码分辨率建议不小于 1920 × 1080；
  - 若采集分辨率小于 1920 × 1080，编码分辨率建议不小于 1280 × 720。
:::

视频编码分辨率的宽度（单位：px），默认值为 1280。如果宽高比与屏幕不一致，SDK 会按以下规则调整：以 1280 × 720 的宽高为例：

- 当屏幕宽高均小于设定值时，使用屏幕原始分辨率。例如，屏幕为 640 × 360，则编码分辨率使用 640 × 360；
- 当屏幕宽或高高于设定值时，SDK 会在不超过设定值的范围内，保持屏幕宽高比例调整分辨率。例如，屏幕为 2000 × 1500，则编码分辨率使用 960 × 720。

</Parameter>
<a id="height"></a>
<Parameter name="height">

:::note
注： 屏幕共享流的计费基于此参数值。当不传入该参数时，声网按 1280 × 720 收费；传入该参数时，声网按设置值计费。
该参数不代表输出视频的旋转方向，设置方向详见 [ORIENTATION_MODE](/zh-CN/api-reference/rtc/android/enum-orientationmode)。
是否支持 720p 或更高分辨率取决于设备性能，如设备不支持，则帧率可能低于设置值。
在文档共享（`SCREEN_SCENARIO_DOCUMENT`）场景中设置编码分辨率时，建议如下：

- 追求最佳画质：建议编码分辨率与采集分辨率一致；
- 平衡画质、带宽和系统性能：

  - 若采集分辨率大于 1920 × 1080，编码分辨率建议不小于 1920 × 1080；
  - 若采集分辨率小于 1920 × 1080，编码分辨率建议不小于 1280 × 720。
:::

视频编码分辨率的高度（单位：px），默认值为 720。如果宽高比与屏幕不一致，SDK 会按以下规则调整：以 1280 × 720 的宽高为例：

- 当屏幕宽高均小于设定值时，使用屏幕原始分辨率。例如，屏幕为 640 × 360，则编码分辨率使用 640 × 360；
- 当屏幕宽或高高于设定值时，SDK 会在不超过设定值的范围内，保持屏幕宽高比例调整分辨率。例如，屏幕为 2000 × 1500，则编码分辨率使用 960 × 720。

</Parameter>
<a id="contenthint"></a>
<Parameter name="contentHint">

共享屏幕场景下的内容提示选项：

- `SCREEN_CAPTURE_CONTENT_HINT_NONE`（0）：默认值，无内容提示；
- `SCREEN_CAPTURE_CONTENT_HINT_MOTION`（1）：运动内容，适用于偏重流畅度或共享影片、视频和游戏；
- `SCREEN_CAPTURE_CONTENT_HINT_DETAILS`（2）：静态内容，适用于偏重清晰度或共享图片、PPT 或文本内容。

</Parameter>
</ParameterList>