更新记录

1.0.0（2026-06-19）

-Android / iOS / HarmonyOS 三端同一套 API。 -全离线推理，支持人脸检测、关键点定位、特征提取、活体检测、年龄/性别/口罩/眼睛/姿态/质量评估、1:1 比对、1:N 识别、人脸库管理。

平台兼容性

uni-app(4.18)

其他

ly028-OffFace 离线人脸检测识别特真提取

📱 下载体验 APK

基于 SeetaFace6 的人脸检测 UTS 原生插件，Android / iOS / HarmonyOS Next 三端完美支持，导出函数完全一致，一套代码三端运行。全离线运行，无需网络连接，数据不出设备。

特性

• 🔒 全离线 — 本地推理，无需联网，人脸数据不出设备
• 📱 三端完美一致 — Android / iOS / HarmonyOS Next 导出 API 完全相同，调用端无平台差异
• 🎯 30+ 个导出函数 — 检测、关键点、特征提取、活体、年龄、性别、口罩、眼睛、姿态、质量、1:1 比对、1:N 识别、人脸库管理
• 🧩 UTS 插件 — uni-app/uni-app x 原生插件，按需集成

平台兼容

集成与调试

HBuilderX 自定义基座运行

1. 插件市场购买插件后，在 manifest.json → App 原生插件配置中选择 ly028-OffFace
2. 选择需要使用的模块
3. 自定义调试基座：菜单栏 → 运行 → 运行到手机或模拟器 → 制作自定义调试基座
4. 制作完成后，选择自定义基座运行到真机即可调试所有功能

首次使用请确保已关联 uni-app 开发者证书，自定义基座有效期为 7 天，过期后需重新制作。

离线打包

插件为原生代码插件，离线打包需自行集成原生依赖。

快速开始

import * as OffFace from '@/uni_modules/ly028-OffFace'

// 1. 异步初始化引擎
OffFace.initFaceEngineAsync(null, null, (res) => {
    const initResult = JSON.parse(res)
    if (initResult.code === 0) {
        console.log('引擎初始化成功')
    }
})

// 2. 异步检测人脸
OffFace.detectFileAsync('/path/to/image.jpg', (res) => {
    const result = JSON.parse(res)
    if (result.code === 0 && result.data.faceCount > 0) {
        console.log('检测到', result.data.faceCount, '张人脸')
        console.log('第一个人脸:', result.data.faces[0])
    }
})

// 3. 释放引擎
OffFace.releaseEngine()

全量 API 参考

引擎生命周期

人脸检测

flags 位定义：

活体检测

返回 liveness 值：real（真实）、spoof（伪造）、fuzzy（模糊）、detecting（检测中）

模块管理

人脸识别（FaceDatabase）

特征提取

人脸注册

1:N 识别

人脸管理

配置

返回值格式

所有 API 返回统一 JSON 信封：

// 成功
{"code": 0, "data": {...}}

// 失败
{"code": 1, "subCode": 500, "msg": "错误描述"}

检测结果结构

{
  "code": 0,
  "data": {
    "faceCount": 1,
    "imageWidth": 1920,
    "imageHeight": 1080,
    "faces": [{
      "rect": {"x": 100, "y": 200, "width": 300, "height": 400},
      "score": 0.98,
      "landmarks": [{"x": 150, "y": 250}, ...],
      "age": 25,
      "gender": "male",
      "mask": false,
      "maskScore": 0.02,
      "eyeLeft": "open",
      "eyeRight": "open",
      "yaw": -5.3, "pitch": 2.1, "roll": 1.0,
      "liveness": "real",
      "quality": {
        "brightness": {"level": "high", "score": 0.95},
        "clarity": {"level": "medium", "score": 0.65},
        "integrity": {"level": "high", "score": 0.90}
      }
    }]
  }
}

识别结果结构

{"code": 0, "data": {"found": true, "userId": "user_abc123", "similarity": 0.87}}

Top-N 结果结构

{"code": 0, "data": {"count": 3, "topN": 5, "results": [
  {"userId": "user_abc", "similarity": 0.87},
  {"userId": "user_def", "similarity": 0.72}
], "duplicates": [], "duplicateThreshold": 0.6}}

注意事项

1. 引擎只能初始化一次，释放后可再次初始化
2. 人脸库初始化选择：light（512 维，轻量）、std（1024 维，需下载 face_recognizer.csta 约 98MB）
3. 活体检测需要 fas_first.csta 和 fas_second.csta 两个模型
4. 年龄检测为热加载模块，需额外下载 age_predictor.csta（约 32MB）
5. 并发检测内部有互斥锁，同一时间只允许一次检测
6. 建议图片最大尺寸 1280px，超尺寸自动缩放

隐私声明

• 本插件不采集任何用户数据
• 所有人脸检测与识别在设备端离线完成
• 无需网络权限，不上传任何图像或特征数据

鸿蒙实测图

iOS 实测图

体验

📱 下载体验 APK

许可

• 插件市场购买后获得使用授权
• 禁止反编译、二次分发