> 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-unity-sdk/embodiment.md).

# 具身化

查找为 Convai 角色提供眼神接触、手势、姿势和表情的模块，并了解应先添加哪一个。

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

***

### 五个 Embodiment 模块

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

这五个模块都派生自同一个基础模块，并且每个角色只会注册到一个共享对象上，因此它们是协同工作，而不是互相覆盖。请参见 [角色 Embodiment](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/character-embodiment.md) 以了解该共享模型，以及 [对话状态](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/dialogue-state.md) 以了解 Conversation Flow 跟踪的状态。

***

### 从哪里开始

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

{% content-ref url="/pages/73e995564a424dd193e693891d64a815b3e79450" %}
[具身化快速入门](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/quick-start.md)
{% endcontent-ref %}

***

### 这些模块

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>注视</strong><br>与物体和其他角色的眼神接触、瞥视，以及角色朝其关注对象转身。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze.md">视线</a></td></tr><tr><td><strong>身体动画</strong><br>从动画集播放待机、说话动作、行走、手势和指向动作，无需制作 Animator Controller。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-animation.md">身体动画</a></td></tr><tr><td><strong>肢体语言</strong><br>持续的环境性动作——姿态、呼吸、重心转移、小动作，以及反应节拍。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language.md">肢体语言</a></td></tr><tr><td><strong>对话流程</strong><br>其他模块读取的对话状态时钟，用于安排各自节奏。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/conversation-flow.md">对话流程</a></td></tr><tr><td><strong>情绪</strong><br>面部表情和持续时间更长的情绪，由随 Convai 响应到达的信号驱动，或由你自己的代码设置。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion.md">情绪</a></td></tr></tbody></table>

***

### 探索 Embodiment

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>实体化如何运作</strong><br>运行时视图：Convai 为每个角色预配的内容，以及各模块的运行顺序。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/how-embodiment-works.md">具身化如何运作</a></td></tr><tr><td><strong>Embodiment 快速入门</strong><br>向现有角色添加一个模块，并在播放模式中看到它运行。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/quick-start.md">具身化快速入门</a></td></tr><tr><td><strong>角色骨骼设置</strong><br>Convai 如何检测骨骼和 BlendShape，以及何时覆盖映射。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/character-rig-setup.md">角色骨架设置</a></td></tr><tr><td><strong>实体化预设</strong><br>将每个模块的设置打包到一个资源中，并在运行时切换。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/embodiment-presets.md">具身化预设</a></td></tr><tr><td><strong>面部组合</strong><br>Emotion 和 LipSync 如何共享嘴部、眉部及其他面部区域。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/facial-composition.md">面部组合</a></td></tr><tr><td><strong>Embodiment 编辑器窗口</strong><br>用于检查角色 Embodiment 状态的 Setup、Presets 和 Live 选项卡。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/embodiment-editor.md">具身化编辑器窗口</a></td></tr><tr><td><strong>Embodiment 脚本参考</strong><br>各模块共享的公开 Embodiment API。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/scripting-reference.md">具身化脚本参考</a></td></tr><tr><td><strong>排查 Embodiment 问题</strong><br>诊断 Convai 无法检测到的骨架、缺失的骨骼，以及没有进行更新的模块。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/troubleshooting.md">排查具身化问题</a></td></tr></tbody></table>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.