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

# 情绪编辑器窗口

情绪编辑器窗口参考，涵盖其四个选项卡以及从“实时”选项卡打开的情绪时间线记录器。

`Convai > 情绪编辑器` 打开 Emotion 的仅深度工作窗口——相比同一角色的 Inspector，它提供更宽的界面，可从组件检查器的 **高级设置与表达式 →** 链接，或直接从菜单打开。本页介绍其四个选项卡，以及可从 Live 选项卡打开的情绪时间线窗口。

***

### 打开窗口

`Convai > 情绪编辑器` (`ConvaiEmotionEditorWindow`，窗口标题 **Convai 情绪**）会打开该窗口，并已显示当前选中的任意一个 `ConvaiEmotionController` 在场景中被选中的，或者找到的第一个。组件检查器的 **高级设置与表达式 →** 链接会打开同一个窗口，并已将目标指向该角色。打开窗口从来都不是必需步骤——Inspector 本身承担常规设置流程；这个窗口则承载所有不适合放在那里的内容。

左侧窗格列出每一个 `ConvaiEmotionController` 在已打开场景中，带有状态圆点的—— **Ready**, **需要关注**，或 **未设置** ——因此，可以快速浏览角色场景，而无需在 Hierarchy 中四处寻找。

***

### 四个选项卡

| 选项卡      | 显示内容                                                                  |
| -------- | --------------------------------------------------------------------- |
| **设置**   | 与 Inspector 显示的相同设置检查清单，占满整行宽度，并附带每条发现及其修复方式。                         |
| **感受**   | 分配给该对象的每一项设置 `ConvaiEmotionProfile`，按部分分组——这是 Inspector 那几个控件背后的完整界面。 |
| **表达式**  | Convai 在该角色自身面部上解析出的内容——命名约定、匹配置信度，以及每个网格的形状数量——随后是手工编写的表情配方和材质效果。    |
| **Live** | 该角色当前的情绪、强度、持续时长、保持时长、静息心情、嘴部影响，以及每个非零分数情绪对应的一根条形。仅在 Play 模式下可用。      |

没有 `ConvaiEmotionProfile` 已分配时显示一个 **未分配个性** 消息显示在 **感受** 和 **表达式** 空字段，而不是空字段，因为该角色上目前还没有可调整的内容。

***

### 情绪时间线窗口

该 **打开情绪时间线** 按钮位于 **Live** 选项卡会打开 `ConvaiEmotionTimelineWindow` （窗口标题 **情绪时间线**）已经在监视情绪编辑器窗口中所选的角色。它没有自己的菜单项——只有在已经选定角色后，时间线才有意义，而 Live 选项卡已经完成了这一步。

时间线绘制的是 Play 模式下某个角色情绪变化随时间的记录：每个分类标签的输出分数各用一条线表示，静息心情分数则作为单独的强调线绘制，并在每当 `DominantEmotionChanged` 或 `MoodChanged` 触发时显示垂直标记。先分配一个目标，然后：

| 控制        | 作用                          |
| --------- | --------------------------- |
| **Start** | 开始录制。仅在已分配目标且处于 Play 模式时可用。 |
| **停止**    | 结束捕获，但不丢弃它。                 |
| **清除**    | 清空图表。                       |

采样数据取自目标的公开 `当前` 读数，按固定采样间隔获取——记录器从不直接接触逐帧运行时状态。可使用时间线凭直觉调整角色的性情，或在事后调试一次被报告为“情绪感觉不对”的会话。

{% hint style="info" %}
时间线仅是编辑器专用工具。它没有运行时 API，也不会改变角色在构建中的行为。
{% endhint %}

***

### 下一步

{% content-ref url="/pages/a169ddd3c944e6f42f2701922ad7b55a03ac789a" %}
[情绪系统的工作原理](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/how-the-emotion-system-works.md)
{% endcontent-ref %}

{% content-ref url="/pages/e4e5139a33824d66acc5af79e26ea948910fdcd0" %}
[情绪快速入门](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/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, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/emotion/emotion-editor.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.