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 分辨率而设备性能跟不上,则有可能出现帧率过低的情况。
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):内容类型为细节。当共享的内容是图片或文字时,推荐选择该内容类型。