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

# 肢体语言快速入门

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

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

***

### 前提条件

* 某个 `ConvaiCharacter` 在你的场景中，已经可以连接并响应——先完成 [验证你的设置](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/validate-your-setup.md) 如果你还没有的话，请先完成。
* 一个带有可解析 Spine 骨骼的绑定。一个 **Humanoid** 绑定会自动解析一个；当你添加了一个 [角色绑定](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/character-rig-setup.md) 并至少映射脊柱。

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

***

### 添加 Body Language 组件

{% stepper %}
{% step %}

#### 选择角色

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

{% step %}

#### 添加 Body Language 组件

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

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

{% step %}

#### 阅读 This Character 卡片

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

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

***

### 验证设置

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

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

***

### 故障排除

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

***

### 下一步

{% content-ref url="/pages/201180ea8488e6cfc5bfa3fafd0e21ce57652c6c" %}
[肢体语言如何运作](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/how-body-language-works.md)
{% endcontent-ref %}

{% content-ref url="/pages/652efa54160d6791ad8f9dfe70dc962fa595d73a" %}
[调节表现力](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/tune-expressiveness.md)
{% endcontent-ref %}

{% content-ref url="/pages/b0a834d0e9425d60d0788646a7b3343330f88cf0" %}
[触发手势与反应](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/gestures-and-reactions.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/body-language/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.