> 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` ，且它已能连接并响应——如果尚未完成，请先完成 [验证设置](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/getting-started/validate-your-setup.md) 。
* 具有可解析 Spine 骨骼的骨架。Humanoid **Humanoid** 骨架会自动解析该骨骼；Generic 骨架或不带 Animator 的骨架则需要添加 [角色骨架绑定](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/character-rig-setup.md) 并至少映射 Spine 后才能使用。

{% hint style="info" %}
Body Language 无需 `ConvaiBodyLanguageProfile` 资源即可运行。仅添加此组件，它就会使用 SDK 内置的 `Natural` 调校方案运行。配置文件用于之后调整行为，而非启用模块。
{% endhint %}

***

### 添加 Body Language 组件

{% stepper %}
{% step %}

#### 选择角色

在 Hierarchy 中，选择附带 `GameObject` 的对象，该对象上有 `ConvaiCharacter` 组件。
{% endstep %}

{% step %}

#### 添加 Body Language 组件

在 Inspector 中选择 **添加组件**，然后选择 **Convai > Embodiment > Body Language**。这会将 `ConvaiBodyLanguageController` 添加到角色上。

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

{% step %}

#### 查看「此角色」卡片

按下 Play 之前， `ConvaiBodyLanguageController` Inspector 中的 **此角色** 卡片会说明此骨架支持哪些部位——脊柱、躯干、肩膀、站姿、手臂——并指出任何会阻止模块运行的问题。只有缺少 Spine 骨骼会导致模块无法运行；缺少胸部、肩膀、髋部或手臂骨骼链，只会关闭依赖相应骨骼的行为。

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

***

### 验证设置

进入 Play 模式并与角色开始对话。即使角色静止待机，它也应当会呼吸、时不时转移重心并原地轻轻摇摆；随着对话在倾听、思考和说话状态之间切换，它的姿势也应明显发生变化。说话时，细微的头部动作和姿势起伏应与语音节奏同步。

{% hint style="success" %}
**预期结果：** 角色持续呼吸，不时转移重心，而不是僵硬地站着；随着对话从待机切换到倾听再到说话，姿势会明显地舒展或倾斜。
{% endhint %}

***

### 故障排查

如果完全没有动作，请打开 `ConvaiBodyLanguageController` Inspector，并先检查 **此角色** 卡片。缺少 Spine 骨骼会使模块无法运行，并在 Console 中记录一条说明原因的错误，而不会抛出异常或重复刷屏。如果卡片显示骨架可用，但角色仍然没有动作，请参阅 [排查身体语言问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/troubleshooting.md) 了解其他可能原因，包括 `Expressiveness` 设置过低。

***

### 后续步骤

{% content-ref url="/pages/201180ea8488e6cfc5bfa3fafd0e21ce57652c6c" %}
[肢体语言如何运作](https://docs.convai.com/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" %}
[调节表现力](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/tune-expressiveness.md)
{% endcontent-ref %}

{% content-ref url="/pages/b0a834d0e9425d60d0788646a7b3343330f88cf0" %}
[触发手势与反应](https://docs.convai.com/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 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/body-language/quick-start.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.
