更新记录

3.18.0（2026-06-08） 下载此版本

1. AddFace 返回人脸640*480原图
2. 去除打包警告信息
3. 准备Pro 版本SDK
4. 其他细节优化

3.17.2（2026-06-05） 下载此版本

Android AAR包更新

3.17.1（2026-06-03） 下载此版本

1. 修复iOS 录入人脸没有返回base64 问题

平台兼容性

uni-app(5.02)

uni-app x(5.02)

其他

FaceAISDK人脸识别UTS API插件简介

1:1人脸识别，活体检测插件，支持iOS，Android，支持vue2，vue3和uvue。
所有功能无需后台API服务可完全离线运行，高性能无依赖其他三方SDK服务

感谢点赞收藏，如有问题可 到GitHub提issues , 邮件联系 或 Wv：FaceAISDK
详细的信息有助于我们更好更快解决问题（Hbuilder版本，Vue版本，平台，功能和场景等）

使用方法

如果你是第一次运行UTS插件工程/引入UTS API插件，你应先安装官方说明配置好基础环境 基础环境

1. 下载最新示例项目到HbuilderX先跑通；熟悉后再参考文档集成到你的主项目

2. 运行 -》 运行到手机或模拟器 -》制作自定义调试基座 -》打包 （期间不要修改原生代码）

3. 运行 -》运行到iOS/Android基座 -》使用自定义基座运行 -》本地基座 -》运行

4. 把插件引入到你的主项目（即 import {faceVerify,**等方法} from "@/uni_modules/本插件名称ID";）

按照步骤一定要先制作自定义调试基准，然后运行的时候使用自定义基准。偶尔打包服务器失败请重试

常见问题解决方法

出现错误可以把错误信息发给AI Agent分析，常见可能的错误与解决方法如下

1.UI交互效果不符合业务需求？

目前插件只有字体主题颜色能修改，如果你要修改UI样式等需要自行修改原生代码封装插件
iOS SDK： https://github.com/FaceAISDK/FaceAISDK_iOS
Android： https://github.com/FaceAISDK/FaceAISDK_Android

2.炫彩活体提示光线太亮导致失败

这个基本上只能规避强光环境了，或引导用户用手遮住强烈光线，让手机彩色光能照到脸部
室外强光环境建议使用动作活体+静默活体检测

3.改动原生Kotlin/Swift 代码导致基座不能正常运行

自定义基座打好后不能再改动原生Kotlin/Swift代码，改动后需重新打包

人脸识别，活体检测状态码

人脸识别，活体检测状态码含义

    let DEFAULT = 0                  // 0   初始化状态，流程没有开始
    let VERIFY_SUCCESS = 1           // 1   人脸识别对比成功大于设置的threshold
    let VERIFY_FAILED = 2            // 2   人脸识别对比识别小于设置的threshold
    let MOTION_LIVENESS_SUCCESS = 3  // 3   动作活体检测成功（基本不用，还有后续动作）
    let MOTION_LIVENESS_TIMEOUT = 4  // 4   动作活体超时
    let NO_FACE_MULTI = 5            // 5   多次没有检测到人脸
    let NO_FACE_FEATURE = 6          // 6   没有对应的人脸特征值
    let COLOR_LIVENESS_SUCCESS = 7   // 7   炫彩活体成功
    let COLOR_LIVENESS_FAILED = 8    // 8   炫彩活体失败  
    let COLOR_LIVENESS_LIGHT_TOO_HIGH = 9 // 9炫彩活体失败，光线亮度过高  
    let ALL_LIVENESS_SUCCESS = 10    // 10  所有的活体检测完成(包括动作和炫彩)  
    let SILENT_LIVENESS_FAILED = 11  // 11  静默活体检测失败  
    let NO_BASE_FACE_FEATURE = 12    // 12  没有录入人脸信息  
    let NOT_ALLOW_MULTI_FACES = 13   // 13  多人脸出现在镜头

发现BUG，新功能需求？提个Issues吧：https://github.com/FaceAISDK/FaceAISDK_uniapp_UTS/issues
更多合作：FaceAISDK.Service@gmail.com

Android 完整版本SDK API Demo：

原生Android完整版本支持VUC协议摄像头，从相册导入人脸等更多功能

1:N人脸搜索识别插件：https://ext.dcloud.net.cn/plugin?id=26467