Skip to content

AVCaptureSession:addOutput() 方法 ​

addOutput() 方法把一个输出加进会话。输出处理会话里的画面,实际用的是识别码的 AVCaptureMetadataOutput。

语法 ​

addOutput(output)

参数 ​

output

一个 AVCaptureOutput。

返回值 ​

无(undefined)。

加进去之后,outputs 里有它,读出来是同一个对象。会话拿着加进去的输出,App 不用自己留引用。

异常 ​

TypeError

  • output 不是 AVCaptureOutput(比如 null):addOutput needs an AVCaptureOutput, got …。
  • 加不进去,也就是 canAddOutput() 是 false:addOutput: this output cannot be added to the session (check canAddOutput() first)。同一个输出加第二次就是这种情况。抛了之后 outputs 不变(实测)。

说明 ​

元数据输出要先进一个接着摄像头的会话,才知道能识别哪些种类。所以顺序是:先 addInput() 接摄像头,再 addOutput(),最后写输出的 metadataObjectTypes。

示例 ​

js
const session = new AVCaptureSession();
const camera = AVCaptureDevice.defaultDeviceWithMediaType('video');
if (camera !== null) {
  session.addInput(new AVCaptureDeviceInput(camera));
  const output = new AVCaptureMetadataOutput();
  session.addOutput(output);
  output.metadataObjectTypes = ['qrCode'];
  console.log(session.outputs.length, output.metadataObjectTypes.join(','));
}

结果:用户已经同意 App 使用摄像头时,输出 1 qrCode。

对应的 iOS API ​

-[AVCaptureSession addOutput:]。ObjC 里加不进去时系统抛 ObjC 的异常;这里抛 TypeError,可以用 try 接住。

参见 ​