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;
- 参数
rectInMetadataOutputCoordinates：AVCaptureMetadataOutput坐标系统中的矩形。
网友评论