> 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 角色在动画间隙保持生动。

Body Language 是 Convai 的具身模块，为角色提供持续、自然的非语言行为：呼吸、重心转移、细微手势和受到刺激时的惊跳反应；即使在已编排动作之间，这些行为也不会停止。Body Animation 播放预先制作的动画片段——例如行走循环或挥手——而 Body Language 不会控制任何动画片段；它只会在角色当前动作的基础上，叠加少量程序化运动。一个组件 `ConvaiBodyLanguageController`即可驱动所有这些行为。

***

### 身体语言为角色带来的效果

| 行为        | 表现形式                                                        |
| --------- | ----------------------------------------------------------- |
| 呼吸        | 胸部和肩膀持续起伏，偶尔会在受到打断时急促吸气、以叹息放松下来，或在角色开始说话前深吸一口气。             |
| 重心转移与轻微摇摆 | 角色会定期在双脚之间转移重心，并在原地轻柔地摇摆，就像站立的人会不断微调平衡，而不是始终纹丝不动。           |
| 手势动作      | 说话时，轻微的头部动作和姿态起伏会随着角色的说话节奏变化；在已编排的手势之间，双手也会保持些许自然活动，而非僵硬不动。 |
| 倾听姿态      | 倾听时，角色会微微前倾，然后安定下来，偶尔还会专注地歪一下头。                             |
| 小动作       | 待机或思考时，缓慢的左右重心转移可避免角色看起来像被冻结了一样。                            |
| 反应        | 情绪突然高涨——例如惊讶或开心——可能触发一次性的惊吓反应或愉快的弹跳动作。                      |

通过 `ConvaiBodyLanguageController` 将组件添加到角色，路径为 **Convai > Embodiment > Body Language** 之后即可立即使用 SDK 内置的调校参数；无需配置文件资源，即可在播放模式下看到呼吸和重心转移效果。

***

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

Body Animation 和 Body Language 都会驱动角色骨架，但它们解决的问题不同，不会争用同一段动作：

|        | 身体动画                           | 身体语言                                    |
| ------ | ------------------------------ | --------------------------------------- |
| 播放什么   | 预先制作的动画片段：待机、行走循环、说话叠加动画、动作、指向 | 完全不使用动画片段——每个刻都计算连续的程序化运动               |
| 控制什么   | 角色的移动，以及任何有意设计且容易辨认的动作         | 叠加在其上的自然动态：呼吸、重心转移、姿态和细微手势              |
| 两者如何配合 | 照常通过 `PlayableGraph` 播放动画片段    | 在 Body Animation 已设定的姿势上叠加幅度较小、仅影响摆动的偏移 |

角色可以单独使用任一模块，也可以同时使用两者。两者同时启用时，Body Language 会自行减弱，而不是覆盖 Body Animation——请参阅 [身体语言的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/how-body-language-works.md) ，了解确保两者可靠共存的抑制规则。

***

### 入门指南

{% content-ref url="/pages/b2ad39829dc48a1cbdd51297da72ea87b10b339f" %}
[肢体语言快速入门](https://docs.convai.com/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="https://docs.convai.com/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="https://docs.convai.com/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="https://docs.convai.com/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="https://docs.convai.com/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="https://docs.convai.com/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="https://docs.convai.com/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="https://docs.convai.com/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 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.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.
