项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- Android 8 ~ 16 的设备或模拟器
- Android Studio 及可用的 Gradle/Android 构建环境
- 工程 repositories 中可访问 mavenCentral()
- (可选)UVC 协议 USB 相机,需成像清晰、WDR > 105dB
安装与启动步骤
-
1准备开发环境
安装 Android Studio,准备运行 Android 8~16 的真机或模拟器,新建或打开一个 Android 工程。
-
2获取示例工程
克隆官方仓库,对照 FaceSDKLib、verify、search、addFace 等模块了解各功能用法。
git clone https://github.com/FaceAISDK/FaceAISDK_Android.git -
3配置 Maven 仓库
SDK 托管在 mavenCentral,需在工程的 repositories 配置中确保已加入 mavenCentral()。
mavenCentral() -
4添加 SDK 依赖
在模块的 gradle 文件中加入依赖,把 Version 换成 mavenCentral 上的实际发布版本号。
api 'io.github.FaceAISDK:Android:Version' -
5UVC 相机额外依赖
只有使用 UVC 协议 USB 相机时才需要额外引入 UVCAndroid 依赖,系统相机场景可跳过。
-
6运行示例体验
用 Android Studio 运行 verify(1:1)或 search(1:N)模块,观察相机预览与人脸识别效果。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
mavenCentral() | 是 | 声明 SDK 所在的依赖仓库,必须加入 repositories | mavenCentral() |
io.github.FaceAISDK:Android:Version | 是 | FaceAISDK 主体依赖坐标,Version 需替换为实际版本号 | api 'io.github.FaceAISDK:Android:Version' |
UVCAndroid | 否 | UVC 协议 USB 相机场景需额外引入的依赖 | UVC 相机场景额外引入 UVCAndroid 依赖 |
如何确认成功
运行 verify 模块后能打开相机预览并完成人脸检测与活体检测,即表示 SDK 集成成功。
常见问题
Q:使用这个 SDK 需要联网吗?
A:不需要。所有 SDK 功能均为离线实现,不依赖网络或云服务,数据不上传也不存储。
Q:支持哪些 Android 版本?
A:SDK 支持 Android 8 到 16。
Q:支持哪些活体检测方式?
A:支持静默活体检测,以及张嘴、微笑、眨眼、摇头、点头等动作活体检测。
Q:依赖里的 Version 怎么写?
A:README 中给出的是占位写法,需替换为 mavenCentral 上该 SDK 的实际发布版本号。
Q:可以用 USB 摄像头吗?
A:可以,需使用 UVC 协议 USB 相机并额外引入 UVCAndroid 依赖,且要求成像清晰、WDR > 105dB。
注意事项
- 所有功能在端侧离线运行,人脸数据不上传、不存储,便于隐私合规。
- README 中依赖坐标写作 io.github.FaceAISDK:Android:Version,Version 需换成实际版本号。
- UVC 协议 USB 相机需额外引入 UVCAndroid 依赖,且对成像清晰度和 WDR 有要求。
- 示例工程中包含 verify(1:1)、search(1:N/M:N)、addFace、SysCamera、UVCCamera 等模块,可按需参考。
核心亮点
- 全流程端侧离线运行,人脸数据不出设备,隐私合规压力小
- 同时覆盖活体检测、1:1 比对和 1:N/M:N 搜索,功能较完整
- Java 实现,Android 项目集成门槛低,适合快速验证
不足之处
- 端侧模型体积与识别精度受手机算力限制,超大底库场景需评估
- 文档与社区活跃度相对成长中项目,长期维护待观察
适用场景
- 门禁/考勤 App 本地刷脸验证员工身份
- 金融或政务类 App 做离线活体核验,减少上传人脸照
- 会员/访客系统在手机端建立本地人脸库并做 1:N 检索
替代项目
FaceRecognition、InsightFace、CompreFace
上一篇:WeVisDoc
下一篇:没有了!
同类项目推荐
modlens
开源
给纯文本编码代理装上眼睛,粘贴图片即刻获得结构化视觉证据。
The first vision plugin for DeepSeek Harness, and the vision bridge for every text-o···
opencv
开源
开箱即用的视觉算法库,搞定图像视频处理与识别
Open Source Computer Vision Library
OpenCVTutorials
开源
中文 OpenCV 教程,从入门到实战,边看边跑代码
OpenCV-Python4.1 中文文档
DEIMv2
开源
用DINOv3做实时检测,又快又准,直接落地。
[DEIMv2] Real Time Object Detection Meets DINOv3
