鸿蒙OS 生物特征识别开发指导
场景介绍
当前生物特征识别支持 2D 人脸识别、3D 人脸识别，可应用于设备解锁、应用登录、支付等身份认证场景。
接口说明
BiometricAuthentication 类提供了生物认证的相关方法，包括检测认证能力、认证和取消认证等，用户可以通过人脸等生物特征信息进行认证操作。在执行认证前，需要检查设备是否支持该认证能力，具体指认证类型、安全级别和是否本地认证。如果不支持，需要考虑使用其他认证能力。
| 接口名 | 功能描述 |
|---|---|
| getInstance(Ability ability) | 获取 BiometricAuthentication的单例对象。 |
| checkAuthenticationAvailability(AuthType type, SecureLevel level, boolean isLocalAuth) | 检测设备是否具有生物认证能力。 |
| execAuthenticationAction(AuthType type, SecureLevel level, boolean isLocalAuth,boolean isAppAuthDialog, SystemAuthDialogInfo information) | 调用者使用该方法进行生物认证。可以使用自定义的认证界面，也可以使用系统提供的认证界面。当使用系统认证界面时，调用者可以自定义提示语。该方法直到认证结束才返回认证结果。 |
| getAuthenticationTips() | 获取生物认证过程中的提示信息。 |
| cancelAuthenticationAction() | 取消生物认证操作。 |
| setSecureObjectSignature(Signature sign) | 设置需要关联认证结果的Signature 对象，在进行认证操作后，如果认证成功则Signature 对象被授权可以使用。设置前 Signature 对象需要正确初始化，且配置为认证成功才能使用。 |
| getSecureObjectSignature() | 在认证成功后，可通过该方法获取已授权的 Signature 对象。如果未设置过 Signature 对象，则返回 null。 |
| setSecureObjectCipher(Cipher cipher) | 设置需要关联认证结果的 Cipher 对象，在进行认证操作后，如果认证成功则 Cipher 对象被授权可以使用。设置前 Cipher 对象需要正确初始化，且配置为认证成功才能使用。 |
| getSecureObjectCipher() | 在认证成功后，可通过该方法获取已授权的 Cipher 对象。如果未设置过 Cipher 对象，则返回 null。 |
| setSecureObjectMac(Mac mac) | 设置需要关联认证结果的 Mac 对象，在进行认证操作后，如果认证成功则 Mac 对象被授权可以使用。设置前 Mac 对象需要正确初始化，且配置为认证成功才能使用。 |
| getSecureObjectMac() | 在认证成功后，可通过该方法获取已授权的 Mac 对象。如果未设置过 Mac 对象，则返回 null。 |
开发步骤
开发前请完成以下准备工作：
- 在应用配置权限文件中，增加 ohos.permission.ACCESS_BIOMETRIC 的权限声明。
- 在使用生物特征识别认证能力的代码文件中增加 import ohos.biometrics.authentication.BiometricAuthentication。
开发过程：
- 获取 BiometricAuthentication 的单例对象，代码示例如下：
BiometricAuthentication mBiometricAuthentication = BiometricAuthentication.getInstance(MainAbility.mAbility);- 检测设备是否具有生物认证能力：
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);- （可选）设置需要关联认证结果的 Signature 对象或 Cipher 对象或 Mac 对象，代码示例如下：
// 定义一个Signature对象sign;
mBiometricAuthentication.setSecureObjectSignature(sign);
// 定义一个Cipher对象cipher;
mBiometricAuthentication.setSecureObjectCipher(cipher);
// 定义一个Mac对象mac;
mBiometricAuthentication.setSecureObjectMac(mac);- 在新线程里面执行认证操作，避免阻塞其他操作，代码示例如下：
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();- 获得认证过程中的提示信息，代码示例如下：
AuthenticationTips mTips = mBiometricAuthentication.getAuthenticationTips();- （可选）认证成功后获取已设置的 Signature 对象或 Cipher 对象或 Mac 对象，代码示例如下：
Signature sign = mBiometricAuthentication.getSecureObjectSignature();
Cipher cipher = mBiometricAuthentication.getSecureObjectCipher();
Mac mac = mBiometricAuthentication.getSecureObjectMac();- 认证过程中取消认证，代码示例如下：
int ret = mBiometricAuthentication.cancelAuthenticationAction();