> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.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`