> 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/utilities/dialogue-animation.md).

# 对话动画

对话动画模块利用对话状态和检测到的情绪作为输入，为 AI 角色驱动身体和头部手势动画。它完全在 Unity 内运行——不会向 Convai 发送任何动画数据。

<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="/pages/da0a7ca0f3dd37ca93606601ab594c12136f816a">/pages/da0a7ca0f3dd37ca93606601ab594c12136f816a</a></td></tr><tr><td><strong>对话动画快速入门</strong><br>添加控制器，分配库和配置，然后在播放模式下查看手势动画。</td><td><a href="/pages/cf0343f3a0b58d2e8e0e7f1a0c9eee9a6c5ecd1d">/pages/cf0343f3a0b58d2e8e0e7f1a0c9eee9a6c5ecd1d</a></td></tr><tr><td><strong>动画库和配置文件</strong><br>创建并配置 DialogueAnimationLibrary、RuntimeConfig 和捆绑的 Profile 资源。</td><td><a href="/pages/0f3cbc0e4633317c448740563d0c38854e7725ee">/pages/0f3cbc0e4633317c448740563d0c38854e7725ee</a></td></tr><tr><td><strong>Animator 控制器要求</strong><br>层索引、必需的状态名称、占位剪辑名称，以及 DialogueAnimatorContract 字段参考。</td><td><a href="/pages/9e00cc9c176681b9489a9cd12ee13917fd6f11ea">/pages/9e00cc9c176681b9489a9cd12ee13917fd6f11ea</a></td></tr><tr><td><strong>构建兼容的 Animator 控制器</strong><br>从零开始创建四层 Animator Controller 的分步指南。</td><td><a href="/pages/547a1c8f364d8b30d06385d1f1f82837227e6c82">/pages/547a1c8f364d8b30d06385d1f1f82837227e6c82</a></td></tr><tr><td><strong>对话动画使用示例</strong><br>涵盖培训、医疗和企业模拟场景的仅检查器示例和脚本示例。</td><td><a href="/pages/b57405f03c1f45cc9e305ce32db7cbe06e914f5b">/pages/b57405f03c1f45cc9e305ce32db7cbe06e914f5b</a></td></tr><tr><td><strong>对话动画脚本 API</strong><br>ConvaiDialogueAnimationController 属性和运行时切换方法的完整参考。</td><td><a href="/pages/9be0dcfc097dc8444409730b1036b4a2f70ec112">/pages/9be0dcfc097dc8444409730b1036b4a2f70ec112</a></td></tr><tr><td><strong>对话动画故障排除</strong><br>针对无声的对话层、缺失动画和层索引错误的按症状修复方法。</td><td><a href="/pages/0701ede6b3c4cdf57154ba57ba35ff6bd82a86bf">/pages/0701ede6b3c4cdf57154ba57ba35ff6bd82a86bf</a></td></tr></tbody></table>

### 下一步

先按照快速入门让模块在你的第一个角色上运行，然后阅读动画库与配置文件，了解如何为你的场景自定义剪辑选择。

{% content-ref url="/pages/cf0343f3a0b58d2e8e0e7f1a0c9eee9a6c5ecd1d" %}
[对话动画快速开始](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/utilities/dialogue-animation/quick-start.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:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/utilities/dialogue-animation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.