> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/lip-sync-and-animation-issues.md).

# 口型同步和动画问题

修复 Convai Unreal Engine 插件中的嘴部不动、blendshape 曲线错误、帧饥饿以及打包构建中的动画失败。

使用此页面排查角色说话时面部动画的问题。角色完全没有音频的问题，请参阅 [音频和麦克风问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/audio-and-microphone-issues.md)。如需查看 `Convai Face Sync` 组件属性的完整参考，请参阅 [Face Sync 组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/face-sync-component-reference.md).

{% hint style="info" %}
**不确定该使用哪种 `LipSyncMode` ？** 继续排查前，请先根据下表确认你的绑定类型——大多数口部动作问题都是由 `LipSyncMode` 不匹配造成的。
{% endhint %}

| 绑定类型              | 正确的 `LipSyncMode` |
| ----------------- | ----------------- |
| MetaHuman         | `MetaHuman 混合形状`  |
| CC5               | `MetaHuman 混合形状`  |
| CC4（标准导出）         | `ARKit 混合形状`      |
| CC4（扩展导出）         | `CC4 扩展混合形状`      |
| 带有 OVR 视素曲线的自定义绑定 | `基于音素`            |

### 选择正确的故障排查路径

如果不确定问题出在设置、音频还是绑定选择，请先从本页的基本检查开始。当已添加 `Convai Face Sync` 组件，且需要检查 AnimGraph 节点属性、混合形状重映射、平滑处理、数据不足或命令行覆盖项时，请转到功能故障排查页面。

| 观察到的现象                | 从这里开始                                                                                                                                                              |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 角色没有音频，嘴部也没有动作        | [音频和麦克风问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/audio-and-microphone-issues.md)                    |
| 角色在说话，但面部没有动作         | 本页面，然后查看 [排查口型同步问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/troubleshoot-lip-sync.md)               |
| 嘴部在动，但动画使用了错误的面部曲线    | 本页面，然后查看 [Face Sync 组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/face-sync-component-reference.md) |
| 口型同步开始后，在说话过程中冻结或逐渐减弱 | [排查口型同步问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/troubleshoot-lip-sync.md)                        |
| 自定义曲线重映射不起作用          | [排查口型同步问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/troubleshoot-lip-sync.md)                        |

### 说话时嘴部没有动作

**现象：** 角色在说话，但嘴部和面部没有动作。

**原因 — 缺少 Face Sync 组件：** Actor 没有 `Convai Face Sync` 组件，因此不会请求面部动画数据。

**解决方法：** 打开角色蓝图，添加 `Convai Face Sync` 组件，并将 `LipSyncMode` 设为与绑定类型相匹配的值。然后编译并保存。

**验证：** 进入 Play 模式，确认 `Convai Face Sync` 组件已存在于角色 Actor 上。

***

**原因 — Face Sync AnimGraph 节点不在活动姿势路径中：** 该节点存在于 Animation Blueprint 中，但其 `Source Pose` 和 `Output Pose` 引脚未连接到通往最终动画输出的姿势链。

**修复：** 打开面部 Animation Blueprint，并将 `Convai Face Sync` AnimGraph 节点连接到活动姿势路径中。

**验证：** 重新编译 Animation Blueprint。通往输出的活动路径中，该节点不应有未连接的引脚。

### 嘴部会动，但动画驱动了错误的曲线

**症状：** 面部会动，但动作与语音不匹配。例如，激活的是无关的面部控件，而不是嘴型。

**原因 — `LipSyncMode` 不匹配：** 所选的 `LipSyncMode` 与 Skeletal Mesh 上的曲线名称不匹配。

**修复：** 在角色 Blueprint 中选择 `Convai Face Sync` 组件，并将 `LipSyncMode` 设置为本页顶部表格中与该骨骼绑定类型对应的值。若要设置整个项目的默认值，请前往 **Edit > Project Settings > Plugins > Convai** 并勾选 `Lip Sync Mode`.

**验证：** 在编辑器中打开 Skeletal Mesh，并检查 **曲线** 列表。所选模式生成的曲线名称应当存在于该网格上。

{% hint style="warning" %}
当一个项目包含多种骨骼绑定类型时，请按组件设置 `LipSyncMode` 值。项目级别的值可能会导致使用其他骨骼绑定类型的所有角色出现错误动画。
{% endhint %}

### 语音期间口型同步冻结或偏移

**症状：** 口型同步起初正常，随后冻结、淡出或落后于音频。

**原因：** 这通常是由时间设置而非角色配置导致的。与此相关的设置包括 `OutputFPS`, `FramesBufferDuration`, `LipSyncTimeOffset`, `bEnableInterpolation`，以及 AnimGraph 节点的 `StarvationBlendOutDuration`.

**修复：** 请参阅功能故障排除页面，调整与症状相对应的时间设置。不要一次更改多个时间值；每次只更改一项，在 Play In Editor 中测试，然后再继续。

**验证：** 在整个响应过程中，嘴部应始终与语音音频保持同步。

{% content-ref url="/pages/b0b44be9f2ee8ca031b08c9677450b5f826a9c8c" %}
[排查口型同步问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/troubleshoot-lip-sync.md)
{% endcontent-ref %}

### 面部在编辑器中会动，但在打包构建中不会

**症状：** 口型同步在 PIE 中有效，但在 Cook 后的构建中面部不会动。

**原因：** 曲线资源或动画蓝图资源可能未包含在 Cook 中。骨骼网格体曲线必须由动画蓝图引用，或包含在资源列表中，才能在 Cook 后保留。

**修复方法：** 确认角色蓝图或包含在 Cook 中的关卡引用了面部动画蓝图。如果曲线被剥离，请将其添加到资源的 **骨架** 中，并确保骨架资源位于已 Cook 的包中。

**验证：** 执行 Development Cook，并检查 Cook 日志中是否有关于角色骨架上曲线轨道被剥离的警告。

### 后续步骤

{% content-ref url="/pages/8b7003d8fdf40c7b56b0fd2a54376bfc5105903c" %}
[Face Sync 组件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/face-sync-component-reference.md)
{% endcontent-ref %}

{% content-ref url="/pages/b0b44be9f2ee8ca031b08c9677450b5f826a9c8c" %}
[排查口型同步问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/troubleshoot-lip-sync.md)
{% endcontent-ref %}

{% content-ref url="/pages/76a35097e5aafc7db6e701235cba4c330c02ad3a" %}
[诊断和日志导出](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/diagnostics-and-log-export.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/lip-sync-and-animation-issues.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
