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

# 具身化编辑器窗口

Convai 具身化编辑器窗口参考，涵盖“设置”“预设”和“实时”选项卡，以及每个选项卡展示的角色信息。

Convai 具身编辑器是一个 `Convai/Embodiment Editor` 包含三个选项卡的窗口： `Setup`, `Presets`和 `Live`。其副标题为“设置角色的注视、情绪和身体”。使用它可以检查角色的骨架和模块是否配置正确，查看项目中的所有 `ConvaiEmbodimentPreset` ，并在播放模式下查看运行中角色的对话和情绪状态。

### 打开窗口

选择 **Convai > Embodiment Editor** 以打开窗口。

在窗口顶部，有一个 **跟随所选对象** 切换开关（工具提示：“跟踪场景中当前选中的角色。”），用于控制窗口检查哪个角色。启用后，窗口会跟随在层级视图中选中的 `GameObject` ，并向上查找到最近的 `ConvaiCharacter` 如果所选对象是子对象。禁用时，将一个 `GameObject` 手动拖入角色字段。

角色选择器下方的三个选项卡依次为： `设置`, `预设`, `实时`.

### 设置选项卡

此 `设置` 选项卡（工具提示：“启用此角色的表情特征。”）会显示所选角色的两个部分。

#### 绑定

此 `Rig` 部分标题会显示三个状态词之一，具体取决于该角色报告的问题中最严重的一项：

| 标题状态              | 含义                                                |
| ----------------- | ------------------------------------------------- |
| `Ready`           | 未发现问题。                                            |
| `Needs Attention` | 该角色仍可正常使用，但效果不够理想，例如面部绑定检测的置信度较低。                 |
| `Not Set Up`      | 在列出的问题修复之前，角色的行为不会正常——例如，缺少 `ConvaiCharacter` 组件。 |

标题下方的选项卡会将每项检查结果列为简短标题和说明。检查结果包括：面部绑定检测到的 `RigConvention` 及其检测置信度、是否找到面部网格，以及是否存在 `Head`, `LeftEye`和 `RightEye` 已解决的骨骼。可自动修复的问题旁边会显示一个修复按钮，例如 **立即设置 Rig** 或 **添加 Convai 角色**.

一个 **设置此角色** 按钮位于此部分底部，点击后会添加一个 `StandardRigBinding` 组件（如果角色尚未添加该组件），然后重新构建角色。

#### 功能

“ `Features` ”部分会列出项目中注册的所有具身模块—— `Conversation Flow`, `Gaze`, `Body Animation`, `Body Language`和 `Emotion` ——每个模块占一行。每行会显示模块的显示名称，以及用于指示角色上是否存在该模块控制器组件的状态标记：

* **存在** ——该行会显示一个 **选择** 按钮，点击后会在 Inspector 中选中该组件。
* **缺失** ——该行会显示一个 **添加** 按钮，点击后会将该模块的控制器组件添加到角色上。

### 预设选项卡

“ `Presets` ”选项卡（提示文本：“此项目中的预设资源及其有效性。”）打开后会显示一个信息框：“预设为可选项 — 预设会一次性为每项功能提供一组设置。每项功能也都可以独立使用，因此预设并非必需。”

下方会列出项目中找到的所有 `ConvaiEmbodimentPreset` 资源。如果没有找到任何资源，选项卡会显示“此项目中没有预设。”以及一个 **创建预设** 按钮，点击后会打开保存对话框，以创建新的预设资源。

每个列出的预设都会显示一个状态标签，采用与“ `Setup` ”选项卡的“ `Rig` ”部分相同的三个状态词（`Ready`, `Needs Attention`, `Not Set Up`）。系统会检查预设中的槽位来计算状态：模块 ID 重复、没有匹配已安装功能的槽位、指向错误配置文件类型的槽位；此外，如果窗口当前也在追踪某个角色，还会检查该角色上存在但预设中缺失的功能，以及预设中指定但角色上不存在的功能。选择任一行中的 **打开** 会选中该预设资源，以便在 Inspector 中查看完整诊断信息和槽位列表。

### 实时选项卡

“ `实时` 选项卡（提示：“角色在播放模式下当前正在做什么。”）仅在 Unity 编辑器处于播放模式时报告状态。

| 条件                                            | 选项卡显示的内容                                    |
| --------------------------------------------- | ------------------------------------------- |
| 不在播放模式下                                       | “进入播放模式以查看角色的实时状态。”                         |
| 处于播放模式，但没有运行中的角色 `EmbodimentContext` 已为所选角色解析 | “未选择运行中的角色 — 选择一个正在运行的 Convai 角色，以查看其当前行为。” |
| 处于播放模式，且已解析角色                                 | 下方的 `Conversation` 和 `Emotion` 部分。          |

#### 对话

如果角色没有 Conversation Flow 模块，此部分会显示“该角色未启用 Conversation Flow。”否则，此部分会读取模块当前的 `DialogueStateReading` 并显示：

* **状态** — 当前的 `DialogueState` 值。
* **过渡至** — 角色正在过渡至的状态。
* 显示两个状态之间混合权重的进度条。
* **状态持续时间** — 处于当前状态的秒数。
* **能量** — 当前能量级别。

#### 情绪

如果角色没有 Emotion 模块，此部分会显示“该角色未启用 Emotion。”如果存在该模块，但尚未检测到任何内容，则会显示“尚未检测到情绪。”否则，此部分最多显示五个情绪标签，并以进度条呈现，按强度从高到低排列；每个标签都显示情绪名称及其分数。

实时 `选项卡` 在其处于活动状态且编辑器处于播放模式时，会自动每秒刷新约十次。

### 后续步骤

{% content-ref url="/pages/dddb9a87015e6befbe3c15caf6aa6b2df224fa33" %}
[角色骨架设置](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/character-rig-setup.md)
{% endcontent-ref %}

{% content-ref url="/pages/260c8f480c6e05ba6ea9db729322298e970606cc" %}
[具身化预设](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/embodiment-presets.md)
{% endcontent-ref %}

{% content-ref url="/pages/5027f813885b08acbe9044a4bb7b9166e9b01bc2" %}
[排查具身化问题](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/troubleshooting.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 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/embodiment-editor.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.
