具身化

查找让 Convai 角色具备眼神接触、手势、姿态和表情的模块，并了解应先添加哪个。

只会说话的 Convai 角色会显得静态：它的眼睛始终盯着某处不动，姿势从不变化，表情也不会对所说内容做出反应。Embodiment 是 Convai 对一组组件的名称，它们赋予角色这些缺失的行为——看向哪里、如何移动、如何站立，以及说话时脸上呈现什么表情。每个模块都是可选的，而且可以独立工作，因此只需添加项目需要的模块，其余可不添加。

---

五个 Embodiment 模块

模块	组件	它为角色带来的作用
对话流程	ConvaiConversationFlowController	跟踪角色是空闲、倾听、思考还是说话。其他四个模块读取这个状态，而不是各自跟踪自己的状态。
注视	ConvaiGazeController	决定角色看向哪里——与玩家进行眼神接触、瞥视，以及注意力切换。
身体动画	ConvaiBodyAnimationController	从动画集播放待机、说话动作、行走和手势。
肢体语言	ConvaiBodyLanguageController	添加环境性姿态、呼吸以及细微的反应动作，让身体在有意动作之间保持“活”起来。
情绪	ConvaiEmotionController	驱动面部表情和情绪，部分来源于随 Convai 响应一同到达的信号。

这五个模块都派生自同一个基础模块，并且每个角色只会注册到一个共享对象上，因此它们是协同工作，而不是互相覆盖。请参见 角色 Embodiment 以了解该共享模型，以及 对话状态 以了解 Conversation Flow 跟踪的状态。

---

从哪里开始

添加 注视 先从这里开始。它是一个单独的组件，不需要为其制作动画集或配置文件，而且它的效果——角色与玩家进行眼神接触——是在播放模式中最容易识别的 Embodiment 行为。Conversation Flow 是基础功能，但通常不需要你手动添加：当另一个模块首次需要读取对话状态时，Convai 会自动添加它。

具身化快速上手

---

这些模块

注视 与物体和其他角色的眼神接触、瞥视，以及角色朝其关注对象转身。

身体动画 从动画集播放待机、说话动作、行走、手势和指向动作，无需制作 Animator Controller。

肢体语言 持续的环境性动作——姿态、呼吸、重心转移、小动作，以及反应节拍。

对话流程 其他模块读取的对话状态时钟，用于安排各自节奏。

情绪 面部表情和持续时间更长的情绪，由随 Convai 响应到达的信号驱动，或由你自己的代码设置。

---

探索 Embodiment

实体化如何运作 运行时视图：Convai 为每个角色预配的内容，以及各模块的运行顺序。

Embodiment 快速入门 向现有角色添加一个模块，并在播放模式中看到它运行。

角色骨骼设置 Convai 如何检测骨骼和 BlendShape，以及何时覆盖映射。

实体化预设 将每个模块的设置打包到一个资源中，并在运行时切换。

面部组合 Emotion 和 LipSync 如何共享嘴部、眉部及其他面部区域。

Embodiment 编辑器窗口 用于检查角色 Embodiment 状态的 Setup、Presets 和 Live 选项卡。

Embodiment 脚本参考 各模块共享的公开 Embodiment API。

排查 Embodiment 问题 诊断 Convai 无法检测到的骨架、缺失的骨骼，以及没有进行更新的模块。