肢体语言快速上手

将 Body Language 组件添加到 Convai 角色，并在 Play 模式中看到呼吸、重心转移和空闲生命动作。

添加 ConvaiBodyLanguageController 到一个现有的 Convai 角色上，并确认它会呼吸、转移重心，并在 Play 模式下的动作间保持明显的生命感。在你已经有一个可用的 ConvaiCharacter 放在你的场景中，并希望在调整任何设置之前先看到 Body Language 运行起来时使用本页。

---

前提条件

• 某个 ConvaiCharacter 在你的场景中，已经可以连接并响应——先完成 验证你的设置 如果你还没有的话，请先完成。
• 一个带有可解析 Spine 骨骼的绑定。一个 Humanoid 绑定会自动解析一个；当你添加了一个 角色绑定 并至少映射脊柱。

Body Language 不需要一个 ConvaiBodyLanguageProfile 资源即可工作。只添加该组件就会让它在 SDK 内置的 自然 调优——配置文件用于之后重塑行为，而不是用于开启该模块。

---

添加 Body Language 组件

1

选择角色

在 Hierarchy 中，选择 GameObject 携带 ConvaiCharacter 组件。

2

添加 Body Language 组件

在 Inspector 中，选择 Add Component，然后 Convai > 具身化 > 身体语言。这会添加 ConvaiBodyLanguageController 到角色上。

Convai 还会自动添加该模块所需的共享基础设施——一个 EmbodimentContext 和一个 StandardRigBinding ——会自动添加。你无需自行添加这些。

3

阅读 This Character 卡片

在按下 Play 之前， ConvaiBodyLanguageController 检查器的 此角色 卡片会说明这个绑定提供什么——脊柱、躯干、肩膀、站姿、手臂——并指出任何会阻止该模块工作的内容。只有缺少 Spine 骨骼会阻塞它；缺少胸部、肩膀、髋部或手臂链只会关闭依赖于该骨骼的行为。

Body Language 没有像 Gaze 或 Body Animation 那样的专用编辑器窗口。它的所有设置和实时诊断都在这个组件的 Inspector 中。

---

验证设置

进入 Play 模式并与角色开始对话。即使在闲置状态下，角色也应该会呼吸、定期转移重心并在原地轻微摆动；随着对话在倾听、思考和说话之间切换，它的姿态应当明显地以不同方式收拢或展开。在它说话时，细小的头部节拍和姿态脉动应当跟随其语音节奏。

预期结果： 角色会持续呼吸，不会僵直站立，而是时不时转移重心；当对话从闲置转到倾听再到说话时，它的姿态会明显打开或前倾。

---

故障排除

如果完全没有任何动作，请打开 ConvaiBodyLanguageController Inspector 并检查 此角色 先检查卡片——缺少 Spine 骨骼会使该模块失效，并在 Console 中记录一条注明原因的错误，而不会抛出异常或刷屏。如果卡片显示该绑定可用，但角色仍然看起来静止，请参见 排查身体语言问题 以查看其余原因，包括较低的 表现力 设置，否则角色会说出结果。

---

下一步

肢体语言如何工作调整表现力触发手势与反应