首页 > 代码库 > 使用iOS 8 SDK添加Touch ID指纹识别功能

使用iOS 8 SDK添加Touch ID指纹识别功能

iOS 8 SDK向开发者公开了Touch ID指纹识别功能,允许App对用户身份进行本地验证。使用Touch ID非常简单,只需要2步即可:

1. 检查Touch ID是否可用。

2. 获得指纹验证结果。

下面以一个简单的例子来说明如何使用Touch ID。

创建一个新的项目,向界面设计器中添加一个按钮。使用Touch ID需要引入LocalAuthentication框架:

import LocalAuthentication

在按钮的Touch Up Inside事件中我们首先检查Touch ID功能是否可用:

    @IBAction func useTouchIdButtonClicked(sender: AnyObject)
    {
        //步骤1:检查Touch ID是否可用

        let authenticationContext = LAContext()
        var error: NSError?

        let isTouchIdAvailable = authenticationContext.canEvaluatePolicy(.DeviceOwnerAuthenticationWithBiometrics,
                error: &error)

        if isTouchIdAvailable
        {
            NSLog("恭喜,Touch ID可以使用!")
            //步骤2:获取指纹验证结果

            authenticationContext.evaluatePolicy(.DeviceOwnerAuthenticationWithBiometrics, localizedReason: "需要验证您的指纹来确认您的身份信息", reply: {
                (success, error) -> Void in
                if success
                {
                    NSLog("恭喜,您通过了Touch ID指纹验证!")
                }
                else
                {
                    NSLog("抱歉,您未能通过Touch ID指纹验证!\n\(error)")
                }
            })
        }
        else
        {
            NSLog("抱歉,Touch ID不可以使用!\n\(error)")
        }
    }

上面的代码首先创建了一个LAContext实例,用于执行认证策略(Authentication Policies)。然后在该对象上调用canEvaluatePolicy方法执行某个指定的认证策略,其方法签名为:

func canEvaluatePolicy(policy: LAPolicy, error: NSErrorPointer) -> Bool

LAPolicy枚举目前只有一个枚举值.DeviceOwnerAuthenticationWithBiometrics,即使用指纹生物识别方式来认证设备机主。

enum LAPolicy: Int
{
    case DeviceOwnerAuthenticationWithBiometrics
}
注意到canEvaluatePolicy方法返回的是Bool值,表示指定的认证策略是否允许执行。当方法返回false时,可以通过error对象来获取详细的失败原因。失败的情况可能是设备本身不支持,例如旧版本的iPhone与iPad;运行在模拟器上;或者用户未开启Touch ID功能等。

例如,在iPhone 5上运行结果为:

抱歉,Touch ID不可以使用!
Optional(Error Domain=com.apple.LocalAuthentication Code=-6 "Biometry is not available on this device." UserInfo=0x15ec5a00 {NSLocalizedDescription=Biometry is not available on this device.})
在模拟器上的运行结果为:

抱歉,Touch ID不可以使用!
Optional(Error Domain=com.apple.LocalAuthentication Code=-1000 "Simulator is not supported." UserInfo=0x7ffe604b0790 {NSLocalizedDescription=Simulator is not supported.})

当允许使用Touch ID后,可以接着调用evaluatePolicy方法执行指定的认证策略,方法签名为:

func evaluatePolicy(policy: LAPolicy, localizedReason: String!, reply: ((Bool, NSError!) -> Void)!)
调用该方法将弹出系统调用Touch ID的对话框,其中的localizedReason参数用于在对话框中提示用户详细的理由和原因(应言简意赅,但不可为空或者空串)。
技术分享

reply参数是一个Block,其中的Bool类型参数success表示指纹验证是否通过,当失败时error参数包含了具体的失败信息。这里有很多种失败的情况(我自己只测试出了以下5种情况,如有遗漏还请告知):

1. 连续三次指纹识别错误的运行结果:

抱歉,您未能通过Touch ID指纹验证!
Error Domain=com.apple.LocalAuthentication Code=-1 "Aplication retry limit exceeded." UserInfo=0x1740797c0 {NSLocalizedDescription=Aplication retry limit exceeded.}
2. Touch ID功能被锁定,下一次需要输入系统密码时的运行结果:
抱歉,您未能通过Touch ID指纹验证!
Error Domain=com.apple.LocalAuthentication Code=-1 "Biometry is locked out." UserInfo=0x17407dc00 {NSLocalizedDescription=Biometry is locked out.}
3. 用户在Touch ID对话框中点击了取消按钮:

抱歉,您未能通过Touch ID指纹验证!
Error Domain=com.apple.LocalAuthentication Code=-2 "Canceled by user." UserInfo=0x17006c780 {NSLocalizedDescription=Canceled by user.}
4. 在Touch ID对话框显示过程中,背系统取消,例如按下电源键:

抱歉,您未能通过Touch ID指纹验证!
Error Domain=com.apple.LocalAuthentication Code=-4 "UI canceled by system." UserInfo=0x170065900 {NSLocalizedDescription=UI canceled by system.}
5. 用户在Touch ID对话框中点击输入密码按钮:

抱歉,您未能通过Touch ID指纹验证!
Error Domain=com.apple.LocalAuthentication Code=-3 "Fallback authentication mechanism selected." UserInfo=0x17407e040 {NSLocalizedDescription=Fallback authentication mechanism selected.}
通过这个简单的例子,相信您已经了解如何在您的App中添加指纹识别功能了。本文的项目代码:

点击打开链接

如果您有任何问题,欢迎给我留言。

使用iOS 8 SDK添加Touch ID指纹识别功能