OC之摄像头预览图层AVCaptureVideoPreviewLayer

AVCaptureVideoPreviewLayer 继承自 CALayer,显示正在被摄像头捕获视频的预览图层。

将该预览图层与AVCaptureSession结合使用,如以下代码片段所示:

AVCaptureSession *captureSession = [[AVCaptureSession alloc]init];
AVCaptureVideoPreviewLayer *previewLayer = [AVCaptureVideoPreviewLayer layerWithSession:captureSession];
UIView *aView = [[UIView alloc] initWithFrame:UIScreen.mainScreen.bounds];
previewLayer.frame = aView.bounds; //预览层填充视图
[aView.layer addSublayer:previewLayer];

使用videoGravity属性来影响相对于图层边界查看内容的方式。 在某些硬件配置中,使用方向和镜像来操纵图层的方向。

1、创建预览图层

1.1、初始化预览图层

使用指定的AVCaptureSession初始化预览图层。

- (instancetype)initWithSession:(AVCaptureSession *)session;

+ (instancetype)layerWithSession:(AVCaptureSession *)session;
  • 参数session:用于获取预览的会话。
1.2、初始化没有连接的预览图层

使用指定的AVCaptureSession初始化预览图层,但不进行任何连接,不连接会话的任何视频输入。

- (instancetype)initWithSessionWithNoConnection:(AVCaptureSession *)session;
+ (instancetype)layerWithSessionWithNoConnection:(AVCaptureSession *)session;
  • 参数session:要预览的捕获会话。

只有使用-addConnection:在所需的AVCaptureInputPort对象和预览图层之间手动形成连接,才使用该方法初始化预览图层。

2、图层配置

属性 数据类型 描述
videoGravity AVLayerVideoGravity 设置视频在预览图层中的显示方式;默认值为AVLayerVideoGravityResizeAspect
connection AVCaptureConnection 只读属性,描述预览层连接到的AVCaptureInputPort的捕获连接。如果预览图层与会话分离,则连接属性将变为nil
session AVCaptureSession 正在预览的session实例。
显示方式 描述
AVLayerVideoGravityResizeAspect 保持视频长宽比,边界可能留白。
AVLayerVideoGravityResizeAspectFill 保持视频长宽比并填充边界。
AVLayerVideoGravityResize 拉伸视频以填充边界。

将预览图层连接到指定的session,而不隐式地形成连接。

- (void)setSessionWithNoConnection:(AVCaptureSession *)session;

只有使用-addConnection:在所需的AVCaptureInputPort对象和预览图层之间手动形成连接,才使用该方法。

3、坐标系转换

3.1、不同坐标系中指定点的坐标转换

AVCaptureDevice的坐标系统与我们常用的UIView的坐标系统是不一样的。AVCaptureDevice坐标系统中的坐标范围为0.0到1.0;点{0.0,0.0}对应于未旋转图像的左上角,点{1.0,1.0}表示未旋转图像的右下角。

将预览图层的坐标点转换为AVCaptureDevice的坐标。

- (CGPoint)captureDevicePointOfInterestForPoint:(CGPoint)pointInLayer;
  • 参数pointInLayer:预览图层的一个坐标点。

执行该方法转换坐标会考虑图层的帧大小和接收者的videoGravity属性。

AVCaptureDevice的坐标点转换为预览图层的坐标。

- (CGPoint)pointForCaptureDevicePointOfInterest:(CGPoint)captureDevicePointOfInterest;
  • 参数captureDevicePointOfInterest:基于AVCaptureDevice的坐标点。
3.2、转换AVMetadataObject

将元数据对象的可视属性转换为图层坐标。

- (AVMetadataObject *)transformedMetadataObjectForMetadataObject:(AVMetadataObject *)metadataObject;
  • 参数metadataObject:要转换其可视属性的元数据对象。元数据对象必须来自与预览层相同的输入源AVCaptureInput;如果元数据对象来自预览层以外的输入源,则该方法返回nil。

AVMetadataObject的边界表示为矩形,其中原点{0.0,0.0}表示未旋转图片的左上角,点{1.0,1.0}表示未旋转图片的右下角。面部元数据对象还表示相对于未旋转图片的偏转和滚动角度。

该方法将所有元数据对象的可视属性转换为接收器的坐标空间,同时考虑方向,镜像,图层边界和videoGravity

3.3、不同坐标系中指定坐标转换

将预览层坐标系统中的矩形转换为AVCaptureMetadataOutput坐标系统中的矩形。

- (CGRect)metadataOutputRectOfInterestForRect:(CGRect)rectInLayerCoordinates;
  • 参数rectInLayerCoordinates:预览图层坐标系中的一个矩形。

AVCaptureMetadataOutput坐标系中的矩形位于从左上角的{0,0}到右下角的{1,1}的坐标系中,相对于设备的自然方向。捕获输出对象使用可以缩放,旋转或镜像的像素坐标空间。

AVCaptureMetadataOutput坐标系统中的矩形转换为预览层坐标系统中的矩形。

- (CGRect)rectForMetadataOutputRectOfInterest:(CGRect)rectInMetadataOutputCoordinates;
  • 参数rectInMetadataOutputCoordinatesAVCaptureMetadataOutput坐标系统中的矩形。

你可能感兴趣的:(OC之摄像头预览图层AVCaptureVideoPreviewLayer)