> 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-unreal-engine-plugin/features/emotion.md).

# 情绪

查找让 Convai 角色表达与对话同步的指南——从快速 Blueprint 设置到完整参考和故障排查。

情绪系统可让 Convai 角色在对话时通过面部动画表达情感。Convai 会分析角色生成的语音，并随音频一同传递情绪状态。插件会将该状态公开为各类情绪的浮点分数，你可以在 Blueprint 中通过 `Get Emotion Score` 读取这些分数，并以适合项目的方式将其应用于形态目标或 Animation Blueprint 变量。

<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>了解 Convai 如何传递情绪状态、服务器端的数值范围如何映射为分数，以及偏移和锁定控件的作用。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/how-the-emotion-system-works.md">情绪系统的工作原理</a></td></tr><tr><td><strong>情绪快速入门</strong><br>只需几个 Blueprint 步骤，即可订阅情绪状态变更，并将各类情绪的分数应用于角色网格体上的形态目标。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/emotion-quick-start.md">情绪快速入门</a></td></tr><tr><td><strong>情绪 Blueprint 参考</strong><br>Convai Chatbot 组件中由分数驱动的情绪属性、函数和状态变更事件。</td><td><a href="https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/emotion-blueprint-reference.md">情绪 Blueprint 参考</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-unreal-engine-plugin/features/emotion/emotion-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-unreal-engine-plugin/features/emotion/troubleshoot-emotion.md">排查情绪问题</a></td></tr></tbody></table>

### 从这里开始

请先阅读 [情绪系统的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/how-the-emotion-system-works.md) 以了解评分模型和控件。然后按照 [情绪快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/emotion-quick-start.md) 中的步骤，将表情分数连接到角色网格体，只需几个 Blueprint 步骤即可完成，然后再继续查看参考资料和高级示例。


---

# 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-unreal-engine-plugin/features/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.
