DemoLibrary之一:【TouchID指纹识别】

由于近段时间项目告一段落啦,所以决定将近段时间接触的一些功能集中整理总结一下,写成了一个简单的Demo,以供参考。此篇文章主要是介绍了第三方登录分享以及指纹识别的配置过程:

一:指纹识别

TouchID指纹识别主要是 iPhone 5s 添加的功能设备,有了这个功能之后,极大的方便了果粉的使用,当然越来越多的应用也开始在应用中集成指纹识别功能。其实官方提供的API中可以看出,�在应用中集成也是比简单的,主要用到的是 LocalAuthentication.framework 这个库,当打开之后可以发现头文件:

SDK.png
其实在这是个头文件中看出,真正使用的接口类是LAContext.h,另外的几个头文件都是一些枚举以及宏定义;下面来看一下暴露出来的几个接口API【常用API】:

# 用来检查当前设备是否可用touchID,返回一个BOOL值
@param  policy 是一个枚举类型

第一个枚举LAPolicyDeviceOwnerAuthenticationWithBiometrics就是说,用的是手指指纹去验证的;NS_ENUM_AVAILABLE(NA, 8_0)iOS8 可用
第二个枚举LAPolicyDeviceOwnerAuthentication少了WithBiometrics则是使用TouchID或者密码验证,默认是错误两次指纹或者锁定后,弹出输入密码界面;NS_ENUM_AVAILABLE(10_11, 9_0)iOS 9可用

- (BOOL)canEvaluatePolicy:(LAPolicy)policy error:(NSError * __autoreleasing *)error __attribute__((swift_error(none)));
调用验证方法,注意这里的三个参数:
第一个参数policy是要使用上面那个LAPolicy的枚举
第二个参数localizedReason是NSString类型的验证理由
第三个参数reply则是一个回调Block,block内有一个BOOL类型的success判断是否成功验证,还有一个用于判断错误信息的NSError类型的error
- (void)evaluatePolicy:(LAPolicy)policy
       localizedReason:(NSString *)localizedReason
                 reply:(void(^)(BOOL success, NSError * __nullable error))reply
invalidate方法用来废止这个context
- (void)invalidate NS_AVAILABLE(10_11, 9_0)

以下是提供的几个属性方法

// /返回按钮标题。允许设置密码输入按钮标题。如果设置为空字符串时,按钮会隐藏
@property (nonatomic, nullable, copy) NSString *localizedFallbackTitle;

 //取消按钮标题。允许设置取消按钮标题。如果设置为空字符串时,按钮会隐藏NS_AVAILABLE(10_12, 10_0)说明10.0之后才有
@property (nonatomic, nullable, copy) NSString *localizedCancelTitle NS_AVAILABLE(10_12, 10_0);

