VideoCaptureParameters

配置共享屏幕的视频参数。

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;
  }

自从

自 v3.7.0 版本新增。

仅当参数 captureVideo 为 true 时可用。

bitrate

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

framerate

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

width

信息

屏幕共享流的计费基于此参数值。当不传入该参数时，声网按 1280 × 720 收费；传入该参数时，声网按设置值计费。 该参数不代表输出视频的旋转方向，设置方向详见 ORIENTATION_MODE。 是否支持 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。

height

信息

屏幕共享流的计费基于此参数值。当不传入该参数时，声网按 1280 × 720 收费；传入该参数时，声网按设置值计费。 该参数不代表输出视频的旋转方向，设置方向详见 ORIENTATION_MODE。 是否支持 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。

contentHint

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

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