鸿蒙HarmonyOS开发实战—安全管理（生物特征识别开发）_鸿蒙人脸检测开发当前版本提供的生物特征识别能力只包含人脸

当前版本提供的生物特征识别能力只包含人脸识别，且只支持本地认证，不提供认证界面。
要求设备上具备摄像器件，且人脸图像像素大于100*100。
要求设备上具有TEE安全环境，人脸特征信息高强度加密保存在TEE中。
对于面部特征相似的人、面部特征不断发育的儿童，人脸特征匹配率有所不同。如果对此担忧，可考虑其他认证方式。

生物特征识别开发

场景介绍

当前生物特征识别支持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  biometricAuthentication = BiometricAuthentication.getInstance(MainAbility.mAbility);

复制

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

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

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

复制

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

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

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

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

复制

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

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

复制

获得认证过程中的提示信息，代码示例如下：

AuthenticationTips tips = biometricAuthentication.getAuthenticationTips();

复制

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

Signature sign = biometricAuthentication.getSecureObjectSignature();

Cipher cipher = biometricAuthentication.getSecureObjectCipher();

Mac mac = biometricAuthentication.getSecureObjectMac();

复制

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

int ret = biometricAuthentication.cancelAuthenticationAction();

最后，为了能让大家更好的去学习提升鸿蒙 (Harmony OS) 开发技术，小编连夜整理了一份30个G纯血版学习资料（含视频、电子书、学习文档等）以及一份在Github上持续爆火霸榜的《纯血版华为鸿蒙 (Harmony OS)开发手册》（共计890页），希望对大家有所帮助。

纯血版鸿蒙 HarmonyOS 4.0 视频学习资料

需要以上视频学习资料小伙伴

请点击→纯血版全套鸿蒙HarmonyOS学习资料

《纯血版华为鸿蒙 (Harmony OS)开发手册》

这份手册涵盖了当前鸿蒙 (Harmony OS) 开发技术必掌握的核心知识点

纯血版鸿蒙 (Harmony OS)开发手册部分精彩内容

HarmonyOS 概念：

系统定义
技术架构
技术特性
系统安全

如何快速入门？

基本概念
构建第一个ArkTS应用
构建第一个JS应用
……

开发基础知识：

应用基础知识
配置文件
应用数据管理
应用安全管理
应用隐私保护

鸿蒙HarmonyOS开发实战—安全管理（生物特征识别开发）_鸿蒙 人脸检测开发