Faceplugin-ltd/FaceRecognition-Android

FacePlugin 人脸识别 SDK – Android 演示

项目简介

• 一个示例 Android 应用，展示 FacePlugin 的端上人脸识别 SDK。核心处理逻辑位于二进制 AAR 文件（facerecognitionsdk.aar）中，该文件需单独下载并放入项目。

主要功能

功能	演示内容
登记	从相册获取一张人脸，并将其模板存储在本地 JSON 数据库中。
识别	使用手机前置摄像头进行实时 1 对 N 匹配，并带有 2D 活体/防伪检测。
采集	引导式椭圆取景采集，返回人脸图像及属性，并可选地进行人员登记。
属性	分析相册照片，提取关键点、姿态、质量、年龄、性别、情绪、活体等信息。
设置	调整摄像头镜头选择以及活体、姿态、闭眼等阈值。
关于	显示 SDK 及其离线许可模式的相关信息。

运行步骤

1. 克隆仓库。
2. 从链接的 Google Drive 文件夹下载 facerecognitionsdk.aar，并放入 libfacesdk/ 目录。
3. 在 Android Studio 中打开项目，并在真机 Android 手机上运行（在本地 SDK 加载完成前，界面会被禁用）。
4. 应用自带演示包 ID 的有效许可密钥；若用于你自己的应用，必须申请新密钥。

在自己项目中使用 SDK

• 将 libfacesdk 模块和 AAR 添加到 Gradle 构建中。
• 调用 FaceRecognitionSDK.setActivation(context, licenseKey)，然后在后台线程中一次性调用 init(context)。
• 公开 API 包括：
  • faceDetection – 返回检测框、关键点及请求的属性。
  • templateExtraction – 将人脸图像转换为字节数组模板，由你自行存储。
  • similarityCalculation – 比较两个模板（1:1）或循环进行 1:N 搜索。
  • VideoWorker – 用于连续相机帧处理的辅助工具，处理实时活体检测和增量匹配。
• 仓库还提供了一个演示工具包（app/src/main/java/.../kit/），内含现成的 Kotlin 辅助类（FaceRecognitionClient、FaceDatabase、相机工具等），可复制粘贴使用，避免自行编写线程和 CameraX 代码。

重要性

• 仅限设备端：图像和生物识别数据不会离开手机，这对隐私敏感场景（如银行 KYC、门禁控制，或任何需遵守数据保护法规的应用）至关重要。
• 离线许可：使用绑定到应用包名的许可证激活后，SDK 无需互联网连接即可运行。
• 多平台生态：FacePlugin 提供 iOS、React-Native、Flutter、Ionic、Windows 和 Docker 的对应 SDK，均使用相同的基础模型。

获取帮助

• 文档：https://doc.faceplugin.com
• 支持：邮箱 info@faceplugin.com，Telegram @FacePluginSupport，WhatsApp +1 469-278-4822。

总结 如果你需要 Android 上开箱即用、隐私优先的人脸识别解决方案，本仓库提供了可运行的演示和一套可复制粘贴的 Kotlin 辅助类，用于将商业版 FacePlugin SDK 集成到你的应用中。