更新记录

1.0.0（2026-09-29） 下载此版本

• 首次发布
• 支持动作活体检测（张嘴、眨眼、左右转头、点头）
• 支持 liveness（纯活体）与 identity（活体 + 人证比对）两种模式
• 人证比对接口由使用者通过 verifyApi 传入，约定式契约 { success: true|false }，零硬编码
• 无论何种模式均回传抓拍人像 base64，宿主可自行接入自有接口
• 支持 App（内置本地 H5）与 H5（需自备已部署地址）

平台兼容性

uni-app(3.8.4)

uni-app x(3.8.4)

Rui-faceVerify 人脸活体检测与人证核身

基于 face-api.js 的动作活体检测 + 可配置人证核身组件。检测逻辑运行在内嵌 H5 中，通过 web-view 承载，不依赖任何原生 SDK，App 与 H5 均可使用。

• 零硬编码：插件不内置任何人证比对接口，接口地址与判定完全由使用者决定
• 两种模式：liveness 纯活体；identity 活体 + 人证比对
• 结果可选：无论哪种模式都会返回抓拍人像 base64，宿主可自行调用自己的接口

支持的平台

快速开始

<template>
    <Rui-faceVerify
        mode="identity"
        :actions="[1, 2]"
        name="张三"
        idcard="110101199001011234"
        verify-api="https://your-domain.com/verify"
        @success="onSuccess"
        @fail="onFail"
        @action="onAction"
    />
</template>

<script>
export default {
    methods: {
        onSuccess(e) {
            console.log('认证通过', e.picture)
        },
        onFail(e) {
            console.log('认证失败', e.state)
        },
        onAction(e) {
            // 活体动作切换，可用于自定义语音/文案
            console.log('当前动作', e.description)
        }
    }
}
</script>

H5 平台需额外传入已部署的 H5 地址：

<Rui-faceVerify h5-base-url="https://your-domain.com/livedetect/" ... />

Props

Events

结果字段说明：

人证比对接口约定

identity 模式会在活体通过后，向你配置的 verifyApi 发起 POST（application/json） 请求：

{
    "realName": "张三",
    "idCard": "110101199001011234",
    "faceImage": "data:image/png;base64,..."
}

接口需返回：

{ "success": true }

约定规则：

• HTTP 200 且 success 为布尔值 才算有效响应
• success: true → 认证通过；success: false → 认证失败
• 非 200、超时、网络异常，或缺少布尔 success 字段，一律视为失败，并在结果页给出明确提示

注意事项

1. 跨域：H5 平台由浏览器直接发起请求，你的比对接口必须放行 CORS（含 OPTIONS 预检）；若使用 token，还需允许 Authorization、Content-Type 请求头。App 端无此限制。
2. App 端消息时机：app-vue 的 @message 在「页面后退、web-view 组件销毁、分享」时触发。若需拿到结果后立即跳转，请在收到结果后将 visible 置为 false。
3. faceImage 格式：为 data:image/png;base64, 前缀的完整 data URL，如你的后端需要纯 base64，请自行截取 / 逗号后的内容。
4. 人脸数据合规：抓拍人像属敏感个人信息，请务必在自身隐私政策中说明用途与留存策略。

目录结构

uni_modules/Rui-faceVerify
├── components/Rui-faceVerify/Rui-faceVerify.vue      # 组件入口
├── hybrid/html/livedetect/                            # 内置 H5 构建产物（含模型）
├── package.json
├── readme.md
└── changelog.md

更新日志

见 changelog.md