人脸识别+活体检测uniapp uts插件，支持iOS和Android

更新记录

2026.04.10（2026-04-10）

1:1人脸识别，活体检测UTS API插件，支持iOS，Android，支持uniappX和uniapp(vue2&vue3)。
所有功能都是设备端侧AI能力可开飞行模式体验无需网络，无需后台API服务可完全离线运行，高性能无依赖

3.11.0（2026-04-10）

平台兼容性

uni-app(5.02)

Vue2	Vue3	Chrome	Safari	app-vue	app-nvue	Android	iOS	鸿蒙
√	√	×	×	√	√	5.0	15	×

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	小红书小程序	快应用-华为	快应用-联盟
×	×	×	×	×	×	×	×	×	×	×	×

uni-app x(5.02)

Chrome	Safari	Android	iOS	鸿蒙	微信小程序
×	×	5.0	15	-	-

其他

多语言	暗黑模式	宽屏模式
√	√	√

人脸识别UTS API插件简介

感谢大家点赞收藏，如有问题可描述你的使用场景说明发送邮件：FaceAISDK.Service@gmial.com
或提issues到本插件GitHub：https://github.com/FaceAISDK/FaceAISDK_uniapp_UTS/issues
我们将尽快排期解决，详细的信息有助于我们更好更快解决（Hbuilder版本，Vue版本，平台，功能和场景等）

快速体验完整人脸识别功能可以下载Android演示App：

另：1:N人脸搜索识别 插件应用市场地址：https://ext.dcloud.net.cn/plugin?id=26467

使用方法

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

开发调试阶段请开启调试模式，Android-manifest.json distribute配置 "debuggable" : true,

1. 下载最新Demo工程先跑通；熟悉半天后参考文档集成到主项目

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

. 制作自定义调试基座

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

. 运行到手机

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

一定一定要先制作自定义调试基准，然后运行的时候使用自定义基准-本地基座，请看图片步骤引导说明

常见错误与解决方法

1.iOS 基座安装到手机后很久都是白屏/黑屏

   控制台输出
   项目 [FaceAI_API_Plugin] 已启动。请点击手机/模拟器的运行基座App（uni-app x）查看效果。
   如应用未更新，请在手机上杀掉基座进程重启

老旧手机根据提示确保杀死基座进程，稍后重启App就可以了

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

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

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

只要修改过原生代码只能重新制作自定义调试基座

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

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

    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  静默活体检测失败