Skip to content

AVCaptureDevice:videoZoomFactor 属性 ​

videoZoomFactor 属性是画面的变焦倍数。写它,画面立刻放大到这个倍数。

值 ​

数,单位是倍。

写错时 ​

  • 没锁就写:抛 DOMException,name 是 'InvalidStateError',值不变(实测)。信息是 videoZoomFactor: the system refused (…),括号里是系统给的原因,说的是要先锁(-lockForConfiguration:)。
  • 超出能写的范围:抛 RangeError,值不变(实测)。信息是 videoZoomFactor: the system refused (…),括号里是系统给的原因。
  • 转不出有限数:抛 TypeError,比如 videoZoomFactor must be a finite number, got "abc"。

示例 ​

js
const device = AVCaptureDevice.defaultDeviceWithMediaType('video');
if (device !== null) {
  const factor = Math.min(2, device.maxAvailableVideoZoomFactor);
  device.lockForConfiguration();
  try {
    device.videoZoomFactor = factor;
  } finally {
    device.unlockForConfiguration();
  }
  console.log(device.videoZoomFactor);
}

效果:画面放大到 2 倍,控制台输出 2。画面的变化未在真机验证。

对应的 iOS API ​

AVCaptureDevice.videoZoomFactor。ObjC 里没锁就写抛 NSGenericException,这里抛 DOMException,name 是 'InvalidStateError'。

参见 ​