## 概述

使用 MediaPipe 的 BlazeFace 和 FaceMesh 模型检测图像中的人脸，并识别每张人脸上的 468 个面部特征点（关键点）。该节点还计算用于面部表情分析的 ARKit-52 混合变形系数。节点可批量处理多张图像，并输出每张检测到的人脸的特征点数据和边界框。

## 输入

| 参数 | 描述 | 数据类型 | 必填 | 范围 |
| --- | --- | --- | --- | --- |
| `face_detection_model` | 用于特征点检测的 MediaPipe 人脸检测模型。 | FACE_DETECTION_MODEL | 是 |  |
| `image` | 用于检测人脸的输入图像或图像批次。 | IMAGE | 是 |  |
| `detector_variant` | 人脸检测器范围。`"short"` 针对近距离人脸（距相机约 2 米以内）进行了优化；`"full"` 覆盖更远/更小的人脸（最远约 5 米），但速度较慢。`"both"` 同时运行两种检测器，并保留每帧检测到人脸数量更多的结果（检测成本约增加一倍）。默认值：`"short"`。 | COMBO | 是 | `"short"`<br>`"full"`<br>`"both"` |
| `num_faces` | 每帧返回的最大人脸数量。0 表示无上限（返回所有检测到的人脸）。默认值：1。 | INT | 是 | 0 到 16 |
| `min_confidence` | BlazeFace 评分阈值。较低的值有助于捕捉较小或被遮挡的人脸。默认值：0.5。 | FLOAT | 否 | 0.00 到 1.00 |
| `missing_frame_fallback` | 批次中检测失败时的逐帧处理行为。`"empty"` 使该帧无人脸数据。`"previous"` 复制最近一次成功的检测结果。`"interpolate"` 在相邻成功帧之间对特征点/边界框/混合变形进行线性插值。多人脸：通过贪心边界框中心最近邻算法跨帧配对。默认值：`"empty"`。 | COMBO | 否 | `"empty"`<br>`"previous"`<br>`"interpolate"` |

## 输出

| 输出名称 | 描述 | 数据类型 |
| --- | --- | --- |
| `bboxes` | 包含每帧人脸检测结果的结构化输出，包括 468 个面部特征点、ARKit-52 混合变形系数、变换矩阵以及用于网格可视化的连接集。 | FACE_LANDMARKS |
| `bboxes` | 每张检测到的人脸的边界框列表，包含坐标 (x, y, width, height)、标签 "face" 和置信度分数。每个输入帧对应一个列表。 | BOUNDING_BOX |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/MediaPipeFaceLandmarker/zh.md)

---
**Source fingerprint (SHA-256):** `f60ed6201288a59d65d62cc98c12f227a353870c36decea8da81a063cfdf2bba`