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 接住。
参见
canAddOutput():先问能不能加removeOutput():去掉AVCaptureMetadataOutput:识别码