LFIDCardScannerController

LFIDCardScannerController 类封装了带有摄像头的自动身份证检测和识别功能,用于身份证扫描功能。

@property (nonatomic, assign) NSInteger snapshotSeconds;

属性 说明
snapshotSeconds 在扫描的时候定时获取全景快照。注:默认-1不获取;需要获取全景照则设置时间间隔,单位:秒

- (instancetype)initWithOrientation:(AVCaptureVideoOrientation) orientation licenseName:(NSString *)licenseName;

包含朝向的初始化方法。

参数 说明
orientation 视频的朝向,目前支持AVCaptureVideoOrientationPortrait,AVCaptureVideoOrientationLandscapeRight,AVCaptureVideoOrientationLandscapeLeft三种
licenseName licenseName 授权文件名,比如:Linkface.lic 传 Linkface

- (void)hideMaskView:(BOOL) bHide

控制是否显示内置的取景框和提示。该方法在 present 出了 LFIDCardScannerController 之后调用或继承了 LFIDCardScannerController 的 viewDidLoad 中调用才能生效。

参数 说明
NO 不隐藏默认取景框和提示文字 (default)
YES 隐藏默认的取景框和提示文字,用于开发者自定义取景框界面

- (void) doRecognitionProcess:(BOOL) bProcessEnabled

设置是否进行视频帧的识别处理。

参数 说明
YES 对从设置起后的每帧都进行身份证识别处理 (默认值)
NO 对从设置起后的每帧都不做识别处理,还保留视频播放

- (void) didCancel

程序控制关闭摄像头并取消 LFIDCardScannerController 的识别。外部调用 LFIDCardScannerController 的 didCancel 来控制摄像头的关闭;如用于超时控制也可继承本类,通过重载 didCancel 来控制关闭的方式和时机。

- (void) callDelegate_getCard:(UIImage *)image withInformation:(LFIDCard *)idCard

支持自定义扫描成功后的处理流程,支持预览结果和重扫。默认是暂停识别处理,给delegate返回识别的图像 image 和识别结果 idCard。开发者可以继承本类后,重定义识别后的流程,例如给用户展示结果,支持重新扫描或确认结果后结束扫描。

参数 说明
image 扫描窗区域的截图,包含含有完整身份证边缘的用于识别的图像
idCard 身份证识别的结果,含识别出的文字信息

- (void)moveWindowVerticalFromCenterWithDelta:(int) iDeltaY

调整取景框的位置。用于开发者自定义取景框,从中央上上下移动是为了在不同屏幕上的适配问题(仅限于竖屏)。

参数 说明
iDeltaY 取景框从中央位置上下移动的偏移量。大于0表示取景框从中央位置上移,小于0表示取景框从中央位置下移

- (CGRect)maskWindowRect

返回扫描界面中扫描框的实际大小和位置。

参数 说明
返回值 扫描界面中扫描框的坐标

- (void)setTheScanLineColor:(UIColor *)color

设置扫描框四角的颜色。

参数 说明
color 扫描框四角的颜色

- (void)setTheMaskLayerColor:(UIColor *)color andAlpha:(CGFloat)alpha

设置扫描页背景的颜色和透明度。

参数 说明
color 扫描页背景的颜色
alpha 扫描页背景的透明度

LFIDCardScannerControllerDelegate

- (void) getCardResult: (LFIDCard *)idcard

在识别出结果时的回调函数(新版,优先回调)。

参数 说明
idcard 扫描结果,其中包含卡片图像,摄像头获取的图像和卡片信息

- (void) getCard:(UIImage *) image withInformation:(LFIDCard *)idCardInformation

在识别出结果时的回调函数(旧版,在新版回调没有被实现时才会调用)。

参数 说明
imgCapture 摄像头获取的图片
idcard 扫描结果,其中包含卡片图像和卡片信息

-(void) getSnapshot:(UIImage *)imgSnap

扫描的时候获取快照,需要设置属性snapshotSeconds,才会回调此方法。

参数 说明
imgSnap 扫面时的快照

- (void) getError: (LFIDCardErrorCode) errorCode

出现错误时的回调函数。

参数 说明
errorCode 代表不同错误的错误代码

- (void) didCancel

退出扫描界面时必须要实现的回调函数。

results matching ""

    No results matching ""