寫(xiě)作不易趴酣，轉(zhuǎn)載請(qǐng)注明出處：https://blog.csdn.net/qq_34676644/article/details/118758483
or
http://www.reibang.com/p/530c9fa31786

前言

官方的指紋識(shí)別在Android 6.0引入岖寞，Android 6.0之前指紋識(shí)別由廠商自己定義仗谆。所以Android 6.0之前的指紋識(shí)別碎片化嚴(yán)重隶垮。

概覽

1.類(lèi)

1.FingerprintManager：Android 6.0引入狸吞，Android 9.0 廢棄捷绒。使用時(shí)需加入權(quán)限：permission USE_FINGERPRINT

注：包含檢查是否支持指紋暖侨，指紋比對(duì)是否成功等字逗。支持包中的FingerprintManagerCompat類(lèi)對(duì)其作了包裝和兼容處理宅广。不做詳細(xì)介紹

2.BiometricManager：Android 9.0引入葫掉。其不僅包含指紋識(shí)別俭厚，還包含人臉識(shí)別等其他驗(yàn)證方式挪挤。
其主要功能為：檢查當(dāng)前設(shè)備是否具有指紋識(shí)別的條件，例如：設(shè)備是否具有指紋識(shí)別的硬件扛门，指紋是否已經(jīng)錄入论寨，硬件是否可用等葬凳。
需要配合權(quán)限permission USE_BIOMETRIC使用

注：目前，該類(lèi)只有指紋識(shí)別的相關(guān)API辕坝，以后可能會(huì)加入人臉識(shí)別等其他生物識(shí)別的相關(guān)API酱畅。
推薦使用AndroidX支持庫(kù)中的類(lèi)纺酸，其已經(jīng)對(duì)Android 6.0-Android 11做了兼容性處理：

• 在Android 9 版本和之前版本中會(huì)調(diào)用FingerprintManagerCompat
• 在Android 10 版本開(kāi)始會(huì)調(diào)用框架層BiometricManager

3.BiometricPrompt:
其主要功能為：發(fā)起指紋驗(yàn)證
需要配合權(quán)限permission USE_BIOMETRIC使用

4.BiometricPrompt.PromptInfo:
其主要功能為：驗(yàn)證對(duì)話框

通過(guò)其內(nèi)部類(lèi)BiometricPrompt.PromptInfo.Builder餐蔬，采用創(chuàng)造者模式配置對(duì)話框樊诺。僅能配置少量參數(shù)音同，例如：標(biāo)題权均，副標(biāo)題等叽赊。這意味著：
1.不分Android版本，對(duì)話框的樣式統(tǒng)一
2.無(wú)法自定義對(duì)話款樣式

2.權(quán)限

1. permission USE_FINGERPRINT:使用FingerprintManager及FingerprintManagerCompat類(lèi)進(jìn)行指紋識(shí)別時(shí)囊咏，需獲取此權(quán)限匆笤。

   此權(quán)限為：Normal Permission

2. permission USE_BIOMETRIC：使用BiometricManager等類(lèi)進(jìn)行指紋識(shí)別時(shí)庶诡，需獲取此權(quán)限末誓。

   當(dāng)使用AndroidX支持庫(kù)中的BiometricManager時(shí)候不需要聲明此權(quán)限喇澡，因?yàn)橹С謳?kù)中已經(jīng)添加此權(quán)限

詳細(xì)介紹

1.BiometricManager屬性和方法

• 是否可用的狀態(tài)碼

• 方法:

在canAuthenticate (int authenticators)中 authenticators取值為：

• BIOMETRIC_STRONG： 滿足第三類(lèi)要求的生物識(shí)別傳感器
• BIOMETRIC_WEAK：滿足第二類(lèi)要求的生物識(shí)別傳感器
• DEVICE_CREDENTIAL：滿足安全設(shè)備的要求 (PIN, pattern, or password)
  一般來(lái)說(shuō)級(jí)別越高眷柔，安全性越高驯嘱。詳情：聲明您的應(yīng)用支持的身份驗(yàn)證類(lèi)型
  一般采用：BIOMETRIC_WEAK

