android 调用系统指纹接口 安卓屏幕指纹插件

面容、指纹识别插件(uni-face-login)

介绍

人脸指纹登录授权，可以使用手机自带的人脸、指纹进行生物识别，进而判断是否机主本人，从而进行授权验证，适配安卓、iOS、鸿蒙设备

猛戳这里去插件市场看看

使用

该插件支持鸿蒙、安卓、iOS系统设备； 鸿蒙设备测试面容、指纹适配正常； 最低支持安卓5.0，因为安卓6.0开始才有的指纹，6.0以下会返回错误码，6.0或6.0以上正常，且国内厂商禁止使用人脸认证，只能调起指纹识别； iOS最低支持11.0，设备会先进行面容识别(iOS从iphonex开始有的面容识别，之前版本支持指纹识别)，认证失败两次会进行密码认证，继续失败手机会锁住，锁屏时间会累加

vue代码调用示例

<template>
	<view>
		<view style="height: 50rpx;"></view>
		<button @click="callInit()">Sdk初始化</button>
		<view style="height: 50rpx;"></view>
		<button @click="callNative()">人脸登录</button>
		<view style="height: 50rpx;"></view>
		<button @click="callSupport()">是否支持人脸、指纹认证</button>
		<view style="height: 50rpx;"></view>
		<button @click="callDebug()">调试日志开关配置</button>
	</view>
</template>

<script>
	var faceLogin = uni.requireNativePlugin("CZ-FaceLogin")

	export default {
		data() {
			return {
				
			}
		},
		methods: {
			callInit(){
				var ret = faceLogin.createFace();
				uni.showModal({
					title:'提示',
					content:JSON.stringify(ret)
				})
			},
			callNative(){
				console.log("调用原始方法")
				faceLogin.authLogin({
						'fingerTitle': '123指纹识别',
						'fingerContent': '请123使用指纹识别',
						'loadingText':'识别。。。',
						'passwordHint':'请输入密码，确保环境安全'
					},
					(ret) => {
						console.log(ret)
						uni.showModal({
							title:'提示',
							content:JSON.stringify(ret)
						})
					})
			},
			callSupport(){
				faceLogin.isSupport(
					(ret)=>{
						uni.showModal({
							title:'提示',
							content:JSON.stringify(ret)
						})
					}
				);
			},
			callDebug(){
				var ret = faceLogin.debug({'enableLog': true,});
				uni.showModal({
					title:'提示',
					content:JSON.stringify(ret)
				})
			}, 
		}
	}
</script>

<style>

</style>

nvue代码调用示例

<template>
	<div>
		<div style="height: 50rpx;"></div>
		<button @click="callInit">Sdk初始化</button>
		<div style="height: 50rpx;"></div>
		<button @click="callNative">人脸登录</button>
		<div style="height: 50rpx;"></div>
		<button @click="callSupport">是否支持人脸、指纹认证</button>
		<div style="height: 50rpx;"></div>
		<button @click="callDebug">调试日志开关配置</button>
	</div>
</template>

<script>
	var faceLogin = uni.requireNativePlugin("CZ-FaceLogin")

	export default {
		onLoad() {
			uni.setNavigationBarTitle({
				title:"人脸认证nvue"
			})
		},
		methods: {
			callInit(){
				var ret = faceLogin.createFace();
				uni.showModal({
					title:'提示',
					content:JSON.stringify(ret)
				})
			},
			callNative(){
				faceLogin.authLogin({
						'fingerTitle': '指纹识别',
						'fingerContent': '请使用指纹识别',
						'loadingText':'识别。。。',
						'passwordHint':'请输入密码，确保环境安全'
					},
					(ret) => {
						uni.showModal({
							title:'提示',
							content:JSON.stringify(ret)
						})
					})
			},
			callSupport(){
				faceLogin.isSupport(
					(ret)=>{
						uni.showModal({
							title:'提示',
							content:JSON.stringify(ret)
						})
					}
				);
			},
			callDebug(){
				var ret = faceLogin.debug({'enableLog': true,});
				uni.showModal({
					title:'提示',
					content:JSON.stringify(ret)
				})
			}, 
		}
	}
