鸿蒙HarmonyOS开发实战—安全管理（生物特征识别开发(2)

接口说明

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。

开发步骤

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

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

开发过程：

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

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

复制

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

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);

复制

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

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

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

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

复制

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

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();

复制

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

AuthenticationTips tips = biometricAuthentication.getAuthenticationTips();

复制

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

Signature sign = biometricAuthentication.getSecureObjectSignature();

Cipher cipher = biometricAuthentication.getSecureObjectCipher();

Mac mac = biometricAuthentication.getSecureObjectMac();

复制

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

int ret = biometricAuthentication.cancelAuthenticationAction();

---

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

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

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

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

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数HarmonyOS鸿蒙开发工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年HarmonyOS鸿蒙开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上HarmonyOS鸿蒙开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新

如果你觉得这些内容对你有帮助，可以添加VX：vip204888 （备注鸿蒙获取）

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

VX：vip204888 （备注鸿蒙获取）**
[外链图片转存中…(img-svqJyhDj-1712814223935)]

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！