场景介绍

当前生物特征识别支持 2D 人脸识别、3D 人脸识别，可应用于设备解锁、应用登录、支付等身份认证场景。

接口说明

BiometricAuthentication 类提供了生物认证的相关方法，包括检测认证能力、认证和取消认证等，用户可以通过人脸等生物特征信息进行认证操作。在执行认证前，需要检查设备是否支持该认证能力，具体指认证类型、安全级别和是否本地认证。如果不支持，需要考虑使用其他认证能力。

开发步骤

开发前请完成以下准备工作：

1. 在应用配置权限文件中，增加 ohos.permission.ACCESS_BIOMETRIC 的权限声明。
2. 在使用生物特征识别认证能力的代码文件中增加 import ohos.biometrics.authentication.BiometricAuthentication。

开发过程：

1. 获取 BiometricAuthentication 的单例对象，代码示例如下：

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

1. 检测设备是否具有生物认证能力：

2D 人脸识别建议使用 SECURE_LEVEL_S2，3D 人脸识别建议使用 SECURE_LEVEL_S3。代码示例如下：

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

1. （可选）设置需要关联认证结果的 Signature 对象或 Cipher 对象或 Mac 对象，代码示例如下：

   // 定义一个Signature对象sign;
   mBiometricAuthentication.setSecureObjectSignature(sign);

    
   // 定义一个Cipher对象cipher;
   mBiometricAuthentication.setSecureObjectCipher(cipher);

    
   // 定义一个Mac对象mac;
   mBiometricAuthentication.setSecureObjectMac(mac);

1. 在新线程里面执行认证操作，避免阻塞其他操作，代码示例如下：

   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. 获得认证过程中的提示信息，代码示例如下：

   AuthenticationTips  mTips = mBiometricAuthentication.getAuthenticationTips();

1. （可选）认证成功后获取已设置的 Signature 对象或 Cipher 对象或 Mac 对象，代码示例如下：

   Signature  sign = mBiometricAuthentication.getSecureObjectSignature();

    
   Cipher cipher = mBiometricAuthentication.getSecureObjectCipher();

    
   Mac mac = mBiometricAuthentication.getSecureObjectMac();

1. 认证过程中取消认证，代码示例如下：

   int  ret = mBiometricAuthentication.cancelAuthenticationAction();