申请了1个多月的iPhoneX终于到了,今天找机会研究了下如何集成FaceID,然后通过查阅资料,发现和集成TouchID没多大区别,所以就放到一起讲下吧。注:集成FaceID的方式、代码基本与集成TouchID一致。
如何集成TouchID
官方API文档
https://developer.apple.com/documentation/localauthentication?language=objc
1.首先引入文件
#import <LocalAuthentication/LocalAuthentication.h>
完整代码如下
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指纹/密码鉴定