更新记录

1.1.0（2023-08-14）

增加取消的错误标识(android code 10取消 ios code 4取消 鸿蒙 code 10取消)已完成 适配鸿蒙指纹识别功能 已完成

1.0.0（2023-07-11）

• 1.0.0 适配鸿蒙、安卓、iOS； 文本内容支持国际化，自定义提示文本； API功能简单易用，易上手 支持vue、nvue页面使用

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

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

介绍

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

使用

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

更多定制功能请联系微信:soushin6

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调用说明

错误码

附录

鸿蒙错误码

Android 面容错误码 指纹错误码

iOS错误码

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