更新记录

1.0.0（2025-04-06）

适配安卓、iOS、鸿蒙Next

平台兼容性

面容、指纹识别插件(uts-auth-login)

介绍

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

使用

该插件支持鸿蒙、安卓、iOS系统设备；
鸿蒙设备测试面容、指纹适配正常；
受UTS插件适配以及华为SDK影响，最低支持安卓9.0，部分国内安卓厂商禁止使用人脸认证，只能调起指纹识别；
iOS最低支持11.0，设备会先进行面容识别(iOS从iphonex开始有的面容识别，之前版本支持指纹识别)，认证失败两次会进行密码认证，继续失败手机会锁住，锁屏时间会累加

插件试用

APK下载

vue代码调用示例

<template>
    <view>
        <page-head :title="title"></page-head>
        <scroll-view>
            <view>
                <view class="uni-padding-wrap uni-common-mt">
                    <button @tap="testAuthLogin">人脸登录</button>
                </view>
                <view class="uni-padding-wrap uni-common-mt">
                    <button @tap="testGetEnrolledType">获取支持认证类型</button>
                </view>
                <view class="uni-padding-wrap uni-common-mt">
                    <button @tap="testDebug">调试日志开关</button>
                </view>
            </view> 
        </scroll-view>  

    </view>
</template>

<script>

    import { enableDebug,getEnrolledType,authLogin } from "@/uni_modules/cz-authlogin";

    export default {
        data() {
            return {
                title:"AuthLogin 示例"
            }
        },
        methods: {
            testAuthLogin(){
                authLogin({
                    param: {
                        fingerTitle :"指纹识别",
                        fingerSubTitle: "请触摸指纹传感器",
                        fingerContent :"请进行指纹识别",
                        passwordHint :"请输入您的密码进行认证",
                        isReuseUnlock:false
                    },
                    success: (response)=>{
                        console.log(""+response);
                        this.showToast(""+response);
                    },
                    fail:(response)=>{
                        console.log(response.errCode+ ", "+response.errMsg);
                        this.showToast(response.errCode+ ", "+response.errMsg);
                    }
                });
            },
            testGetEnrolledType(){
                uni.showToast({
                    icon:'none',
                    title:'是否支持面容指纹识别：'+getEnrolledType()
                })
            },
            testDebug(){
                enableDebug(false);
            },
            showToast(msg){
                if(msg == ''){
                    uni.showToast({
                        icon:'none',
                        title:'未获取到相关信息'
                    })
                }else {
                    uni.showToast({
                        icon:'none',
                        title: msg
                    })
                }
            }
        }
    }
</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

    NSFaceIDUsageDescription

鸿蒙Next

    ohos.permission.ACCESS_BIOMETRIC

API调用说明

错误码

附录

鸿蒙Next错误码

鸿蒙错误码

Android 面容错误码 指纹错误码

iOS错误码

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