</script>
<style>
</style>

权限申请

鸿蒙 + android

//离线打包需要在AndroidManifest.xml里面增加
    <uses-permission android:name="android.permission.USE_BIOMETRIC" />
    <uses-permission android:name="android.permission.USE_FINGERPRINT" />
    <uses-permission android:name="android.permission.CAMERA" />
	
    <uses-sdk tools:overrideLibrary="com.huawei.security.localauthentication"/>

iOS

//离线打包需要在info.plist里面增加
	NSFaceIDUsageDescription

API调用说明

API	描述	参数	必须
createFace()	初始化识别SDK，在调用其他api之前必须调用此方法，否则会返回504	无	否
authLogin()	开始识别	fingerTitle 安卓指纹识别标题， fingerContent 安卓指纹识别描述， loadingText 鸿蒙、安卓面容识别等待框提示文本， passwordHint iOS密码认证的提示文本; callback:返回内容见下方错误码说明	否
isSupport()	当前设备是否支持生物识别（指纹/面容）	callback:返回code=0支持，code=1不支持	是
debug()	设置调试日志输出开关	enableLog true开 false关，默认关	是

错误码

错误码	描述
0	识别成功
1	识别失败
2	设备识别错误，请结合下方附录，或查看开发文档
3	帮助信息，一些距离远近、识别角度等一些提示，看需处理
4	取消
501	当前系统未录入信息
502	当前系统不支持人脸识别，或是人脸识别权限未开
503	当前系统不支持生物识别
504	请调用createFace()初始化SDK

附录

鸿蒙错误码

错误码	值	描述	解决方法
FACE_ERROR_HW_UNAVAILABLE	1	硬件不可用。	请确认设备类型和OS版本是否支持，参见支持的设备。
FACE_ERROR_UNABLE_TO_PROCESS	2	传感器无法处理当前图像。	如问题反复出现，请使用在线提单联系维护人员。
FACE_ERROR_TIMEOUT	3	人脸识别超时。	请在短时间内完成识别。
FACE_ERROR_NO_SPACE	4	没有足够的存储空间。人脸识别不会返回此错误码。	-
FACE_ERROR_CANCELED	5	硬件临时不可用，操作被取消。	请稍后重试。
FACE_ERROR_UNABLE_TO_REMOVE	6	删除人脸失败。人脸识别不会返回此错误码。	-
FACE_ERROR_LOCKOUT	7	人脸失败次数过多，人脸识别锁定。	请稍后重试。
FACE_ERROR_VENDOR	8	人脸与机主人脸不匹配。	如机主无法认证通过，建议重新录入人脸后重试。
FACE_ERROR_LOCKOUT_PERMANENT	9	人脸失败次数过多，弱认证锁定。	请使用强认证（如PIN码）解锁。
FACE_ERROR_USER_CANCELED	10	FACE_ERROR_USER_CANCELED	-
FACE_ERROR_NOT_ENROLLED	11	用户未录入人脸。	请录入人脸。
FACE_ERROR_HW_NOT_PRESENT	12	FACE_ERROR_HW_NOT_PRESENT	请确认设备类型和OS版本是否支持，参见支持的设备。

Android面容错误码指纹错误码

面容错误码	值	描述	解决方法
BIOMETRIC_ERROR_HW_UNAVAILABLE	1	硬件不可用。	请确认设备类型和OS版本是否支持。
BIOMETRIC_ERROR_NONE_ENROLLED	11	用户没有注册任何生物信息	建议录入人脸后重试。
BIOMETRIC_ERROR_NO_HARDWARE	12	没有生物识别硬件。	-
BIOMETRIC_ERROR_SECURITY_UPDATE_REQUIRED	15	已发现安全漏洞，并且在安全更新解决此问题之前，传感器将不可用。	-
BIOMETRIC_SUCCESS	0	识别成功	-

