鴻蒙OS 生物特征識(shí)別開發(fā)指導(dǎo)

場(chǎng)景介紹

當(dāng)前生物特征識(shí)別支持 2D 人臉識(shí)別、3D 人臉識(shí)別，可應(yīng)用于設(shè)備解鎖、應(yīng)用登錄、支付等身份認(rèn)證場(chǎng)景。

接口說明

BiometricAuthentication 類提供了生物認(rèn)證的相關(guān)方法，包括檢測(cè)認(rèn)證能力、認(rèn)證和取消認(rèn)證等，用戶可以通過人臉等生物特征信息進(jìn)行認(rèn)證操作。在執(zhí)行認(rèn)證前，需要檢查設(shè)備是否支持該認(rèn)證能力，具體指認(rèn)證類型、安全級(jí)別和是否本地認(rèn)證。如果不支持，需要考慮使用其他認(rèn)證能力。

開發(fā)步驟

開發(fā)前請(qǐng)完成以下準(zhǔn)備工作：

1. 在應(yīng)用配置權(quán)限文件中，增加 ohos.permission.ACCESS_BIOMETRIC 的權(quán)限聲明。
2. 在使用生物特征識(shí)別認(rèn)證能力的代碼文件中增加 import ohos.biometrics.authentication.BiometricAuthentication。

開發(fā)過程：

1. 獲取 BiometricAuthentication 的單例對(duì)象，代碼示例如下：

   BiometricAuthentication  mBiometricAuthentication = BiometricAuthentication.getInstance(MainAbility.mAbility);

1. 檢測(cè)設(shè)備是否具有生物認(rèn)證能力：

2D 人臉識(shí)別建議使用 SECURE_LEVEL_S2，3D 人臉識(shí)別建議使用 SECURE_LEVEL_S3。代碼示例如下：

   int retChkAuthAvb = mBiometricAuthentication.checkAuthenticationAvailability(
   BiometricAuthentication.AuthType.AUTH_TYPE_BIOMETRIC_FACE_ONLY, BiometricAuthentication.SecureLevel.SECURE_LEVEL_S2, true);

1. （可選）設(shè)置需要關(guān)聯(lián)認(rèn)證結(jié)果的 Signature 對(duì)象或 Cipher 對(duì)象或 Mac 對(duì)象，代碼示例如下：

   // 定義一個(gè)Signature對(duì)象sign;
   mBiometricAuthentication.setSecureObjectSignature(sign);

    
   // 定義一個(gè)Cipher對(duì)象cipher;
   mBiometricAuthentication.setSecureObjectCipher(cipher);

    
   // 定義一個(gè)Mac對(duì)象mac;
   mBiometricAuthentication.setSecureObjectMac(mac);

1. 在新線程里面執(zhí)行認(rèn)證操作，避免阻塞其他操作，代碼示例如下：

   new Thread(new Runnable() {
       @Override
       public void run() {
           int retExcAuth;
           retExcAuth = mBiometricAuthentication.execAuthenticationAction(        BiometricAuthentication.AuthType.AUTH_TYPE_BIOMETRIC_FACE_ONLY,        BiometricAuthentication.SecureLevel.SECURE_LEVEL_S2, true, false, null);
       }
   }).start();

1. 獲得認(rèn)證過程中的提示信息，代碼示例如下：

   AuthenticationTips  mTips = mBiometricAuthentication.getAuthenticationTips();

1. （可選）認(rèn)證成功后獲取已設(shè)置的 Signature 對(duì)象或 Cipher 對(duì)象或 Mac 對(duì)象，代碼示例如下：

   Signature  sign = mBiometricAuthentication.getSecureObjectSignature();

    
   Cipher cipher = mBiometricAuthentication.getSecureObjectCipher();

    
   Mac mac = mBiometricAuthentication.getSecureObjectMac();

1. 認(rèn)證過程中取消認(rèn)證，代碼示例如下：

   int  ret = mBiometricAuthentication.cancelAuthenticationAction();