注意：Android 10（API 級(jí)別 29）及更低版本不支持以下身份驗(yàn)證器類(lèi)型組合：DEVICE_CREDENTIAL 和 BIOMETRIC_STRONG | DEVICE_CREDENTIAL鞠评。如需檢查 Android 10 及更低版本中是否存在 PIN 碼、解鎖圖案或密碼聋涨，請(qǐng)使用 KeyguardManager.isDeviceSecure()方法

2.BiometricPrompt屬性和方法

• 驗(yàn)證的結(jié)果常用錯(cuò)誤碼（不全）：

• 方法：

實(shí)戰(zhàn)

第一步：引入支持庫(kù)

implementation "androidx.biometric:biometric:1.1.0"

第二步：檢查指紋硬件是否可用

/**
*返回值見(jiàn)上文的“是否可用的狀態(tài)碼”
*/
public int isFingerprintAvailable(Context context){
    BiometricManager manager = BiometricManager.from(context);
    return manager.canAuthenticate(BiometricManager.Authenticators.BIOMETRIC_WEAK);
}

第三步：開(kāi)始驗(yàn)證

/**
     * 開(kāi)始驗(yàn)證
     *
     * @param activity
     * @param callBack 驗(yàn)證結(jié)果回調(diào)
     */
    public void authenticate(FragmentActivity activity, BiometricPrompt.AuthenticationCallback callBack) {
        BiometricPrompt.PromptInfo promptInfo = createUi();
        BiometricPrompt prompt = new BiometricPrompt(activity, ContextCompat.getMainExecutor(activity), callBack);
        prompt.authenticate(promptInfo);
    }

    private BiometricPrompt.PromptInfo createUi() {
        return new BiometricPrompt.PromptInfo.Builder()
                .setTitle("Register Fingerprint")
                .setSubtitle("Pls Touch the sensor")
                .setNegativeButtonText("Use App Password")
                .build()
    }

第四步：獲取驗(yàn)證結(jié)果

authenticate(mView, new BiometricPrompt.AuthenticationCallback() {

            /**
             * 驗(yàn)證過(guò)程中發(fā)生了錯(cuò)誤
             * @param errorCode
             * @param errString
             */
            @Override
            public void onAuthenticationError(int errorCode, @NonNull CharSequence errString) {
                switch (errorCode) {
                    case ERROR_USER_CANCELED:
                        UIUtils.toast("取消了指紋識(shí)別");
                        break;
                    case ERROR_LOCKOUT:
                        UIUtils.toast("失敗5次钠怯，已鎖定刽锤，請(qǐng)30秒后在試");
                        break;
                    case ERROR_LOCKOUT_PERMANENT:
                        UIUtils.toast("失敗次數(shù)太多宋彼，指紋驗(yàn)證已鎖定莱坎，請(qǐng)改用密碼乃正，圖案等方式解鎖");
                    case ERROR_NEGATIVE_BUTTON:
                        UIUtils.toast("點(diǎn)擊了negative button");
                        break;
                    case ERROR_NO_DEVICE_CREDENTIAL:
                        UIUtils.toast("尚未設(shè)置密碼名党，圖案等解鎖方式");
                        break;
                    case ERROR_NO_SPACE:
                        UIUtils.toast("可用空間不足");
                        break;
                    case ERROR_TIMEOUT:
                        UIUtils.toast("驗(yàn)證超時(shí)");
                        break;
                }
            }


            @Override
            public void onAuthenticationSucceeded(@NonNull BiometricPrompt.AuthenticationResult result) {
                UIUtils.toast("驗(yàn)證成功");

            }

            /**
             * 驗(yàn)證失敗
             * @param
             */
            @Override
            public void onAuthenticationFailed() {
                super.onAuthenticationFailed();
                UIUtils.toast("驗(yàn)證失敗委煤，請(qǐng)重試");
            }
        });

效果

屏上指紋	屏下指紋
屏上指紋	屏下指紋

參考：

[1] BiometricManager
[2] BiometricPrompt
[3] Android Google源生生物識(shí)別(Biometric依賴庫(kù))
[4] Android指紋識(shí)別兴使，兼容6.0以上所有版本励幼，包括9.0適配
[5] 指紋登錄 - FingerprintManager