setVideoDigitalZoomConfig method

FutureOr<int> setVideoDigitalZoomConfig(ByteRTCZoomConfigType type, float size)

@valid since 3.51 @detail api @hiddensdk(audiosdk) @author likai.666 @brief 设置本地摄像头数码变焦参数，包括缩放倍数，移动步长。 @param type 数码变焦参数类型，缩放系数或移动步长。参看 ByteRTCZoomConfigType{@link #ByteRTCZoomConfigType}。必填。 @param size 缩放系数或移动步长，保留到小数点后三位。默认值为 0。必填。
选择不同 type 时有不同的取值范围。当计算后的结果超过缩放和移动边界时，取临界值。
- ByteRTCZoomConfigTypeFocusOffset：缩放系数增量，范围为 0, 7。例如，设置为 0.5 时，如果调用 setVideoDigitalZoomControl:{@link #ByteRTCEngine#setVideoDigitalZoomControl} 选择 Zoom in，则缩放系数增加 0.5。缩放系数范围 1，8，默认为 1，原始大小。 - ByteRTCZoomConfigTypeMoveOffset：移动百分比，范围为 0, 0.5，默认为 0，不移动。如果调用 setVideoDigitalZoomControl:{@link #ByteRTCEngine#setVideoDigitalZoomControl} 选择的是左右移动，则移动距离为 size x 原始视频宽度；如果选择的是上下移动，则移动距离为 size x 原始视频高度。例如，视频帧边长为 1080 px，设置为 0.5 时，实际移动距离为 0.5 x 1080 px = 540 px。 @return - 0: 调用成功。 - < 0 : 调用失败。查看 ByteRTCReturnStatus{@link #ByteRTCReturnStatus} 获得更多错误说明。 @note - 每次调用本接口只能设置一种参数。如果缩放系数和移动步长都需要设置，分别调用本接口传入相应参数。 - 由于移动步长的默认值为 0 ，在调用 setVideoDigitalZoomControl:{@link #ByteRTCEngine#setVideoDigitalZoomControl} 或 startVideoDigitalZoomControl:{@link #ByteRTCEngine#startVideoDigitalZoomControl} 进行数码变焦操作前，应先调用本接口。

Implementation

FutureOr<int> setVideoDigitalZoomConfig(
    ByteRTCZoomConfigType type, float size) async {
  return await nativeCall(
      'setVideoDigitalZoomConfig:size:', [type.$value, size]);
}