> 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 跟踪的状态。

***

### 从哪里开始

添加 **凝视** 先从这里开始。它是一个单独的组件，不需要为制作而准备动画集或配置文件，而且它的效果——角色与玩家进行眼神接触——是在 Play 模式中最容易识别的 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>向现有角色添加一个模块，并在 Play 模式中查看其效果。</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.