AVCaptureVideoPreviewLayer:transformedMetadataObjectForMetadataObject() 方法
transformedMetadataObjectForMetadataObject() 方法把 detect 事件里认到的一个对象换算到这个图层上:换算出来的对象的位置是图层里的点,可以直接拿来在图层上画框。
语法
transformedMetadataObjectForMetadataObject(metadataObject)参数
metadataObject
从 detect 事件的 objects 里拿到的一个对象(AVMetadataObject 或 AVMetadataMachineReadableCodeObject)。
返回值
一个新的对象,类和参数一样:参数是码对象,得到的也是码对象(实测)。它的 type 和 stringValue 和参数一样;bounds 和 corners 换成了这个图层里的点(pt),原点在图层左上角,已经算进了 videoGravity 的缩放和裁剪。
换算不了时是 null。
参数本身不变。
异常
TypeError
参数不是从 detect 事件拿到的(自己建的对象、普通对象):transformedMetadataObjectForMetadataObject needs an object from a detect event, got …(实测)。
说明
- 在
detect的监听器里当场换算。之后图层的frame或videoGravity变了,原来换算出来的位置就对不上了。 - 换算出来的位置是这个图层里的点。图层铺满某个视图时,它也是那个视图里的点,可以直接设成叠在上面的视图的
frame。
示例
js
const session = new AVCaptureSession();
const preview = new AVCaptureVideoPreviewLayer(session);
preview.frame = new CGRect(0, 0, 300, 400);
const output = new AVCaptureMetadataOutput();
output.addEventListener('detect', (e) => {
for (const found of e.objects) {
const onLayer = preview.transformedMetadataObjectForMetadataObject(found);
if (onLayer !== null) {
const box = onLayer.bounds;
console.log(Math.round(box.x), Math.round(box.y), Math.round(box.width), Math.round(box.height));
}
}
});效果:session 接上摄像头、加上 output、开始取景之后,镜头前有码时,每个码每一帧输出一行:它在 300 × 400 pt 的图层里的位置和大小,单位 pt。
对应的 iOS API
-[AVCaptureVideoPreviewLayer transformedMetadataObjectForMetadataObject:]。