口型同步快速入门

向 MetaHuman 角色添加 Convai Face Sync 组件和 Convai 动画类，并在编辑器内播放中听到口型同步语音。

我们将为一个已经具有一个……的 MetaHuman 角色添加口型同步 Convai Chatbot 组件已附加。最后，在播放模式下与角色对话时，它的嘴部和面部将会随着回复音频同步动画。

先决条件

• Convai Unreal Engine 插件已安装，并已配置 API 密钥。
• 你的关卡中有一个 MetaHuman Actor，并且有一个正常工作的 Convai Chatbot 组件（角色会说话，但面部尚未动画）。

如果你是从零开始，请先完成 设置 MetaHuman 角色 ——该指南涵盖了完整的 MetaHuman 导入和 Convai 组件设置。

添加 Face Sync 组件

1

打开 MetaHuman 蓝图

在 内容浏览器，打开你的 MetaHuman Actor 的蓝图（例如 BP_MyMetaHuman）。选择 组件 面板中分配。

2

添加 Convai Face Sync

点击 添加 中创建该资源 组件 面板并搜索 Convai Face Sync。选择它以将组件添加到 Actor。

3

设置口型同步模式

选中 Convai Face Sync 组件后，打开 详细信息 面板。在 Convai | LipSync，将 Lip Sync Mode 设为 MetaHuman Blendshapes.

Blendshapes 是用于面部运动的网格形状目标，例如张嘴和嘴唇卷曲。此设置会告诉插件驱动 MetaHuman 曲线集。

4

编译并保存

点击 编译 然后 保存 在蓝图编辑器工具栏中。该 组件 面板现在会显示一个 Convai Face Sync 位于 Actor 根节点下的条目。

分配 Convai 动画类

Convai 插件随附两个为 MetaHuman 角色预先构建的动画类。分配它们会将来自 Convai Face Sync 组件的口型同步数据连接到角色的面部和身体网格，以便 AnimGraph 可以在每个 tick 应用它。

这些动画类位于 MetaHumans/Animations/ (ConvAI > MetaHumans > Animations 中创建该资源 内容浏览器）。在 MetaHuman 骨骼网格组件上分配它们。

1

设置身体动画类

在 MetaHuman 蓝图中，选择 Body 骨骼网格组件。在 详细信息 面板中，找到 Anim Class 在 Animation下。将其设置为 Convai_MetaHuman_BodyAnim.

2

设置面部动画类

选择 Face 骨骼网格组件。在 详细信息 面板中，找到 Anim Class下。将其设置为 Convai_MetaHuman_FaceAnim.

3

编译并保存

点击 编译 然后 保存 在蓝图编辑器中。

运行角色

进入播放模式并与角色发起对话。

角色的嘴部和面部 blendshapes 应会与其语音同步动画。你会看到下颌、嘴唇和脸颊曲线在角色说话时驱动 MetaHuman 面部。

如果嘴部没有动，请确认：

• Lip Sync Mode 在该 Convai Face Sync 组件已设置为 MetaHuman Blendshapes.
• Anim Class 在该 Face 网格是 Convai_MetaHuman_FaceAnim 并且在 Body 网格是 Convai_MetaHuman_BodyAnim.
• 该 Convai Chatbot 同一 Actor 上的组件具有有效的角色 ID，且插件可以连接到 Convai。

参见 排查口型同步问题 以获取详细的症状与修复指南。

下一步

口型同步如何工作Face Sync 组件参考设置 MetaHuman 角色