VideoCaptureParameters
共享屏幕流的视频编码配置。
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 分辨率而设备性能跟不上,则有可能出现帧率过低的情况。
- 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 分辨率而设备性能跟不上,则有可能出现帧率过低的情况。
- framerate
- 视频编码帧率 (fps)。默认值为 15。
- bitrate
- 视频编码码率 (Kbps)。
- contentHint
- 屏幕共享视频的内容类型。
- SCREEN_CAPTURE_CONTENT_HINT_NONE(0):(默认)无指定的内容类型。
- SCREEN_CAPTURE_CONTENT_HINT_MOTION(1):内容类型为动画。当共享的内容是视频、电影或视频游戏时,推荐选择该内容类型。
- SCREEN_CAPTURE_CONTENT_HINT_DETAILS(2):内容类型为细节。当共享的内容是图片或文字时,推荐选择该内容类型。