> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SAM3DBody_FaceExpression - ComfyUI Built-in Node Documentation

> 此节点通过使用 MediaPipe Face Landmarker 检测图像中的人脸，将每张检测到的人脸与跟踪到的人物进行匹配，并将 52 个 ARKit 混合形状映射到 MHR 的 72 轴表情参数上，从而为 SAM3D 身体添加面部表情。

此节点通过使用 MediaPipe Face Landmarker 检测图像中的人脸，将每张检测到的人脸与跟踪到的人物进行匹配，并将 52 个 ARKit 混合形状映射到 MHR 的 72 轴表情参数上，从而为 SAM3D 身体添加面部表情。然后它会重新运行身体模型，使输出网格顶点和关键点反映新的表情。

## 输入

| 参数 | 描述 | 数据类型 | 必需 | 范围 |
| - | - | - | - | - |
| `sam3d_body_model` | 包含面部关键点检测器的 SAM3D 身体模型，用于检测人脸并重新生成身体网格。 | SAM3D\_BODY\_MODEL | 是 | - |
| `mhr_pose_data` | 姿态数据，包含每帧跟踪到的人物及其边界框、关键点和表情参数。此节点将每张检测到的人脸与人物进行匹配，并将更新后的表情参数写入此数据。 | MHR\_POSE\_DATA | 是 | - |
| `image` | 用于检测人脸的图像帧。如果图像批次的帧数少于姿态数据，则对剩余的帧复用最后一帧。 | IMAGE | 是 | - |
| `strength` | 所有混合形状的全局乘数。>1 表示夸张。默认：1.0。 | FLOAT | 否 | 0.0 到 4.0（步长 0.05，默认 1.0） |
| `mouth_strength` | 嘴部/下颌形状的乘数。MediaPipe 的 jawOpen 接近 1.0 时趋于饱和。默认：1.0。 | FLOAT | 否 | 0.0 到 4.0（步长 0.05，默认 1.0） |
| `eye_strength` | 眼部形状的乘数。MediaPipe 很少超过 0.5；通常需要 2-3 倍。默认：2.0。 | FLOAT | 否 | 0.0 到 4.0（步长 0.05，默认 2.0） |
| `brow_strength` | 眉毛/脸颊/皱鼻形状的乘数。MediaPipe 输出约为 0.1-0.3；需要 2-3 倍。默认：2.0。 | FLOAT | 否 | 0.0 到 4.0（步长 0.05，默认 2.0） |
| `input_threshold` | MediaPipe 原始输出的死区（低于该值归零，高于该值进行线性重映射）。默认：0.02。 | FLOAT | 否 | 0.0 到 0.5（步长 0.01，默认 0.02） |
| `blendshape_smooth_window` | 在 MHR 映射之前对 MediaPipe 每帧信号应用的高斯窗口。MediaPipe 的原始输出在静态人脸上逐帧波动 30-70%。1 表示禁用。请使用奇数值。默认：7。 | INT | 否 | 1 到 31（步长 2，默认 7） |

注意：仅当片段中至少有 30 帧包含检测到的人物时，才会应用逐片段基线减法。每个人物最多 12 帧的检测间隙通过插值填补。

## 输出

| 输出名称 | 描述 | 数据类型 |
| - | - | - |
| `mhr_pose_data` | 更新后的姿态数据。每个跟踪到的人物的表情参数都被替换为映射后的面部表情，并重新生成网格顶点和关键点以与之匹配。 | MHR\_POSE\_DATA |

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

***

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.