Skip to content

AVCaptureDevice:rampToVideoZoomFactor() 方法 ​

rampToVideoZoomFactor() 方法让画面以一个速度平滑地变焦到指定的倍数,而不是一下子跳过去。

语法 ​

rampToVideoZoomFactor(factor, { withRate })

参数 ​

factor

目标倍数,数。照 Number() 转换。应在 minAvailableVideoZoomFactor 到 maxAvailableVideoZoomFactor 之间。

options.withRate

速度,数,必填。含义是每秒放大到 2 的 withRate 次方倍:1 是每秒放大一倍,2 是每秒放大到 4 倍。照 Number() 转换。

返回值 ​

无(undefined)。方法当场返回,变焦在之后的一段时间里进行。变焦的过程在画面上看得到,未在真机验证。变焦什么时候结束没有事件。

异常 ​

TypeError

  • 没有 withRate:rampToVideoZoomFactor needs options.withRate(实测)。
  • factor 转不出有限数:rampToVideoZoomFactor must be a finite number, got …。
  • withRate 转不出有限数:withRate must be a finite number, got …。
  • 系统拒绝这个倍数,而且系统给的原因不属于下面两种。什么样的值会被拒绝未在真机验证。

RangeError、DOMException

系统拒绝时,抛哪一种照系统的原因分:系统说超出范围的是 RangeError,说现在的状态做不了的是 DOMException,name 是 'InvalidStateError',别的是 TypeError。信息是 rampToVideoZoomFactor: the system refused (…),括号里是系统给的原因。这一条来自代码,未在真机验证。

说明 ​

示例 ​

js
const device = AVCaptureDevice.defaultDeviceWithMediaType('video');
if (device !== null) {
  device.lockForConfiguration();
  try {
    device.rampToVideoZoomFactor(Math.min(2, device.maxAvailableVideoZoomFactor), { withRate: 4 });
  } finally {
    device.unlockForConfiguration();
  }
}

效果:画面在很短的时间里平滑地放大到 2 倍。未在真机验证。

对应的 iOS API ​

-[AVCaptureDevice rampToVideoZoomFactor:withRate:]。第二段参数放进 options 对象:{ withRate }。

参见 ​