iOS集成FaceID或TouchID

申请了1个多月的iPhoneX终于到了，今天找机会研究了下如何集成FaceID,然后通过查阅资料，发现和集成TouchID没多大区别，所以就放到一起讲下吧。注：集成FaceID的方式、代码基本与集成TouchID一致。

如何集成TouchID

官方API文档
https://developer.apple.com/documentation/localauthentication?language=objc

1.首先引入文件

#import

完整代码如下

  LAContext *context = [LAContext new];
    NSError *error;
    context.localizedFallbackTitle = @"输入密码";
    
    if ([context canEvaluatePolicy:(LAPolicyDeviceOwnerAuthenticationWithBiometrics) error:&error]){
        NSLog(@"支持使用");
        [context evaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics localizedReason:NSLocalizedString(@"通过验证指纹解锁",nil) reply:^(BOOL success, NSError * _Nullable error) {
            if (success) {
                NSLog(@"验证成功");
            }else{
                if (error.code == kLAErrorUserFallback){
                    NSLog(@"用户选择了另一种方式");
                }else if (error.code == kLAErrorUserCancel){
                    NSLog(@"用户取消");
                }else if (error.code == kLAErrorSystemCancel){
                    NSLog(@"切换前台被取消");
                }else if (error.code == kLAErrorPasscodeNotSet){
                    NSLog(@"身份验证没有设置");
                }else{
                    NSLog(@"验证失败");
                }
            }
        }];
    }else{
        switch (error.code) {
            case LAErrorBiometryNotEnrolled:{
                NSLog(@"TouchID is not enrolled");
                break;
            }
            case LAErrorPasscodeNotSet:{
                NSLog(@"A passcode has not been set");
                break;
            }
            case LAErrorBiometryLockout:{
                NSLog(@"TouchID lock out");
                break;
            }
            default:{
                NSLog(@"TouchID not available");
                break;
            }
        }
    }

代码解释如下

  - (BOOL)canEvaluatePolicy:(LAPolicy)policy error:(NSError * __autoreleasing *)error __attribute__((swift_error(none)));

判断是否支持TouchID或FaceID

- (void)evaluatePolicy:(LAPolicy)policy
       localizedReason:(NSString *)localizedReason
                 reply:(void(^)(BOOL success, NSError * __nullable error))reply;

调用授权，如果支持TouchID则弹出指纹识别，支持FaceID则弹出面容识别

LAPolicy 鉴定方式

有两种鉴定方式
1.LAPolicyDeviceOwnerAuthenticationWithBiometrics生物识别

针对TouchID.首先弹出识别的弹窗，当第一次指纹解锁失败时弹框会变成两个按钮，第二个按钮可以自定义标题，如上述的代码的localizedFallbackTitle。另外还可以自定义点击事件，即上述代码的if (error.code == kLAErrorUserFallback){ NSLog(@"用户选择了另一种方式"); }.输错三次密码会，弹框会消失，此时还可再进行验证，如若接下来两次的指纹之别都错误的话，此时TouchID会被锁住，必须得到设置里解锁才能重新再次识别，TouchID被锁住的状态也可以监听到，如上述代码的case LAErrorBiometryLockout:{ NSLog(@"TouchID lock out"); break; }

当设备支持FaceID时，此时会调用FaceID识别，注意两次识别错误后弹框才会出现自定义标题的的按钮选项,设置方式与TouchID相同。5次识别错误后，FaceID会被锁住，也无法再进行识别了，必须到设置里解锁才能再次进行识别。

2.LAPolicyDeviceOwnerAuthentication 生物识别+密码认证

针对TouchID。优先调用TouchID识别，如果三次识别错误后，则会弹出系统密码验证，输入设备密码来解锁。如果不输入设备密码，还有两次机会调用指纹识别，如果都失败的话，TouchID会被锁住，则接下来每次调用识别的话，都是调用系统密码验证。

当设备支持FaceID时,优先调用FaceID识别，有5次输入机会，当5次识别失败后FaceID会被锁住，之后每次调用识别都会弹出系统密码验证

注1：如果没设置系统密码，则使用该验证方式不会调起任何识别，或者说每次都会得到一个错误码LAErrorPasscodeNotSet
注2：无论是LAPolicyDeviceOwnerAuthenticationWithBiometrics还是LAPolicyDeviceOwnerAuthentication最大识别次数都是5次,区别是第二种达到最大次数后才能进行识别，只不过是必须调用系统密码验证进行识别。

注意。context.localizedFallbackTitle = @"自定义";如果未设置该title的话，则AlertView弹窗默认会有“输入密码”的选项，但是在LAPolicyDeviceOwnerAuthenticationWithBiometrics模式下点击“输入密码”不会有反应；LAPolicyDeviceOwnerAuthentication模式下点击可以唤起输入手机密码页面。如果设置该title为空值，则弹框不会有该选项，如果设置该值不为空，则弹框会有该选项，且点击事件需要自定义，在判断错误码code为kLAErrorUserFallback的代码块内设置自定义事件。

如何集成FaceID

其实集成FaceID的方式已经写在上面了，别奇怪，代码一模一样。不需要做任何改变。如果你需要判断当前识别方式是TouchID还是FaceID的话，LAContext实例类有个只读属性叫biometryType。定义如下

typedef NS_ENUM(NSInteger, LABiometryType)
{
   /// The device does not support biometry.
   LABiometryNone,
   
   /// The device supports Touch ID.
   LABiometryTypeTouchID,
   
   /// The device supports Face ID.
   LABiometryTypeFaceID,
} NS_ENUM_AVAILABLE(NA, 11_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;

注意：重点！！该属性是只读属性，也就是说你能获取当前识别方式是TouchID还是FaceID,而不能手动设置当前识别方式是TouchID还是FaceID。从该属性我们可以看出，苹果真实不撞南墙不回头了，彻底放弃TouchID了，因为如果同时支持两种识别方式的话，就不会是只读属性。你可以根据该属性进行一些UI上的自定义。

如果想要支持FaceID识别的话，最好加上一个key.
NSFaceIDUsageDescription，我试了下不加的话，确实也不会崩溃，但我觉得为了保险最好加上，防止以后iOS升级后必须要求该key才能进行FaceID识别，而且我相信按照苹果的尿性，一定会这么做的。

最后

总结一下常见的错误码

kLAErrorUserCancel   用户取消
kLAErrorPasscodeNotSet  未设置系统密码
LAErrorBiometryLockout   生物识别被锁住，指TouchID或FaceID识别次数达到最大次数(5次)
kLAErrorUserFallback  上述所说自定义按钮标题时,点击是的错误码，可在此设置自定义的点击事件
LAErrorSystemCancel  另一个App进入到了前台
LAErrorTouchIDNotAvailable  TouchID不可用
LAErrorTouchIDNotEnrolled    未设置TouchID
LAErrorTouchIDLockout    TouchID被锁住 建议判断LAErrorBiometryLockout即可

参考文章

1.使用TouchID验证登录踩过的一些坑（同时更新FaceID使用方法）
2.iOS开发实现TouchID指纹解锁
3.iOS指纹/密码鉴定