FaceAI SDK is on_device Offline Android Face Detection 、Recognition 、Liveness Detection Anti Spoofing and 1:N/M:N Face Search SDK
FaceAI SDK是设备端可离线不联网Android 人脸识别、动作及近红外IR活体检测、人脸图质量检测以及人脸搜索(1:N和M:N)SDK,可快速集成实现人脸识别,人脸搜索功能。 20250627以上版本已经兼容适配多种类型UVC协议USB双目摄像头
iOS SDK: https://github.com/FaceAISDK/FaceAISDK_iOS
Uni App: https://github.com/FaceAISDK/FaceAISDK_uniapp_UTS
Android: https://github.com/FaceAISDK/FaceAISDK_Android
- 符合设定阈值的所有人脸搜索结果返回以及添加MN 多人脸搜索
- 优化人脸搜索和重构三方UVC摄像头管理库
- 优化低配设备人脸录入和识别活体校验优化
- 2.0 系列重构版本,更新官网 链接说明地址等
建议[Fork] + [Star] 本项目Repo以便第一手获取更新:FaceVerificationSDK
SDK包含动作活体、静默活体检测,1:1人脸识别以及1:N 人脸搜索识别,所有功能都在设备终端离线执行,SDK本身不用联网,不保存不上传任何人脸信息敏感资料更具隐私安全
其中活体检测支持张嘴、微笑、眨眼、摇头、点头 随机两种组合验证(支持去除特定的动作),2025.05.10版本已经支持UVC红外双目摄像头,需配备宽动态值大于100DB成像清晰抗逆光摄像头。
集成到主项目有问题请带SDK版本,运行环境和场景描述发邮件到 FaceAISDK.Service@gmail.com ,VIP用户可添加 微信:FaceAISDK
【1:1】 移动考勤签到、App免密登录、刷脸授权、刷脸解锁、巡更打卡真人校验
【1:N】 小区门禁、公司门禁、智能门锁、智慧校园、景区、工地、社区、酒店等
【M:N】 公安布控、人群追踪 监控等等 (测试效果可使用 MN_face_search_test.jpg 模拟)
先Github 下载最新接入Demo代码导入到Android Studio。
Demo 为了演示SDK的核心功能,部分细节并不完善,需要你根据你的业务需求自行完善。
-
1.调整JDK版本到java 17。AS设置Preferences -> Build -> Gradle -> JDK的版本为 17
-
2.最好翻墙科学上网同步AGP Gradle 插件 7.X 这是工程默认设置使用的的,然后同步其他依赖
-
3.Demo工程成功运行后,根据你的业务需求重点熟悉对应模块后再集成到你的主工程
-
4.集成到你的主工程,首先Gradle 中引入依赖 implementation 'io.github.FaceAISDK:Android:2025.06.29' //及时升级到github最新版
-
5.解决项目工程中的第三方依赖库和主工程的冲突比如CameraX的版本等,Target SDK不同导致的冲突
目前SDK使用**java17. kotlin 1.9.20,AGP 7.x **打包,如果你的项目较老还在使用 kapt, kotlin-android-extensions导致集成冲突,建议尽快升级项目或者VIP联系定制
更多使用说明下载SDK源码工程代码到Android Studio 以及下载Demo APK到手机体验完整的流程和效果 里面有详尽的注释说明和使用方法介绍,SDK源码熟悉完成后有一定Android基础大概3小时可集成到你的主工程
工程目录结构简要介绍
模块 | 描述 |
---|---|
appMain | 主工程,implementation project(':faceAILib') |
faceAILib | 子Module,FaceAISDK 所有功能都在module 中演示 |
/verify/* | 1:1 人脸检测识别,活体检测页面,静态人脸对比 |
/search/* | 1:N 人脸搜索识别,人脸库增删改管理等财政 |
/addFaceImage | 人脸识别和搜索共用的添加人脸照片录入模块 |
/UVCCamera/* | UVC协议双目红外摄像头人脸识别,人脸搜索,一般是自自定义的硬件 |
/SysCamera/* | 手机,平板自带的系统相机,一般系统摄像头打开就能看效果 |
扫码后选择在浏览器中打开点击下载安装,或直接输入地址 https://www.pgyer.com/faceVerify
- 去蒲公英下载APK Demo 体验SDK 的基本功能,看看是否满足业务需求;人脸搜索可以一键导入200+张人脸图再录入你自己的
- 更新GitHub 最新的代码,花1天左右时间熟悉SDK API 和对应的注释备注,断点调试一下基本功能;熟悉后再接入到主工程
- 欲速则不达,一定要先跑成功SDK接入指引Demo。熟悉后再接入到主工程验证匹配业务功能;有问题可以GitHub 提issues
- 使用宽动态(人脸搜索须大于105DB)抗逆光摄像头;保持镜头干净(用纯棉布擦拭油污)
- 录入高质量的人脸图,可参考(images/face_example.jpg)
- 光线环境好否则加补光灯,人脸无遮挡,没有化浓妆 或 粗框眼镜墨镜、口罩等大面积遮挡
- 人脸图大于 300300(人脸部分区域大于200200)五官清晰无遮挡,图片不能有多人脸
常见问题请参考:https://github.com/FaceAISDK/FaceAISDK_Android/blob/main/doc/questions.md
所有的开发测试都在手机和平板进行,特殊定制硬件如 RK3288 等适配需要兼容适配,SDK1.9.0以上版本已经支持UVC
协议的USB 双目摄像头IR近红外活体,买对应的USB接口的双目摄像头插入手机USB口就能体验效果(不确定品质联系我推荐)
更多外接USB外接UVC摄像头的操作参考这个大神的库:https://github.com/shiyinghan/UVCAndroid
项目中的libs/libuvccamera-release.aar 就是根据此项目微调打包成AAR
下载最新SDK Demo 源码熟悉代码后再集成到你的主工程,可以先整个Copy faceAiLib到你主工程先跑起来 再根据业务情况修改完善,有提前熟悉大4小时就能集成成功,丰富产品功能同时可大大降低公司研发投入实现降本增效。