setVideoDigitalZoomConfig abstract method

Future<int?> setVideoDigitalZoomConfig({
  1. required ZoomConfigType type,
  2. double size,
})

设置本地摄像头数码变焦参数，包括缩放倍数，移动步长。

v3.51 新增。

type：数码变焦参数类型，缩放系数或移动步长。必填。

size：缩放系数或移动步长，保留到小数点后三位。默认值为 0。必填。
选择不同 type 时有不同的取值范围。当计算后的结果超过缩放和移动边界时，取临界值：

  • focusOffset：缩放系数增量，范围为 [0, 7]。例如，设置为 0.5 时，如果调用 setVideoDigitalZoomControl 选择 cameraZoomIn，则缩放系数增加 0.5。缩放系数范围 [1，8]，默认为 1，原始大小。
  • moveOffset：移动百分比，范围为 [0, 0.5]，默认为 0，不移动。如果调用 setVideoDigitalZoomControl 选择的是左右移动，则移动距离为 size x 原始视频宽度；如果选择的是上下移动，则移动距离为 size x 原始视频高度。例如，视频帧边长为 1080 px，设置为 0.5 时，实际移动距离为 0.5 x 1080 px = 540 px。

返回值：

  • 0：调用成功；
  • <0：调用失败，具体原因参看 ReturnStatus。

注意：

  • 每次调用本接口只能设置一种参数。如果缩放系数和移动步长都需要设置，分别调用本接口传入相应参数。
  • 由于移动步长的默认值为 0，在调用 setVideoDigitalZoomControl 或 startVideoDigitalZoomControl 进行数码变焦操作前，应先调用本接口。

Implementation

Future<int?> setVideoDigitalZoomConfig({
  required ZoomConfigType type,
  double size,
});