# ext2-py-livenessDetection

**Repository Path**: mind-plus/ext2-py-livenessDetection

## Basic Information

- **Project Name**: ext2-py-livenessDetection
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-13
- **Last Updated**: 2026-09-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MindPlus-Ext2

## README

# 人脸活体检测库

![cover](extension/public/cover.png)

`livenessDetection` 是一个适用于 Mind+ V2 Python积木模式的扩展（基于摄像头检测获取人脸关键点，同时完成眨眼和张嘴动作检测，判断是否为真人。）。
该扩展共提供 15 个积木。

## 积木

| 积木类型 | 积木内容 |
|---|---|
| 命令 | 初始化人脸动作检测 摄像头编号 [CAMERA] |
| 命令 | 设置画面大小 宽 [WIDTH] 高 [HEIGHT] |
| 命令 | 读取一帧摄像头画面 |
| 命令 | 显示摄像头画面 |
| 命令 | 关闭摄像头和窗口 |
| 命令 | 在画面上显示文字 [TEXT] 位置 x [X] y [Y] 字号 [SIZE] 颜色 [COLOR] |
| 命令 | 清空画面显示内容 |
| 命令 | 加载人脸检测模型 路径 [MODEL_DIR] |
| 布尔 | 是否检测到人脸？ |
| 命令 | 在画面上显示全部脸部位置点 |
| 命令 | 在画面上显示 [PART] 位置点 |
| 数值 | 左眼开合比例 |
| 数值 | 右眼开合比例 |
| 数值 | 双眼平均开合比例 |
| 数值 | 嘴巴开合比例 |

## Python 依赖

本扩展运行依赖以下 Python 包（见 extension/public/requirements.txt）：

```
opencv-contrib-python
numpy
Pillow
```

## 更新日志

### V0.0.1

- 完成扩展基础功能

## 开发指南

更详细的 Mind+ V2 扩展开发说明请参考：[Mind+官方扩展开发文档](https://mindplus.dfrobot.com.cn/mp2/Extensions/)

## V1 原始库来源

本库迁移自 Mind+ V1（1.x）用户库，保留 `compatibilityId` 字段以兼容旧版工程。

- compatibilityId：`nick-livenessdetection-thirdex`
- 原作者：nick
- 原始仓库：https://gitee.com/chenqi1233/ext-liveness-detection