指纹错误码	值	描述	解决方法
FINGERPRINT_ACQUIRED_GOOD	0	获取指纹成功	-
FINGERPRINT_ACQUIRED_IMAGER_DIRTY	3	怀疑或检测到传感器上有污垢，指纹图像噪音太大。	清洁后重试。
FINGERPRINT_ACQUIRED_INSUFFICIENT	2	皮肤干燥或传感器可能脏污。	清洁后重试。
FINGERPRINT_ACQUIRED_PARTIAL	1	采集到部分指纹。	应告知用户需要采取什么措施来解决此问题，例如“用力按压传感器”。
FINGERPRINT_ACQUIRED_TOO_FAST	5	采集期间移动手指，指纹图像不完整	将手指在传感器上停留更长时间，适合线性阵列传感器。
FINGERPRINT_ACQUIRED_TOO_SLOW	4	缺乏移动，导致指纹读取失败	请移动手指，适合需要滑动运动的线性阵列传感器。
FINGERPRINT_ERROR_CANCELED	5	操作被取消，当用户切换、设备被锁定或另一个待处理操作阻止或禁用它时，可能会发生这种情况	稍后再试
FINGERPRINT_ERROR_HW_NOT_PRESENT	12	设备不支持指纹传感器	请确认设备类型和OS版本是否支持。
FINGERPRINT_ERROR_HW_UNAVAILABLE	1	硬件不可用	请稍后再试。
FINGERPRINT_ERROR_LOCKOUT	7	操作被取消，因为 API 由于尝试次数过多而被锁定。此情况会在 5 次失败尝试后发生，并持续 30 秒。	请稍后再试。
FINGERPRINT_ERROR_LOCKOUT_PERMANENT	9	由于 FINGERPRINT_ERROR_LOCKOUT 发生次数过多，操作被取消。在用户使用强身份验证（PIN/图案/密码）解锁之前，指纹身份验证将被禁用	-
FINGERPRINT_ERROR_NO_FINGERPRINTS	11	用户没有登记任何指纹	请录入指纹后重试。
FINGERPRINT_ERROR_NO_SPACE	4	没有足够的剩余存储空间来完成该操作	-
FINGERPRINT_ERROR_TIMEOUT	3	等待过长导致超时	-
FINGERPRINT_ERROR_UNABLE_TO_PROCESS	2	无法处理当前指纹图像	-
FINGERPRINT_ERROR_USER_CANCELED	10	用户已取消	-

iOS错误码

错误码	值	描述	解决方法
appCancel	-9	该应用程序取消了身份验证。	-
systemCancel	-4	系统取消了认证。	-
userCancel	-2	用户点击身份验证对话框中的取消按钮。	-
biometryDisconnected	-13	该设备仅使用可拆卸附件支持生物识别，但未连接配对的附件。	-
biometryNotPaired	-12	该设备仅使用可拆卸配件支持生物识别，但未配对任何配件。	-
biometryLockout	-8	由于失败的尝试次数过多，生物认证已被锁定。	-
biometryNotAvailable	-6	该设备不支持生物识别。	请确认设备是否支持。
biometryNotEnrolled	-7	用户没有注册生物识别身份。	请注册。
authenticationFailed	-1	用户未能提供有效的凭据。	-
invalidContext	-10	上下文不可用。	-
invalidDimensions	-14	-	-
notInteractive	-1004	禁止显示所需的认证用户界面。	-
passcodeNotSet	-5	设备上未设置密码。	请设置密码后重试。
userFallback	-3	用户点击身份验证对话框中的回退按钮，但身份验证策略没有可用的回退按钮。	-
watchNotAvailable	-11	尝试使用 Apple Watch 进行身份验证失败。	请稍后重试。

• 华为鸿蒙人脸认证SDK开发文档
• Android人脸认证SDK开发文档
• iOS人脸认证SDK开发文档