Android6.0 Fingerprint Features（指纹识别）

关于指纹识别需要了解的：

• 要开启指纹识别，必须开启密码锁屏（Pin，Password，Pattern等），如果锁屏密码被清除，或者设置为滑动，之前录入的指纹会被删除。

• 识别错误回调onAuthenticationFailed，错误六次之后，回调onAuthenticationError，onAuthenticationError被回调后，后续不会再有任何回调（直到取消本次指纹输入，重新调用authenticate后才可以）

• onAuthenticationError发生后，即使退出后重新调用authenticate方法，仍然马上就会回调onAuthenticationError方法，而不是等待输入指纹，只有间隔一定时间之后，重新调用authenticate，才能开启指纹传感器等待输入指纹

---

简介

最新的Android6.0系统中的指纹识别功能是一大亮点，开发者可以考虑用这个功能来简化一些鉴权方面的UI交互（避免频繁输入password，也避免用户记太多的password）。新的SDK中指纹识别api被分为两类，一类为Fingerprint API，另一类为Confirm Credential, 本文分别介绍这两类api各自特点相互的区别，以及使用方法。

---

Fingerprint API & Confirm Credential 区别

• Fingerprint API一个纯指纹相关的API,就是为了提供指纹鉴别的功能，调用authenticate (callback)后指纹传感器开始等待指纹录入，用户录入指纹后通过callback回调识别是否成功（实际的authenticate方法还有一些其他的参数），这个API没有任何系统UI，所以开发者可以设计指纹识别流程的UI，只要确保正确的调用authenticate(callback)方法，正确的处理其中的callback即可。

• Confirm Credential 核心是提供了一个系统的解锁界面Activity，使用的时候首先用mKeyguardManager.createConfirmDeviceCredentialIntent(null, null);方法获取到一个Intent，然后 startActivityForResult(intent, REQUEST_CODE_CONFIRM_DEVICE_CREDENTIALS)的方式拉起Activity，解锁是否成功则在onActivityResult回调中体现。这个系统的解锁界面类似锁屏界面，可以用锁屏密码或者指纹解锁。
  注意：此处的解锁界面具体解锁方式和手机锁屏设置一致，例如锁屏设置的是图案解锁那么这里就是图案解锁，锁屏设置的是密码或者PIN码解锁，那么这里也是密码或者PIN码解锁。

---

Fingerprint API的使用：

**首先记得在manifest中添加<uses-permission
android:name="android.permission.USE_FINGERPRINT" />权限**
使用前先判断是否硬件支持，是否有指纹等：

if (!mFingerprintManager.isHardwareDetected()) {               // 判断硬件是否支持                Toast.makeText(this,                        "Fingerprint hardward unavailable",                        Toast.LENGTH_LONG).show();                return;            }if (!mKeyguardManager.isKeyguardSecure()) {            // 判断用户是已经开启锁屏密码            Toast.makeText(this,                    "Secure lock screen hasn't set up.\n"                            + "Go to 'Settings -> Security -> Screenlock' to set up a lock screen",                    Toast.LENGTH_LONG).show();            return;        }if (!mFingerprintManager.hasEnrolledFingerprints()) {                // 判断是否有已经录入的指纹                Toast.makeText(this,                        "Go to 'Settings -> Security -> Fingerprint' and register at least one fingerprint",                        Toast.LENGTH_LONG).show();                return;            }

使用startListening()打开指纹传感器：

boolean mSelfCancelled = false;    public boolean isFingerprintAuthAvailable() {        return mFingerprintManager.isHardwareDetected()                && mFingerprintManager.hasEnrolledFingerprints();    }    public void startListening(FingerprintManager.CryptoObject cryptoObject) {        if (!isFingerprintAuthAvailable()) {            return;        }        mSelfCancelled = false;        CancellationSignal mCancellationSignal = new CancellationSignal();        mFingerprintManager                .authenticate(null, mCancellationSignal, 0, callback , null);    }    public void stopListening() {        if (mCancellationSignal != null) {            mSelfCancelled = true;            mCancellationSignal.cancel();            mCancellationSignal = null;        }    }

使用callback定义回调：(callback为上面authenticate()方法中的一个参数)

FingerprintManager.AuthenticationCallback callback = new FingerprintManager.AuthenticationCallback() {        @Override        public void onAuthenticationError(int errMsgId, CharSequence errString) {            if (!mSelfCancelled) {                showError(errString);            }        }        @Override        public void onAuthenticationHelp(int helpMsgId, CharSequence helpString) {            showError(helpString);        }        @Override        public void onAuthenticationFailed() {            showError(getActivity().getResources().getString(                    R.string.fingerprint_not_recognized));        }        @Override        public void onAuthenticationSucceeded(FingerprintManager.AuthenticationResult result) {            showSuccess();        }

---

Confirm Credential 的使用

由于认证页面为系统的一个Activity所以，app本身 不需要 申明指纹权限<uses-permission
android:name="android.permission.USE_FINGERPRINT" />
使用前先判断是否已经开启锁屏密码：(如果没有开启，后面的createConfirmDeviceCredentialIntent()方法会反回一个null 的intent)

if (!mKeyguardManager.isKeyguardSecure()) {            // 判断用户是已经开启锁屏密码            Toast.makeText(this,                    "Secure lock screen hasn't set up.\n"                            + "Go to 'Settings -> Security -> Screenlock' to set up a lock screen",                    Toast.LENGTH_LONG).show();            return;        }

在Activity中唤起系统认证页面：

    private void showAuthenticationScreen() {        // createConfirmDeviceCredentialIntent（title,description）中可以自定义解锁页面的title和description：        Intent intent = mKeyguardManager.createConfirmDeviceCredentialIntent(null, null);        if (intent != null) {            startActivityForResult(intent, REQUEST_CODE_CONFIRM_DEVICE_CREDENTIALS);        }    }

在onActivityResult()中处理回调：

@Override    protected void onActivityResult(int requestCode, int resultCode, Intent data) {        if (requestCode == REQUEST_CODE_CONFIRM_DEVICE_CREDENTIALS) {            // Challenge completed, proceed with using cipher            if (resultCode == RESULT_OK) {                showSuccess();            } else {                showError();            }        }    }