设置 Reallusion(CC)角色
导出 Reallusion CC5 头像,将其导入 Unreal Engine,配置 Convai 组件,并添加 Reallusion 动画 Blueprint 以实现唇形同步。
本指南涵盖将 Reallusion Character Creator 5(CC5)头像连接到 Convai Unreal Engine 插件的完整流程。
前置条件
已安装 Reallusion Character Creator 5。
已安装 Convai 插件且已配置你的 API 密钥 — 见 安装 Convai 插件 和 配置你的 API 密钥.
你已从控制台获得一个 Convai 角色 ID。
在 Character Creator 5 中准备动画
从 Character Creator 5 导出头像
为 Unreal Engine 安装 Reallusion CC Auto Setup
CC Auto Setup 是 Reallusion 提供的第三方工具——它不属于 Convai 插件。它会为导入 Unreal Engine 的 Reallusion 角色设置正确的材质、着色器和骨骼。
下载并安装 CC Auto Setup
从以下页面下载 CC Auto Setup: Reallusion CC Auto Setup for Unreal Engine 页面。双击安装程序,接受许可协议,然后点击 下一步。请记住目标文件夹路径——下一步你会用到它。
将 Reallusion 头像导入 Unreal Engine
在 Unreal Engine 中设置 Convai
将 Convai Player 组件添加到玩家 Pawn
如果你还没有这样做,打开你的玩家 Pawn 蓝图并添加 UConvaiPlayerComponent。有关详细步骤,请参见 添加你的第一个 Convai 角色.
要在 Play 模式下找到 player pawn:按 Shift+F1 释放鼠标,单击 Detach 工具栏中的,然后单击视口中的玩家角色并单击 编辑蓝图.
测试对话
进入 Play 模式并使用按住说话(默认: T)或聊天小部件与角色交谈。在此阶段,预计只有语音和文本回复会带有音频播放——身体动画和口型同步需要下面的动画蓝图和 Face Sync 步骤。
添加 Reallusion 动画蓝图
Reallusion 角色需要 Convai Reallusion 动画蓝图(Convai_Reallusion_AnimBP)来在对话期间驱动待机、说话、注视和行走状态。
配置动画蓝图
重启后,找到 Convai_Reallusion_AnimBP ,位于 内容浏览器 并双击它。收到提示时,选择你 Reallusion 头像的骨骼。
打开 Animation Graph 在……内部 Convai_Reallusion_AnimBP。在 内容抽屉中,导航到角色的 motion 文件夹并找到你从 Character Creator 5 导出的动画资源。将每个动画拖放到图表中,并将其连接到相应状态:
BaseAnimation
待机动画——默认静止姿势
Talk Animation
角色说话时的身体动画
Focus Animation
角色在倾听或专注时的动画
Walk Animation
角色移动时的移动动画
如果拖放没有连接,请在图表中右键单击,输入
播放,然后按名称手动选择该动画。将状态之间的过渡混合设置为在适当时使用待机动画。
确保所有循环动画都设置为 循环.
点击 编译 和 保存.
使用 Convai Face Sync 添加面部动画
故障排除
没有面部动画
症状: 尽管音频播放正常,但角色在说话时嘴巴不动。
原因: UConvaiFaceSyncComponent 缺失, 口型同步模式 被设置为错误的 blendshape 目标,或者导入 FBX 时未启用 导入形态目标 。
修复:
确认 Convai Face Sync 组件存在于角色蓝图中。
确认 口型同步模式 设置为 MetaHuman 混合变形 适用于 CC5 角色,或者 CC4 扩展混合变形 适用于 CC4 角色。
如果问题仍然存在,请在重新导入 FBX 时 导入形态目标 在 高级 FBX Import Options 对话框的
验证: 中勾选。进入 Play 模式并与角色对话。嘴唇应与语音回复同步动画。如果没有,请打开 窗口 > 输出日志,筛选 ConvaiFaceSync,并检查说话期间的错误。
身体动画不播放
症状: 角色僵立不动——对话期间既不播放待机动画也不播放说话动画。
原因: 动画类 Skeletal Mesh 上未设置为 Reallusion 动画蓝图、动画未设置为循环,或者首尾帧不匹配,从而导致动画跳切。
修复:
确认 动画类 Skeletal Mesh 组件上的
Convai_Reallusion_AnimBP.打开
Convai_Reallusion_AnimBP设置为BaseAnimation,Talk Animation,Focus Animation,Walk Animation并确认每个状态(确认每个循环动画资源都设置为 循环.
确认每个动画的首帧和尾帧完全相同。
验证: 进入 Play 模式并确认角色会播放待机动画,并在响应时切换到说话动画。如果状态没有变化,请检查 窗口 > 输出日志 中的动画或 Convai 错误。
角色不响应语音或文本
症状: Reallusion 角色在关卡中,但对输入没有反应。
原因: 该 角色 ID 缺失或不正确,API 密钥未配置,或者 UConvaiPlayerComponent 未添加到玩家 pawn 中。
修复: 验证 角色 ID 在 Convai 聊天机器人 组件并确认已设置你的 API 密钥(参见 配置你的 API 密钥)。确认玩家 pawn 已添加 UConvaiPlayerComponent 。
验证: 打开 窗口 > 输出日志,筛选 ConvaiChatbotComponentLog 或 ConvaiConnectionManagerLog,并在进入 Play 模式时查找身份验证或连接错误。
下一步
配置麦克风配置对话输入验证你的设置最后更新于
这有帮助吗?