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

# 情绪

查找 Convai 角色面部表情与心情的指南，从初始设置到脚本 API 和故障排查。

情绪会影响 Convai 角色的面部表情和持续时间更长的静息心境。部分输入随 Convai 的响应一起传入，其余部分则由你配置和编写脚本。本节涵盖从首次完成可用设置，到心境控制、分类体系编写以及完整脚本 API 的所有内容。

<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/emotion/how-the-emotion-system-works.md">情绪系统的工作原理</a></td></tr><tr><td><strong>情绪快速入门</strong><br>添加 Emotion Controller，运行设置流程，看看角色如何对对话做出情绪反应。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/quick-start.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/emotion/moods.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/emotion/emotion-profile.md">Emotion 配置文件</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/emotion/output-bindings.md">Emotion 输出绑定</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/emotion/emotion-taxonomy.md">Emotion 分类体系</a></td></tr><tr><td><strong>情绪脚本 API</strong><br>通过代码读取实时情绪状态、控制心境，并响应情绪事件。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/scripting-api.md">Emotion 脚本 API</a></td></tr><tr><td><strong>情绪编辑器窗口</strong><br>使用 Emotion 编辑器窗口的四个选项卡和 Emotion Timeline 记录器。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/emotion-editor.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/emotion/usage-examples.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/emotion/troubleshooting-and-diagnostics.md">排查情绪问题</a></td></tr></tbody></table>

### 后续步骤

从 [情绪快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/quick-start.md) 开始，让你的第一个角色显示表情。然后阅读 [情绪系统的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/how-the-emotion-system-works.md) ，先了解处理流程和输入来源，再继续学习心境控制和参考页面。


---

# 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/emotion.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.
