阅读(3181)
赞(0)
鸿蒙OS 生物特征识别开发指导
2020-09-17 09:45:40 更新
场景介绍
当前生物特征识别支持 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();