> 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/quick-start.md).

# 具身化快速入门

将凝视模块添加到现有 Convai 角色，使其与玩家进行眼神接触，并在 Play 模式下立即可见。

将 Gaze 模块添加到现有的 Convai 角色中，并确认该角色在 Play 模式下会与玩家进行眼神接触。请在你已经有一个可正常工作的 `ConvaiCharacter` 在你的场景中，并且想在配置其他四个模块之前，首次查看实体化行为。

***

### 前提条件

* 某个 `ConvaiCharacter` 在你的场景中，已经可以连接并响应——先完成 [验证你的设置](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/validate-your-setup.md) 如果你还没有的话，请先完成。
* 一个 `Animator` 在角色上。一个 **Humanoid** 绑定让 Convai 自动映射头部和眼睛；一个 **通用** 绑定也可以，只要有一个 `角色 Rig` 绑定至少分配了头部。

{% hint style="info" %}
在尝试某个模块之前，你不需要先创建设置资源。每个模块都会使用经过调优、外观合适的内置默认值运行——配置文件是为了之后调整行为，而不是用于启用模块。
{% endhint %}

***

### 添加 Gaze 模块

{% stepper %}
{% step %}

#### 选择角色

在 Hierarchy 中，选择 `GameObject` 携带 `ConvaiCharacter` 组件。
{% endstep %}

{% step %}

#### 添加 Gaze 组件

在 Inspector 中，选择 **Add Component**，然后 **Convai > Embodiment > Gaze**。这会添加 `ConvaiGazeController` 到角色上。

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

{% step %}

#### 检查绑定检测

打开 **Convai > 具身编辑器** 并选择 **设置** 选项卡。选择 **设置此角色** 以查看 Convai 检测到了哪种面部 blendshape 规范、该检测的置信度如何，以及解析出了哪些骨骼。

这一步是可选的——即使不做，Gaze 也能正常工作——但它可以让你在进入 Play 模式之前看到 Convai 已经识别出了什么。
{% endstep %}
{% endstepper %}

***

### 验证设置

进入 Play 模式并与角色开始对话。Gaze 的默认眼神接触模式是 `自然` ——当你绕着它移动时，角色的眼睛和头部应明显跟随你，而不是固定在空间中的某一点。

{% hint style="success" %}
**预期结果：** 对话开始后不久，角色的头部和眼睛会转向你，并在对话进行时持续跟踪你的位置。
{% endhint %}

***

### 故障排除

如果角色的眼睛和头部没有移动，请打开 **Convai > Embodiment Editor > Setup** 并检查检测到的绑定规范及其置信度——低置信度检测是最常见的原因。参见 [角色骨骼设置](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/character-rig-setup.md) 以修复骨骼或 blendshape 映射，或者 [排查 Embodiment 问题](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/troubleshooting.md) 查看完整的失败模式集合。

***

### 下一步

{% content-ref url="/pages/528b8780a5fa83913d2d3f95cdbf6b1a0c52b073" %}
[具身化如何运作](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/how-embodiment-works.md)
{% endcontent-ref %}

{% content-ref url="/pages/dddb9a87015e6befbe3c15caf6aa6b2df224fa33" %}
[角色骨架设置](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/character-rig-setup.md)
{% endcontent-ref %}

{% content-ref url="/pages/260c8f480c6e05ba6ea9db729322298e970606cc" %}
[具身化预设](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/embodiment-presets.md)
{% endcontent-ref %}


---

# 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/quick-start.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.