VideoCaptureParameters

  • Android

更新时间不可用

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

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 或文本内容。
表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?