// 设置最大允许认证失败次数NS_DEPRECATED_IOS(8_3, 9_0),说明这个属性在iOS 8.3被引入,在iOS 9.0被废弃,所以如果系统版本高于9.0是无法使用的。
@property (nonatomic, nullable) NSNumber *maxBiometryFailures NS_DEPRECATED_IOS(8_3, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;

// 这个跟可以检测你的指纹数据库的变化,增加或者删除指纹这个属性会做出相应的反应
@property (nonatomic, nullable, readonly) NSData *evaluatedPolicyDomainState NS_AVAILABLE(10_11, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;

//因为这个属性可以设置一个时间间隔,在时间间隔内是不需要再次录入。默认是0秒,最长可以设置5分钟。
@property (nonatomic) NSTimeInterval touchIDAuthenticationAllowableReuseDuration NS_AVAILABLE(NA, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;

在API中提供的方法属性本来就不多,只要能够理解每个方法和属性的意义,TouchID使用起来就是得心应手的啦,下列是Demo事例中的一个简单应用方法:

/// 检测 指纹
/*
 1、 验证(指纹/密码)不能开启的错误信息(指纹系统被判定为无效):
 LAErrorPasscodeNotSet : 设备密码未设置
 LAErrorTouchIDNotAvailable : TOUCH ID不可用
 LAErrorTouchIDNotEnrolled : 指纹未录入
 LAErrorTouchIDLockout : TOUCH ID被锁定
 LAErrorAppCancel : APP调用了- (void)invalidate
 方法使LAContext
 失效
 LAErrorInvalidContext : 实例化的LAContext
 对象失效,再次调用evaluation...
 方法则会弹出此错误信息
 2、 其他错误信息(指纹系统判定有效,但是验证指纹错误):
 LAErrorAuthenticationFailed : 鉴定失败
 LAErrorUserCancel : 用户取消
 LAErrorUserFallback : 用户选择输入密码
 LAErrorSystemCancel : 系统取消(如:另外一个应用进入前台)
 
 */

/**
 *    指纹验证解锁的主要方法
 *
 *  @param localizedFallbackTitle  密码输入按钮标题 例如:定义标题
 *  @param localizedReason    指纹解锁弹出框副标题 例如:这是副标题
 *  @param touchBlock         结果回调
 */
-(void)touchIDWithlocalizedFallbackTitle:(NSString *)localizedFallbackTitle localizedReason:(NSString*)localizedReason success:(void(^)(BOOL success, NSString *errorMsg)) touchBlock{
    
    [SVProgressHUD show];
    
    LAContext *context = [[LAContext alloc]init];//使用 new 不会给一些属性初始化赋值
        
    if (!localizedReason) {
        localizedReason = @"请验证已有指纹";
    }
    
    context.localizedFallbackTitle = localizedFallbackTitle ? : @"密码登录";//@""可以不让 feedBack 按钮显示
    
    NSError * err;
    
    self.canUseTouchId = [context canEvaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics error:&err];
    // 指纹识别被锁定,需要输入密码验证
    if (err.code == LAErrorTouchIDLockout) {
        
        [SVProgressHUD dismiss];
        
        if (touchBlock) {
            touchBlock(NO,@"Touch ID被锁,需要用户输入密码解锁");
        }
        return;
    }
    
    if (self.canUseTouchId) {// 检测手机是否可以使用TouchId
        

        //LAPolicyDeviceOwnerAuthenticationWithBiometrics
        [context evaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics localizedReason:localizedReason reply:^(BOOL success, NSError * _Nullable error) {
            
            [SVProgressHUD dismiss];

            //SVProgressHUD dismiss 需要 0.15才会消失;所以dismiss 后进行下一步操作;但是0.3是适当延长时间;留点余量
            dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.3* NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
                
                self.completeMsg = nil;
                
                if (success){
                    
                    NSLog(@"指纹识别成功");
                    // 指纹识别成功,回主线程更新UI
                    dispatch_async(dispatch_get_main_queue(), ^{
                        //成功操作
                        self.completeMsg = @"指纹识别成功";
                        
                        if (touchBlock) {
                            touchBlock(success,self.completeMsg);
                        }
                        
                    });
                }
                
                if (error) {
                    //指纹识别失败,回主线程更新UI
                    dispatch_async(dispatch_get_main_queue(), ^{
                        //失败操作
                        LAError errorCode = error.code;
                        
                        switch (errorCode) {
                                
                            case LAErrorAuthenticationFailed:
                            {
                                NSLog(@"授权失败"); // -1 连续三次指纹识别错误
                                self.completeMsg = @"授权失败";
                            }
                                break;
                            case LAErrorUserCancel: // Authentication was canceled by user (e.g. tapped Cancel button)
                            {
                                NSLog(@"用户取消验证Touch ID"); // -2 在TouchID对话框中点击了取消按钮
                                self.completeMsg = @"用户取消验证Touch ID";
                                
                            }
                                break;
                            case LAErrorUserFallback: // Authentication was canceled, because the user tapped the fallback button (Enter Password)
                            {
                                NSLog(@"用户选择输入密码,切换主线程处理"); // -3 在TouchID对话框中点击了输入密码按钮
                                self.completeMsg = @"用户选择输入密码,切换主线程处理";
                                
                            }
                                break;
                            case LAErrorSystemCancel: // Authentication was canceled by system (e.g. another application went to foreground)
                            {
                                NSLog(@"取消授权,如其他应用切入"); // -4 TouchID对话框被系统取消,例如按下Home或者电源键
                                self.completeMsg = @"取消授权,如其他应用切入";
                                
                            }
                                break;
                            case LAErrorPasscodeNotSet: // Authentication could not start, because passcode is not set on the device.
                                
                            {
                                NSLog(@"设备系统未设置密码"); // -5
                                self.completeMsg = @"设备系统未设置密码";
                                
                            }
                                break;
                            case LAErrorTouchIDNotAvailable: // Authentication could not start, because Touch ID is not available on the device
                            {
                                NSLog(@"设备未设置Touch ID"); // -6
                                self.completeMsg = @"设备未设置Touch ID";
                                
                            }
                                break;
                            case LAErrorTouchIDNotEnrolled: // Authentication could not start, because Touch ID has no enrolled fingers
                            {
                                NSLog(@"用户未录入指纹"); // -7
                                self.completeMsg = @"用户未录入指纹";
                                
                            }
                                break;
                            case LAErrorTouchIDLockout: //Authentication was not successful, because there were too many failed Touch ID attempts and Touch ID is now locked. Passcode is required to unlock Touch ID, e.g. evaluating LAPolicyDeviceOwnerAuthenticationWithBiometrics will ask for passcode as a prerequisite 用户连续多次进行Touch ID验证失败,Touch ID被锁,需要用户输入密码解锁,先Touch ID验证密码
                            {
                                NSLog(@"Touch ID被锁,需要用户输入密码解锁"); // -8 连续五次指纹识别错误,TouchID功能被锁定,下一次需要输入系统密码
                                self.completeMsg = @"Touch ID被锁,需要用户输入密码解锁";
                                
                            }
                                break;
                            case LAErrorAppCancel: // Authentication was canceled by application (e.g. invalidate was called while authentication was in progress) 如突然来了电话,电话应用进入前台,APP被挂起啦");
                            {
                                NSLog(@"用户不能控制情况下APP被挂起"); // -9
                                self.completeMsg = @"用户不能控制情况下APP被挂起";
                                
                            }
                                break;
                            case LAErrorInvalidContext: // LAContext passed to this call has been previously invalidated.
                            {
                                NSLog(@"LAContext传递给这个调用之前已经失效"); // -10
                                self.completeMsg = @"指纹识别失效";
                                
                            }
                                break;
                        }
                        
                        if (touchBlock) {
                            touchBlock(success,self.completeMsg);
                        }
                        
                    });
                }
                
            });
        }];
        
    }else{
        
        [SVProgressHUD dismiss];

        if (touchBlock) {
            touchBlock(NO,[NSString stringWithFormat:@"设备不支持指纹解锁-- %@",err.localizedFailureReason ? : @""]);
        }
    }
    
}

效果图如下:

解锁页面
自定义密码输入标题、副标题.png
取消.PNG
TouchID锁定.PNG
识别成功.PNG

TouchID的简单集成使用功能就是这样,如果想要了解更详细的内容,可以具体参考苹果官方文档:

lacontext官方文档

https://developer.apple.com/reference/localauthentication/lacontext

TouchID官方文档:

https://developer.apple.com/reference/localauthentication/lacontext

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容