> 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 曲线错误、帧饥饿以及打包构建中的动画失败。 使用此页面解决角色说话时的面部动画问题。关于角色完全没有音频输出的问题，请参见 [音频和麦克风问题](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/audio-and-microphone-issues.md)。有关 `Convai Face Sync` 组件属性的完整参考，请参见 [Face Sync 组件参考](/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 viseme 曲线的自定义绑定 | `基于音素口型` | ### 选择正确的排查路径 当你不确定问题是设置、音频还是绑定选择所致时，请先从本页顶部的检查开始。当 `Convai Face Sync` 组件已存在，且你需要检查 AnimGraph 节点属性、blendshape 重映射、平滑、starvation 或命令行覆盖时，再转到功能排查页面。 | 你观察到的现象 | 从这里开始 | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | 角色没有音频输出，也没有口部运动 | [音频和麦克风问题](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/troubleshooting/audio-and-microphone-issues.md) | | 角色在说话，但脸部不动 | 那么先看本页， [排查口型同步问题](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/troubleshoot-lip-sync.md) | | 嘴部在动，但驱动了错误的面部曲线 | 那么先看本页， [Face Sync 组件参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/face-sync-component-reference.md) | | 口型同步开始正常，但在说话过程中冻结或淡出 | [排查口型同步问题](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/troubleshoot-lip-sync.md) | | 自定义曲线重映射不起作用 | [排查口型同步问题](/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` 组件，因此不会请求任何面部动画数据。 **修复：** 打开角色 Blueprint，添加一个 `Convai Face Sync` 组件，并设置 `LipSyncMode` 并将其设置为与绑定匹配的值。编译并保存。 **验证：** 进入 Play 模式并确认 `Convai Face Sync` 组件已存在于角色 Actor 上。 *** **原因——Face Sync AnimGraph 节点不在活动姿势路径中：** 该节点存在于 Animation Blueprint 中，但其 `源姿势` 和 `输出姿势` 引脚未连接到到达最终动画输出的姿势链。 **修复：** 打开面部 Animation Blueprint 并将 `Convai Face Sync` AnimGraph 节点连接到活动姿势路径中。 **验证：** 重新编译 Animation Blueprint。该节点在通向输出的活动路径中不应有未连接的引脚。 ### 嘴部在动，但驱动了错误的曲线 **症状：** 脸部在动，但动作与说话不匹配。例如，激活的是不相关的面部控制，而不是嘴形。 **原因—— `LipSyncMode` 不匹配：** 所选 `LipSyncMode` 与 Skeletal Mesh 上的曲线名称不匹配。 **修复：** 选中 `Convai Face Sync` 角色 Blueprint 中的组件，并将其设置为 `LipSyncMode` 为本页顶部表格中对应绑定的特定值。对于整个项目的默认值，请使用 **编辑 > 项目设置 > 插件 > Convai** 并检查 `口型同步模式`. **验证：** 在编辑器中打开 Skeletal Mesh 并检查 **曲线** 列表。所选模式应生成网格中存在的曲线名称。 {% hint style="warning" %} 使用按组件的 `LipSyncMode` 值，当一个项目包含多种绑定类型时。项目级的值可能会导致不同绑定类型的每个角色都动画错误。 {% endhint %} ### 口型同步在说话过程中冻结或漂移 **症状：** 口型同步开始正常，但随后冻结、淡出或落后于音频。 **原因：** 这通常源于时序设置，而不是角色设置。源支持的控制项包括 `OutputFPS`, `FramesBufferDuration`, `LipSyncTimeOffset`, `bEnableInterpolation`，以及 AnimGraph 节点的 `StarvationBlendOutDuration`. **修复：** 使用功能排查页面调整与症状相符的时序控制。不要一次更改多个时序值；先修改一个，在编辑器中运行测试，然后继续。 **验证：** 嘴部在整个响应过程中都应与所说的音频保持同步。 {% content-ref url="/pages/b0b44be9f2ee8ca031b08c9677450b5f826a9c8c" %} [排查口型同步问题](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/lip-sync/troubleshoot-lip-sync.md) {% endcontent-ref %} ### 面部在编辑器中会动，但在打包构建中不动 **症状：** 口型同步在 PIE 中有效，但在烹饪后的构建中面部不动。 **原因：** 曲线资源或 Animation Blueprint 资源可能未包含在烹饪中。Skeletal Mesh 曲线必须被 Animation Blueprint 引用，或包含在资源列表中，才能在烹饪后保留。 **修复：** 确认面部 Animation Blueprint 已被角色 Blueprint 或烹饪中包含的关卡引用。如果曲线被剥离，请将它们添加到该资源的 **Skeleton** 并确保 Skeleton 资源位于已烹饪的软件包中。 **验证：** 运行 Development 烹饪，并检查烹饪日志中是否有关于角色 Skeleton 上被剥离曲线轨道的警告。 ### 下一步 {% content-ref url="/pages/8b7003d8fdf40c7b56b0fd2a54376bfc5105903c" %} [Face Sync 组件参考](/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" %} [排查口型同步问题](/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" %} [诊断和日志导出](/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=&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.