指纹解锁的使用越来越普遍了,主要是使用方便,再用之前还是先了解一下如何使用吧。
一、API介绍
使用指纹功能,必须用到系统的库,指纹用到的库是LocalAuthentication.framework
,所以接下来我介绍一下这个库里的所有文件的作用。
我们打开这个LocalAuthentication.framework
库,发现里面就4个.h文件
- LAContext.h
- LAError.h
- LAPublicDefines.h
- LocalAuthentication.h
1、LocalAuthentication.h
这个里面就两行引入头文件,很显然这是我们引入指纹库要调用的类,可以在文件中引入#import <LocalAuthentication/LocalAuthentication.h>
2、LAPublicDefines.h
这个里面就是定义了一些宏定义,很简单都能看懂。
3、LAError.h
这个类其实也不难,就是一个枚举的里面列出了所有可能出现的错误类型,每个错误的类型都有注释,我给翻译一下
LAErrorAuthenticationFailed //连续三次指纹验证失败,可能指纹模糊或用错手指
LAErrorUserCancel //用户取消验证,点击了取消按钮
LAErrorUserFallback //用户取消验证,点击了输入密码按钮
LAErrorSystemCancel //系统取消授权,如其他APP切入
LAErrorPasscodeNotSet //指纹验证无法启动/失败,因为设备没有设置密码
LAErrorTouchIDNotAvailable //设备TouchID不可用,例如未打开
LAErrorTouchIDNotEnrolled //指纹验证无法启动,因为没有录入指纹(设置密码了)
LAErrorTouchIDLockout //设备TouchID被锁定,因为失败的次数太多了
LAErrorAppCancel //应用程序取消了身份验证,APP调用了-(void)invalidate方法使LAContext失效
LAErrorInvalidContext //实例化的LAContext对象失效,再次调用evaluation...方法则会弹出此错误信息
4、LAContext.h
这个类才是最重要的核心部分。
首先看到的是一个枚举LAPolicy,里面就两个
LAPolicyDeviceOwnerAuthenticationWithBiometrics
(iOS8以上可用):这种代表的是只用指纹去验证。第一次指纹失败,会出现“输入密码”按钮,输入密码的标题及功能可以自定义;第三次指纹失败,弹窗消失;再次启动验证,还有两次机会,如果都失败了,指纹验证锁定,不再弹出验证窗。直至输入密码来解锁指纹(可以锁屏重新进来使用输入密码的方式解锁)。
LAPolicyDeviceOwnerAuthentication
(iOS9以上可用):这种代表的是可以用指纹或密码两种方式去验证,优先用指纹。第一次指纹失败,会出现“输入密码”按钮,输入密码的标题可以自定义,但是功能不能自定义了,而是必须输入系统密码(锁屏密码);第三次验证失败,弹窗消失,弹出输入系统密码的界面;如果连续五次指纹失败,则指纹锁定,此时只会弹出输入密码界面,直至输入密码成功解锁。
两种验证方式的比较:
相同点:都是连续五次验证失败就会锁定
不同点:前者的输入密码功能可以自定义,后者输入密码功能是固定输入系统密码
一般经常使用前者LAPolicyDeviceOwnerAuthenticationWithBiometrics
接下来就是实例方法,创建实例对象:LAContext *context = [LAContext alloc] init];
用context
来调用。
/*
这个方法用来检查当前设备是否可用touchID,返回一个BOOL值
policy: 这个就是上面的枚举的两个验证方式,一般用前者
error: 错误的类型可参考LAError.h里的类型
*/
- (BOOL)canEvaluatePolicy:(LAPolicy)policy error:(NSError * __autoreleasing *)error __attribute__((swift_error(none)));
/*
这个方法是开始验证指纹的方法
policy: 这个就是上面的枚举的两个验证方式,一般用前者
localizedReason: 指纹验证框上面的提示信息,一般为“通过Home键验证已有手机指纹”(不能为空否则崩溃)
reply: 一个block,返回指纹验证结果,成功:success为YES,失败:success为NO,同时返回错误类型的error,同样参考LAError.h里的类型
*/
- (void)evaluatePolicy:(LAPolicy)policy
localizedReason:(NSString *)localizedReason
reply:(void(^)(BOOL success, NSError * __nullable error))reply;
//用来废止该实例对象context
- (void)invalidate NS_AVAILABLE(10_11, 9_0);
下面的两个枚举和三个方法一般用不到,这里就不做介绍了
// 两个枚举
LACredentialType
LAAccessControlOperation
// 三个方法
- (BOOL)setCredential:(nullable NSData *)credential
type:(LACredentialType)type NS_AVAILABLE(10_11, 9_0) __WATCHOS_AVAILABLE(3.0) __TVOS_UNAVAILABLE;
- (BOOL)isCredentialSet:(LACredentialType)type NS_AVAILABLE(10_11, 9_0) __WATCHOS_AVAILABLE(3.0) __TVOS_UNAVAILABLE;
- (void)evaluateAccessControl:(SecAccessControlRef)accessControl
operation:(LAAccessControlOperation)operation
localizedReason:(NSString *)localizedReason
reply:(void(^)(BOOL success, NSError * __nullable error))reply
NS_AVAILABLE(10_11, 9_0) __WATCHOS_AVAILABLE(3.0) __TVOS_UNAVAILABLE;
还有五个属性
// 可以设置指纹弹框“输入密码”按钮的标题,如果不设置或设置为nil,则显示默认的“输入密码”;如果设置为@"",则弹框不再显示这个按钮
@property (nonatomic, nullable, copy) NSString *localizedFallbackTitle;
// 可以设置指纹弹框“取消”按钮的标题(iOS10.0以上可用),如果不设置或设置为nil或设置为@"",都显示默认的“取消”
@property (nonatomic, nullable, copy) NSString *localizedCancelTitle NS_AVAILABLE(10_12, 10_0);
// 最大指纹尝试错误次数(iOS8.3 - iOS9.0可用)
@property (nonatomic, nullable) NSNumber *maxBiometryFailures NS_DEPRECATED_IOS(8_3, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;
// 这个可以检测你的指纹数据库的变化,增加或者删除指纹这个属性会做出相应的反应(iOS9.0以上可用)
@property (nonatomic, nullable, readonly) NSData *evaluatedPolicyDomainState NS_AVAILABLE(10_11, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;
// 两次开启指纹之间的时间间隔,决定第二次是否需要指纹解锁
@property (nonatomic) NSTimeInterval touchIDAuthenticationAllowableReuseDuration NS_AVAILABLE(NA, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;
二、使用方法
1、首先,引入依赖框架 LocalAuthentication.framework
#import <LocalAuthentication/LocalAuthentication.h>
2、集成指纹解锁的方法
- (void)evaluateAuthenticate
{
//iOS 8以上才支持指纹识别接口
if ([[UIDevice currentDevice].systemVersion floatValue] < 8) {
NSLog(@"不支持TouchID (版本必须高于iOS 8.0才能使用)");
return;
}
//创建LAContext
LAContext *context = [[LAContext alloc] init];
context.localizedFallbackTitle = @"输入密码吧";
NSError *Error = nil;
//判断设备支持状态
if ([context canEvaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics error:&Error]) {
//支持指纹验证
[context evaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics localizedReason:@"请验证已有手机指纹" reply:^(BOOL success, NSError *error) {
if (success) {
//验证成功,主线程处理UI
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
NSLog(@"指纹验证成功");
}];
} else {
NSLog(@"验证失败 == %@", error.localizedDescription);
switch (error.code) {
case LAErrorSystemCancel:{
NSLog(@"系统取消授权,如其他APP切入");
}
break;
case LAErrorUserCancel:{
NSLog(@"用户取消验证,点击了取消按钮");
}
break;
case LAErrorUserFallback:{
NSLog(@"用户取消验证,点击了输入密码按钮");
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
//用户选择输入密码,切换主线程处理
}];
}
break;
case LAErrorAuthenticationFailed:{
NSLog(@"连续三次指纹验证失败,可能指纹模糊或用错手指");
}
break;
case LAErrorTouchIDLockout:{
NSLog(@"设备TouchID被锁定,因为失败的次数太多了");
}
break;
default:{
NSLog(@"设备TouchID不可用。。。");
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
//其他情况,切换主线程处理
}];
}
break;
}
}
}];
} else {
//该设备不支持TouchID
NSLog(@"不支持TouchID == %@", Error.localizedDescription);
switch (Error.code) {
case LAErrorTouchIDNotEnrolled:{
NSLog(@"指纹验证无法启动,因为没有录入指纹");
}
break;
case LAErrorPasscodeNotSet:{
NSLog(@"指纹验证无法启动,因为设备没有设置密码");
}
break;
case LAErrorTouchIDLockout:{
NSLog(@"设备TouchID被锁定,因为失败的次数太多了");
}
break;
default:{
NSLog(@"设备TouchID不可用。。。");
}
break;
}
}
}
三、demo
这里有我封装好的一个demo,欢迎参考!
如有任何问题,欢迎留言!