> 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 角色在对话时通过面部动画表现情感。Convai 会分析角色生成的语音，并随音频一同传递情绪状态。该插件将此状态暴露为按情绪划分的浮点分数，你可以在 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="/pages/c3081281b873e1a1b00439a147d3db6877743003">/pages/c3081281b873e1a1b00439a147d3db6877743003</a></td></tr><tr><td><strong>情绪快速入门</strong><br>订阅情绪状态变化，并通过几个 Blueprint 步骤将各情绪分数应用到角色网格上的变形目标。</td><td><a href="/pages/760d975e7440e1f0f9fb57d5477018161e976844">/pages/760d975e7440e1f0f9fb57d5477018161e976844</a></td></tr><tr><td><strong>情绪 Blueprint 参考</strong><br>Convai Chatbot 组件上受支持的基于分数的情绪属性、函数以及状态变更事件。</td><td><a href="/pages/9ac48061a03a0400ae6e1769df358c2fb2a82536">/pages/9ac48061a03a0400ae6e1769df358c2fb2a82536</a></td></tr><tr><td><strong>情绪示例</strong><br>强制设定某种情绪，锁定表情状态，并读取分数以驱动游戏效果或视觉反馈。</td><td><a href="/pages/83566839f3555aa1855858bb1bc0c20ed5a973cc">/pages/83566839f3555aa1855858bb1bc0c20ed5a973cc</a></td></tr><tr><td><strong>情绪故障排查</strong><br>修复情绪未显示、状态卡在锁定模式，以及角色网格上的变形目标不匹配问题。</td><td><a href="/pages/e1b9621c0881a69a39466e1413b1623f73166c9b">/pages/e1b9621c0881a69a39466e1413b1623f73166c9b</a></td></tr></tbody></table>

### 从这里开始

从以下开始 [情绪系统的工作原理](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unreal-engine-plugin/features/emotion/how-the-emotion-system-works.md) 以了解评分模型和控制项。然后按照 [情绪快速入门](/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 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-unreal-engine-plugin/features/emotion.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.