> 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/plugins-and-integrations/convai-unity-sdk/utilities/dialogue-animation.md).

# Dialogue Animation

The Dialogue Animation module drives body and head gesture animations on AI characters using dialogue state and detected emotion as inputs. It runs entirely inside Unity — no animation data is sent to 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>How Dialogue Animation works</strong><br>Understand the four-layer animator stack, clip injection mechanism, and how dialogue state and emotion drive animation.</td><td><a href="/pages/PUogHoj0NzoSUeYvrPHG">/pages/PUogHoj0NzoSUeYvrPHG</a></td></tr><tr><td><strong>Dialogue Animation quick start</strong><br>Add the controller, assign a library and config, and see gesture animation in Play Mode.</td><td><a href="/pages/d426f4256a6e1f6125be8f4b95380e63040b0ad8">/pages/d426f4256a6e1f6125be8f4b95380e63040b0ad8</a></td></tr><tr><td><strong>Animation libraries and profiles</strong><br>Author and configure DialogueAnimationLibrary, RuntimeConfig, and bundled Profile assets.</td><td><a href="/pages/qPHprAmwjoclwLCbma19">/pages/qPHprAmwjoclwLCbma19</a></td></tr><tr><td><strong>Animator Controller requirements</strong><br>Layer indices, required state names, placeholder clip names, and DialogueAnimatorContract field reference.</td><td><a href="/pages/rexsr9WEf5LaEqGfromC">/pages/rexsr9WEf5LaEqGfromC</a></td></tr><tr><td><strong>Build a compatible Animator Controller</strong><br>Step-by-step guide to creating a four-layer Animator Controller from scratch.</td><td><a href="/pages/b8VTVWXZAZp2TSqTLyKK">/pages/b8VTVWXZAZp2TSqTLyKK</a></td></tr><tr><td><strong>Dialogue Animation usage examples</strong><br>Inspector-only and scripted examples across training, medical, and corporate simulation scenarios.</td><td><a href="/pages/e7ea454fb7376765b1f7a8b97e873070ac4737e1">/pages/e7ea454fb7376765b1f7a8b97e873070ac4737e1</a></td></tr><tr><td><strong>Dialogue Animation scripting API</strong><br>Complete reference for ConvaiDialogueAnimationController properties and runtime swap methods.</td><td><a href="/pages/9a94177eabc282ee3f3c5ea48a63fc768dca0453">/pages/9a94177eabc282ee3f3c5ea48a63fc768dca0453</a></td></tr><tr><td><strong>Troubleshoot Dialogue Animation</strong><br>Symptom-driven fixes for silent talk layers, missing animation, and layer index errors.</td><td><a href="/pages/53c2015ebf2f2d7e04074279408d7cbacde002e8">/pages/53c2015ebf2f2d7e04074279408d7cbacde002e8</a></td></tr></tbody></table>

### Next steps

Follow the Quick Start to get the module running on your first character, then read Animation Libraries & Profiles to understand how to customize clip selection for your scenario.

{% content-ref url="/pages/d426f4256a6e1f6125be8f4b95380e63040b0ad8" %}
[Dialogue Animation quick start](/api-docs/plugins-and-integrations/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/plugins-and-integrations/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.