> 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.md).

# 肢体语言

查找添加环境性姿态、呼吸、重心转移和小型响应动作的指南，让 Convai 角色在动画间隙保持生动。

身体语言是 Convai 的具身模块，它让角色拥有持续的环境式非语言行为：呼吸、重心转移、小动作，以及在编排动作之间也不会停止的反应性退缩。身体动画播放的是编排好的片段——走路循环、挥手——而身体语言从不拥有任何片段；它只是在角色已经在做的动作之上叠加少量程序化运动。一个组件， `ConvaiBodyLanguageController`即可驱动这一切。

***

### 身体语言为角色带来什么

| 行为      | 它看起来是什么样                                                             |
| ------- | -------------------------------------------------------------------- |
| 呼吸      | 胸部和肩膀会以连续循环的方式扩张和收缩，在被打断时偶尔会出现更明显的吸气，在平静下来时会有一声叹息，而在角色开始说话前会有更深的一口气。 |
| 重心转移与摆动 | 角色会定期在双脚之间转移重心，并在原地轻微漂移，就像站立的身体会不断进行微小平衡，而不是保持绝对静止。                  |
| 手势      | 在说话时，细小的点头和姿态脉冲会跟随角色的语速节奏，而它的手在编排动作之间也会保持微妙的“活性”，而不是僵硬地放着不动。         |
| 聆听姿态    | 在倾听时，角色会略微前倾并进入静止状态，偶尔还会带有专注的头部倾斜。                                   |
| 小动作     | 在待机或思考时，缓慢的横向重心转移能避免角色看起来像冻结了一样。                                     |
| 反应      | 突然的情绪爆发——惊讶、好笑——可以触发一次性的受惊退缩或好笑的弹跳。                                  |

添加 `ConvaiBodyLanguageController` 通过……为角色 **Convai > 具身化 > 身体语言** 并且它会立即在 SDK 内置调优上生效——无需任何配置文件资源，就能在播放模式下看到呼吸和重心转移。

***

### 它与身体动画有何不同

身体动画和身体语言都会驱动角色的骨骼运动，但它们解决的是不同问题，而且从不会争夺同一段运动：

|        | 身体动画                          | 肢体语言                        |
| ------ | ----------------------------- | --------------------------- |
| 它播放什么  | 编排好的片段：待机、走路循环、说话叠层、动作、指向     | 完全没有片段——每个 tick 计算出的连续程序化运动 |
| 它负责什么  | 角色的移动和任何刻意、可识别的动作             | 叠加在上面的环境生命感：呼吸、重心转移、姿态、小动作  |
| 两者如何组合 | 通过……播放它的片段 `PlayableGraph` 照常 | 在身体动画已经摆出的姿势之上，只添加少量仅摆动的增量  |

角色可以只使用其中任一模块，也可以两个一起使用。当两者同时存在时，身体语言会降低自身影响，而不是覆盖身体动画——参见 [身体语言如何工作](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/how-body-language-works.md) 中关于抑制规则的说明，该规则使这种共存方式可靠。

***

### 从哪里开始

{% content-ref url="/pages/b2ad39829dc48a1cbdd51297da72ea87b10b339f" %}
[肢体语言快速入门](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/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/body-language/how-body-language-works.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/quick-start.md">肢体语言快速入门</a></td></tr><tr><td><strong>调节表现力</strong><br>通过 ExpressivenessPreset 调节和按行为增益，让角色显得含蓄或戏剧化。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/tune-expressiveness.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/gestures-and-reactions.md">触发手势与反应</a></td></tr><tr><td><strong>身体语言配置文件参考</strong><br>按部分分组的每个 ConvaiBodyLanguageProfile 字段及其默认值。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/profile-reference.md">肢体语言配置文件参考</a></td></tr><tr><td><strong>身体语言脚本参考</strong><br>ConvaiBodyLanguageController 的公共 API：读数、句柄和枚举。</td><td><a href="/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/scripting-reference.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/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/body-language.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.