HelloFace：让人脸识别真正运行在设备端

一套覆盖人脸检测、采集、活体检测、1:1 比对和 1:N/M:N 搜索的离线人脸 SDK，支持 Android、iOS、HarmonyOS、Linux 与 Windows(后面会支持微信小程序和Flutter，RN插件)。

在人脸门禁、身份核验、访客管理、会员识别等业务中，开发团队往往需要同时处理算法接入、相机采集、活体检测、人脸库管理和多平台适配。

如果每个平台都从底层重新开发，不仅周期长，接口和识别效果也难以保持一致。

HelloFace 希望把这些复杂能力封装成一套更容易集成的人脸识别 SDK，让开发者能够专注于业务本身，而不是重复搭建底层算法链路。

一套 SDK，覆盖完整人脸业务流程

HelloFace 提供从“发现人脸”到“确认身份”的完整能力链路。

实时人脸检测

通过摄像头持续检测画面中的人脸，返回：

• 人脸位置与检测置信度
• 人脸五点关键点
• 可选多人脸检测
• 可选详细关键点、轮廓与头部姿态

这些结果可用于相机引导、头像采集、质量判断和后续人脸对齐。

人脸采集与特征录入

SDK 可以从静态图片或实时相机画面中提取人脸特征，支持：

• 自动检测并选择主要人脸
• 人脸对齐与预览
• 引导用户调整位置和姿态
• 提取并保存人脸特征
• 将特征录入本地人脸库

开发者可以在用户确认后保存特征，用于后续身份验证或人脸搜索。

1:1 人脸比对

1:1 比对用于判断两张人脸是否属于同一个人，适合：

• 证件照与现场人脸核验
• 用户登录与身份确认
• 重要操作二次验证
• 人脸信息更新确认

HelloFace 同时提供静态图片比对和相机动态验证，可根据业务场景配置相似度阈值。

静默活体与动作活体

为了降低照片、视频翻拍等攻击风险，HelloFace 支持组合活体检测能力。

目前 Android 示例已经提供：

• 静默活体
• 眨眼
• 张嘴
• 摇头
• 点头
• 动作与静默活体组合验证

业务方可以根据安全等级配置不同验证流程。例如，普通签到可以采用静默活体，高风险操作则可以增加随机动作。（定制设备是双目红外摄像头的我们也能支持红外活体检测）

1:N 与 M:N 人脸搜索

当业务需要从人脸库中寻找相似身份时，HelloFace 提供本地人脸搜索能力：

• 1:N 单人搜索
• M:N 多人连续搜索
• 人脸分组管理
• 自定义搜索阈值
• 搜索结果回调
• 暂停与恢复搜索
• 人脸库分页、查询与删除
• 批量导入人脸特征

这使它能够覆盖门禁、访客、考勤、会员识别等需要本地身份检索的场景。

为什么选择设备端离线识别？

HelloFace 的主要算法在设备端执行，本地人脸库支持离线查询。根据当前 Android 接入说明，网络人脸图片导入和首次构建依赖可能需要联网，但日常检测、特征提取和本地搜索不依赖持续访问云端服务。查看 Android 功能说明

设备端部署可以带来几项直接价值。

更低的交互延迟

图像无需在每次识别时上传到远端服务器，减少网络传输和服务响应带来的等待。

对于门禁、考勤和终端核验等实时场景，本地推理能够提供更连贯的交互体验。

弱网环境也能工作

在网络不稳定、无法连接公网或需要独立运行的环境中，本地检测、比对和搜索能力依然可以使用。

更容易控制数据流向

人脸图片和特征可以由宿主应用按照自身安全策略进行管理，有助于减少对远程识别服务的依赖。

需要注意，人脸特征属于敏感数据。宿主应用仍需负责用户授权、访问控制、加密存储、密钥管理和数据删除流程。

降低持续调用成本

与按调用次数计费的云端服务相比，设备端方案更适合高频检测和连续搜索场景，也方便团队根据业务规模规划整体成本。

多平台支持

HelloFace 当前仓库提供以下平台的接入资料：

平台	环境要求
Android	Android 6.0+、ARM64/ARMv7、JDK 17、SDK 36
iOS	iOS 15+、Swift 6、Xcode
HarmonyOS	API 20+、ARM64、DevEco Studio 26
Linux	Ubuntu 22.04+、x86_64/ARM64、X11/XWayland
Windows	Windows 10/11、x64 CPU

项目还计划支持：

• 微信小程序
• ChromeOS
• uni-app插件
• Flutter 插件
• React Native 插件

各平台当前完成度、系统要求和接入方法，请以 HelloFace 项目主页中的最新说明为准。

Demo 已覆盖主要业务场景

Android 用户基数较大，对应Demo开发进度会更快，目前Android Demo 提供了较完整的功能入口，可直接体验和参考：

功能	示例能力
实时检测	人脸框、五点、多人脸与详细关键点
静态比对	选择两张图片进行特征提取和比较
人脸录入	相机引导、对齐预览和特征保存
动态验证	参考身份比对、静默活体和动作活体
活体检测	眨眼、张嘴、摇头、点头
人脸搜索	1:N、M:N、分组、阈值与连续搜索
人脸库管理	查询、分页、删除和批量导入

SDK 采用页面级实例设计，可以绑定 Android LifecycleOwner，在页面销毁时自动释放资源。模型采用异步加载方式，活体、验证和搜索能力按需准备，便于宿主应用控制初始化时机和资源占用。查看 Android SDK 接入指南

适用场景

HelloFace 可用于构建多种终端侧人脸应用。

智慧门禁

在本地终端完成人脸检测、活体判断和人脸库搜索，适用于办公园区、社区、酒店与设备机房。

身份核验

将现场采集的人脸与已有参考特征进行1:1比对，可用于实名验证、账户安全和重要业务确认。

访客与会员识别

通过本地分组和1:N搜索能力，快速查找访客、员工或会员身份。

考勤与签到

利用连续检测、活体和搜索能力，构建无需手动输入账号的签到流程。

自助终端

适用于弱网或需要独立运行的自助设备，例如登记终端、服务终端和工业控制设备。

不只提供 SDK，也提供可以运行的示例

HelloFace 仓库不仅提供接口说明，还包含各平台 Demo、SDK 文档和版本下载入口。

开发者可以：

1. 下载对应平台 Demo；
2. 在真实设备上体验检测、活体、比对和搜索流程；
3. 参考示例代码完成相机与生命周期接入；
4. 根据自己的业务数据调整阈值与放行规则；
5. 通过 GitHub Issues 反馈设备兼容和集成问题。

当前 Beta 版本说明

HelloFace 当前为 0.0.2 Beta。试用前请注意：

• 当前模型不支持14岁以下青少年人脸识别；
• 默认打开的是系统摄像头，如果是定制双目红外摄像头需要你管理摄像头采集帧数据传入SDK
• 相似度阈值不能直接照搬示例值，应使用目标设备和独立业务样本验证；
• 不同平台的功能完成度可能存在差异，以各平台最新文档为准。

立即体验 HelloFace

如果你正在开发门禁、身份核验、人脸搜索或终端侧 AI 应用，可以从 HelloFace Demo 开始体验。

• GitHub 项目主页
• 版本下载
• Android APK 构建
• 问题反馈
• 联系邮箱：FaceAISDK.Service@gmail.com

HelloFace , 让人脸识别从复杂的算法工程，变成可以快速接入的设备端能力。