HarmonyOS中的生物识别技术如何集成？

Question

HarmonyOS中的生物识别技术如何集成？

言之有物

541225

发布于
2024-08-05 上海

开发者如何在HarmonyOS中集成生物识别技术（如指纹识别、面部识别）？有哪些生物识别API？

harmonyos

阅读 733

AI BotBETA

在HarmonyOS中集成生物识别技术，如指纹识别和面部识别，主要通过使用HarmonyOS提供的生物特征识别API来实现。以下是一个详细的步骤和API介绍，帮助开发者在HarmonyOS应用中集成生物识别技术。

生物识别API概述

HarmonyOS提供了BiometricAuthentication类，该类提供了生物认证的相关方法，包括检测认证能力、执行认证操作、取消认证等。这些API支持开发者在应用中集成生物识别功能，如指纹识别和面部识别。

集成步骤

添加权限

在应用配置权限文件中，需要增加ohos.permission.ACCESS_BIOMETRIC的权限声明，以允许应用访问生物识别硬件。

<!-- 在config.json中添加权限 -->
{
    "module": {
        "reqPermissions": [
            {
                "name": "ohos.permission.ACCESS_BIOMETRIC"
            }
        ]
    }
}

引入API
在需要使用生物特征识别认证能力的代码文件中，需要引入BiometricAuthentication类。
```
import ohos.biometrics.authentication.BiometricAuthentication;
```
获取BiometricAuthentication实例
通过BiometricAuthentication.getInstance(MainAbility.mAbility)获取BiometricAuthentication的单例对象。
```
BiometricAuthentication biometricAuthentication = BiometricAuthentication.getInstance(MainAbility.mAbility);
```

检查认证能力

在执行认证前，需要检查设备是否支持所需的生物识别能力（如指纹识别、面部识别），以及认证的安全级别和是否支持本地认证。

int retChkAuthAvb = biometricAuthentication.checkAuthenticationAvailability(
    BiometricAuthentication.AuthType.AUTH_TYPE_BIOMETRIC_FACE_ONLY, // 或其他类型，如AUTH_TYPE_BIOMETRIC_FINGERPRINT
    BiometricAuthentication.SecureLevel.SECURE_LEVEL_S2, // 面部识别建议使用S2，指纹识别可能有所不同
    true);

执行认证操作

在新线程中执行认证操作，以避免阻塞主线程。

new Thread(new Runnable() {
    @Override
    public void run() {
        int retExcAuth = biometricAuthentication.execAuthenticationAction(
            BiometricAuthentication.AuthType.AUTH_TYPE_BIOMETRIC_FACE_ONLY,
            BiometricAuthentication.SecureLevel.SECURE_LEVEL_S2,
            true,
            false,
            null);
        // 处理认证结果
    }
}).start();

处理认证结果和错误
根据execAuthenticationAction的返回值处理认证结果或错误。
可选设置
如果需要，可以在认证过程中设置与认证结果关联的Signature对象、Cipher对象或Mac对象，以便在认证成功后使用这些对象进行进一步操作。
```
biometricAuthentication.setSecureObjectSignature(sign);
biometricAuthentication.setSecureObjectCipher(cipher);
biometricAuthentication.setSecureObjectMac(mac);
```
获取提示信息
可以通过getAuthenticationTips方法获取认证过程中的提示信息。
```
AuthenticationTips tips = biometricAuthentication.getAuthenticationTips();
```
取消认证
如果需要，可以在认证过程中通过cancelAuthenticationAction方法取消认证。
```
int ret = biometricAuthentication.cancelAuthenticationAction();
```