OC之AVCaptureMetadataOutput

一、元数据捕获AVCaptureMetadataOutput

AVCaptureMetadataOutput 用于处理AVCaptureSession产生的定时元数据的捕获输出,继承自 AVCaptureOutput

该对象拦截由其关联的 AVCaptureConnection 发出的元数据对象,并将它们转发到委托对象进行处理。可以使用该类的实例来处理输入数据中包含的特定类型的元数据。可以像执行其他输出对象一样使用此类,通常通过将其作为输出添加到AVCaptureSession对象。

1、配置元数据捕获

1.1、可支持的元数据类型

@property(nonatomic, readonly)
NSArray<AVMetadataObjectType> *availableMetadataObjectTypes;

AVCaptureMetadataOutput可用类型取决于AVCaptureConnection连接的AVCaptureInputPort的功能。数组中的每个字符串对应于接收器报告的AVMetadataObject对象的type属性中的可能值。

1.2、要处理的元数据类型

//标识要处理的元数据对象类型的字符串数组
@property(nonatomic, copy)
NSArray<AVMetadataObjectType> *metadataObjectTypes;

此属性用于过滤接AVCaptureMetadataOutput的元数据对象,只有type与此属性中的某个字符串匹配的AVMetadataObject对象才会转发到AVCaptureMetadataOutputObjectsDelegate的协议方法进行处理。

该数组中每个类型字符串必须存在于availableMetadataObjectTypes属性返回的数组中;否则引发异常。

默认值为空数组,不会将AVMetadataObject对象才会转发到AVCaptureMetadataOutputObjectsDelegate的协议方法;此默认行为可最大限度地提高性能和电池寿命。

1.3、元数据类型 AVMetadataObjectType

AVMetadataObjectTypetypedef 声明的新类别,表示元数据类型:

常量 描述
AVMetadataObjectTypeAztecCode Aztec Code 条形码
AVMetadataObjectTypeFace 面部特征
AVMetadataObjectTypeQRCode 二维码
AVMetadataObjectTypeUPCECode UPC-E 商品条形码
AVMetadataObjectTypePDF417Code PDF417二维条码
AVMetadataObjectTypeITF14Code 外箱条码ITF-14
AVMetadataObjectTypeInterleaved2of5Code 交叉二五条码
AVMetadataObjectTypeEAN8Code EAN-8条码
AVMetadataObjectTypeEAN13Code EAN-13(包括UPC-A)条码
AVMetadataObjectTypeDataMatrixCode 二维条码
1.4、扫描范围
//扫描范围的设置;默认值是(0.0,0.0,1.0,1.0)。
@property(nonatomic) CGRect rectOfInterest;

用于确定每帧对象的扫描范围;不会返回其边界与rectOfInterest不相交的元数据对象。
矩形的原点位于左上角;指定扫描范围可以提高某些类型的元数据的检测性能。

2、接收捕获的元数据对象

只读属性 数据类型 描述
metadataObjectsDelegate id 委托对象,必须实现AVCaptureMetadataOutputObjectsDelegate协议方法。
metadataObjectsCallbackQueue dispatch_queue_t 执行委托方法的调度队列。
设置委托和调度队列
- (void)setMetadataObjectsDelegate:(id<AVCaptureMetadataOutputObjectsDelegate>)objectsDelegate
queue:(dispatch_queue_t)objectsCallbackQueue;

该方法有两个参数:

  • 参数 objectsDelegate :委托对象必须实现AVCaptureMetadataOutputObjectsDelegate协议方法。
  • 参数 objectsCallbackQueue :执行委托方法的调度队列;此队列必须是一个串行队列,以确保AVMetadataObject按接收顺序传递。如果objectsDelegate参数为nil,则也可以为此参数指定nil; 否则,必须指定有效的调度队列。

当从接收者的连接捕获新的元数据对象时,它们将被出售给委托对象。所有委托方法都在objectsCallbackQueue参数中指定的调度队列上执行。为确保及时处理元数据对象而不删除元数据对象,应指定专用于处理对象或不忙的调度队列。


二、委托代理AVCaptureMetadataOutputObjectsDelegate

AVCaptureMetadataOutputObjectsDelegate 用于接收由AVCaptureMetadataOutput产生的元数据的方法。

- (void)captureOutput:(AVCaptureOutput *)output
didOutputMetadataObjects:(NSArray<__kindof AVMetadataObject *> *)metadataObjects
fromConnection:(AVCaptureConnection *)connection;

通知委托AVCaptureMetadataOutput对象发出新的元数据;该方法有三个参数:

  • 参数captureOutput:捕获和发出元数据对象的AVCaptureMetadataOutput对象。
  • 参数metadataObjects:表示新发出的元数据的AVMetadataObject实例数组。因为AVMetadataObject是一个抽象类,所以此数组中的对象始终是具体子类的实例。
  • 参数connection:捕获连接。

