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

# 情绪

Emotion 系统将 Convai AI 的情感信号转换为实时面部动画，可驱动 BlendShape、Animator 参数，或两者同时驱动。本节涵盖从首次可用的设置到自定义分类法编写以及完整脚本 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="/pages/a169ddd3c944e6f42f2701922ad7b55a03ac789a">/pages/a169ddd3c944e6f42f2701922ad7b55a03ac789a</a></td></tr><tr><td><strong>Emotion 快速入门</strong><br>挂载 Emotion Controller，分配随附的配置文件，即可看到你的 NPC 对对话产生情感反应——无需自定义资源。</td><td><a href="/pages/e4e5139a33824d66acc5af79e26ea948910fdcd0">/pages/e4e5139a33824d66acc5af79e26ea948910fdcd0</a></td></tr><tr><td><strong>情绪配置文件</strong><br>在一个可移植资源中配置平滑速度、微表情爆发、静默交替以及输出绑定。</td><td><a href="/pages/5a9247365092d958f2d539ae98bdfe69f72df091">/pages/5a9247365092d958f2d539ae98bdfe69f72df091</a></td></tr><tr><td><strong>情绪输出绑定</strong><br>将平滑后的情感分数映射到面部 BlendShape 和 Animator 的浮点参数，并可对每个槽位进行权重和 LipSync 控制。</td><td><a href="/pages/931fe5969b6c7b83aac82771a8aedc0f94f896d1">/pages/931fe5969b6c7b83aac82771a8aedc0f94f896d1</a></td></tr><tr><td><strong>Emotion 分类法</strong><br>了解内置的 Plutchik 词汇、服务器别名如何解析，以及如何编写自定义分类法。</td><td><a href="/pages/830c8a41ce176512408273566b88a4c868c56a59">/pages/830c8a41ce176512408273566b88a4c868c56a59</a></td></tr><tr><td><strong>Emotion 脚本 API</strong><br>读取实时情感状态、注入覆盖、锁定表情，并响应情感事件——从 Inspector 中继到类型化的 C# 订阅。</td><td><a href="/pages/39d161d99d04e6ca98725c740d134ccb5eac9e73">/pages/39d161d99d04e6ca98725c740d134ccb5eac9e73</a></td></tr><tr><td><strong>情绪示例</strong><br>涵盖危险触发、锁定问候、痛苦分支、分析日志记录和编辑器调试的完整场景。</td><td><a href="/pages/6c46f45b25431c91dffb50ae4e5dd2ea5cc7ef50">/pages/6c46f45b25431c91dffb50ae4e5dd2ea5cc7ef50</a></td></tr><tr><td><strong>排查情绪问题</strong><br>逐步修复最常见的问题——从表情无法动起来，到 LipSync 冲突和生产构建问题。</td><td><a href="/pages/65ec9decd2473b72bc06bf3c946f3008c8528dda">/pages/65ec9decd2473b72bc06bf3c946f3008c8528dda</a></td></tr></tbody></table>

### 下一步

从 [Emotion 快速入门](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/emotion/quick-start.md) 开始，让你的第一个 NPC 运行表情。然后阅读 [情绪系统如何工作](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/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 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/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.