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;
    @CalledByNative("VideoCaptureParameters")
    public int getBitrate() {
      return bitrate;
    }
    @CalledByNative("VideoCaptureParameters")
    public int getFramerate() {
      return framerate;
    }
    @CalledByNative("VideoCaptureParameters")
    public int getWidth() {
      return width;
    }
    @CalledByNative("VideoCaptureParameters")
    public int getHeight() {
      return height;
    }
    @CalledByNative("VideoCaptureParameters")
    public int getContentHint() {
      return contentHint;
    }
    @Override
    public String toString() {
      return "VideoCaptureParameters{"
          + "bitrate=" + bitrate + ", framerate=" + framerate + ", width=" + width
          + ", height=" + height + ", contentHint=" + contentHint + '}';
    }
  }

仅适用于 captureVideo 为 true 的场景。

width

视频编码分辨率中的宽 (px)。默认值为 1280。如果 width 和 height 的宽高比与屏幕像素值的宽高比不一致，SDK 会按照如下规则调节视频编码分辨率， 以 width × height 是 1280 × 720 为例：

• 当屏幕宽和高的像素值均小于 width 和 height 时，例如屏幕像素值为 640 × 360，SDK 以 640 × 360 编码。
• 当屏幕宽或高的像素值大于 width 或 height 时，例如屏幕像素值为 2000 × 1500，SDK 以屏幕像素值的宽高比，即 4:3，取 width × height 内最大分辨率进行编码，即 960 × 720。

信息

• 屏幕共享流的计费以 width 和 height 的值为准：当你未传值时，以 1280 × 720 计费；当你传值时，以你传入的值计费。
• 该值不代表最终视频输出的方向。请查阅 ORIENTATION_MODE 了解设置视频方向。
• 视频能否达到 720P 的分辨率取决于设备的性能，在性能配备较低的设备上有可能无法实现。如果采用 720P 分辨率而设备性能跟不上，则有可能出现帧率过低的情况。

信息

在共享文档的场景（SCREEN_SCENARIO_DOCUMENT）下设置编码分辨率时，选择以下两种方式其中之一。

• 如果你需要最优的画质，建议将编码分辨率设置为与采集分辨率相同。
• 如果你希望在画质、带宽和系统性能之间达到相对平衡，则：
  • 当采集分辨率大于 1920 × 1080 时，建议编码分辨率不低于 1920 × 1080。
  • 当采集分辨率低于 1920 × 1080 时，建议编码分辨率不低于 1280 × 720。

height

视频编码分辨率中的高 (px)。默认值为 720。如果 width 和 height 的宽高比与屏幕像素值的宽高比不一致，SDK 会按照如下规则调节视频编码分辨率，以 width × height 是 1280 × 720 为例：

• 当屏幕宽和高的像素值均小于 width 和 height 时，例如屏幕像素值为 640 × 360，SDK 以 640 × 360 编码。
• 当屏幕宽或高的像素值大于 width 或 height 时，例如屏幕像素值为 2000 × 1500，SDK 以屏幕像素值的宽高比，即 4:3，取 width × height 内最大分辨率进行编码，即 960 × 720。

信息

• 屏幕共享流的计费以 width 和 height 的值为准：当你未传值时，以 1280 × 720 计费；当你传值时，以你传入的值计费。
• 该值不代表最终视频输出的方向。请查阅 ORIENTATION_MODE 了解设置视频方向。
• 视频能否达到 720P 的分辨率取决于设备的性能，在性能配备较低的设备上有可能无法实现。如果采用 720P 分辨率而设备性能跟不上，则有可能出现帧率过低的情况。

信息

在共享文档的场景（SCREEN_SCENARIO_DOCUMENT）下设置编码分辨率时，选择以下两种方式其中之一。

• 如果你需要最优的画质，建议将编码分辨率设置为与采集分辨率相同。
• 如果你希望在画质、带宽和系统性能之间达到相对平衡，则：
  • 当采集分辨率大于 1920 × 1080 时，建议编码分辨率不低于 1920 × 1080。
  • 当采集分辨率低于 1920 × 1080 时，建议编码分辨率不低于 1280 × 720。

framerate

视频编码帧率 (fps)。默认值为 15。

bitrate

视频编码码率 (Kbps)。

contentHint

屏幕共享视频的内容类型。

• SCREEN_CAPTURE_CONTENT_HINT_NONE(0)：（默认）无指定的内容类型。
• SCREEN_CAPTURE_CONTENT_HINT_MOTION(1)：内容类型为动画。当共享的内容是视频、电影或视频游戏时，推荐选择该内容类型。
• SCREEN_CAPTURE_CONTENT_HINT_DETAILS(2)：内容类型为细节。当共享的内容是图片或文字时，推荐选择该内容类型。