AVCaptureMetadataOutput对象仅发出元数据对象,其元素包含在其metadataObjectTypes属性中。委托实现此方法以在元数据对象可用时对其执行其他处理。如果计划使用此方法范围之外的元数据对象,则必须存储对它们的强引用,并在不再需要这些对象时删除这些引用。

此方法在AVCaptureMetadataOutput对象的metadataObjectsCallbackQueue属性指定的调度队列上执行。 由于可能经常调用此方法,因此应该有效地防止捕获性能问题,包括丢弃的元数据对象。


三、元数据对象AVMetadataObject

1、抽象超类 AVMetadataObject

AVMetadataObject 是一个抽象类,用于定义与一段元数据关联的基本属性。这些属性反映有关元数据本身或源自元数据的媒体的信息。子类负责为每个相关属性提供适当的值。不要自己创建此类的实例,而是使用 AVCaptureMetadataOutput 对象从捕获的数据中检索它们。

1.1、属性信息
属性 类型 描述
type AVMetadataObjectType 元数据的类型。
time CMTime 表示捕获元数据的时间。对于源自样本缓冲区CMSampleBufferRef的元数据,时间是样本缓冲区的呈现时间。如果没有与元数据关联的有效时间值,则此属性应包含kCMTimeInvalid
duration CMTime 与此元数据对象关联的媒体的持续时间。对于源自样本缓冲区CMSampleBufferRef的元数据,持续时间反映了样本缓冲区的持续时间。如果没有与元数据关联的有效持续时间值,则此属性应包含kCMTimeInvalid
bounds CGRect 边界矩形是相对于相应媒体的图片或视频指定的。矩形的原点始终在左上角指定,x和y轴向下和向右延伸。如果元数据没有边界矩形,则此属性的值应为CGRectZero。对于视频内容,可以使用0.0到1.0范围内的标量值来表示边界矩形。 即使原始视频按比例缩小,标量值仍然有意义。
1.2、AVMetadataObject的子类

AVMetadataObject 是一个抽象类,我们不能直接使用该类,需要使用系统定义的子类:AVMetadataFaceObject 或者 AVMetadataMachineReadableCodeObject

AVMetadataObject继承关系.png

2、面部信息 AVMetadataFaceObject

AVMetadataFaceObjectAVMetadataObject的子类,它定义单个检测到的面部信息。可以从支持面部检测的设备上的AVCaptureMetadataOutput对象的输出中检索此类实例。

属性 类型 描述
faceID NSInteger AVMetadataFaceObject的唯一面部ID:每次面部进入图片时,都会为其分配一个新的唯一标识符,可以使用该标识符来引用代码中的面部。不重复使用面部ID,并且为再次离开和进入图片的相同面部分配新的标识符。
hasRollAngle BOOL 指示是否存在与面关联的有效滚动角。如果此属性的值为NO,则rollAngle属性中的值无效,读取rollAngle的值会引发异常。
rollAngle CGFloat 滚动角表示面相对于元数据的边界矩形的左右倾斜。值0.0产生相对于图片水平的面,而值90产生相对于图片垂直的面。
hasYawAngle BOOL 指示是否存在与面部相关联的有效偏航角。如果此属性的值为NO,则yawAngle属性中的值无效,读取yawAngle的值会引发异常。
yawAngle CGFloat 偏航角表示面围绕垂直轴的旋转。值0.0表示直接观察相机的脸部,而90度的偏航角度产生的眼睛的眼线垂直于相机的眼睛。

3、条形码信息 AVMetadataMachineReadableCodeObject

AVMetadataMachineReadableCodeObjectAVMetadataObject的子类,用于定义检测到的一维或二维条形码信息。该实例表示图像中单个检测到的机器可读码,它是描述条形码的特征和有效负载的不可变对象。在支持的平台上,AVCaptureMetadataOutput类输出检测到的机器可读代码对象的数组。

属性 类型 描述
corners NSArray<NSDictionary *> 角点相对于其所在图像的坐标;这些点规范方向是按逆时针顺序排列(顺时针方向,如果代码或图像是镜像的),从代码的左上角开始。
descriptor CIBarcodeDescriptor 用于Core Image的条形码描述。
stringValue NSString 返回解码为人类可读字符串的纠错数据;如果无法创建字符串表示,则为nil
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,588评论 6 496
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,456评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,146评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,387评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,481评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,510评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,522评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,296评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,745评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,039评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,202评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,901评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,538评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,165评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,415评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,081评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,085评论 2 352