> 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/具身编辑器` 包含三个选项卡的窗口： `设置`, `预设`，以及 `Live`。其副标题为“设置角色的注视、情绪和身体。”可用于检查角色的骨骼绑定和模块是否正确配置，查看项目中的每一个 `ConvaiEmbodimentPreset` 在项目中，并在播放模式下观察正在运行的角色的对话和情绪状态。

### 打开窗口

选择 **Convai > 具身编辑器** 以打开该窗口。

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

在角色选择器下方，三个选项卡依次为： `设置`, `预设`, `Live`.

### 设置选项卡

该 `设置` 选项卡（提示：“让此角色的表现特征正常工作。”）为所选角色显示两个部分。

#### 骨骼绑定

该 `骨骼绑定` 部分标题会显示三个状态词之一，取自该角色报告中的最严重发现：

| 标题状态    | 含义                                               |
| ------- | ------------------------------------------------ |
| `Ready` | 未发现任何问题。                                         |
| `需要注意`  | 角色仍可工作，但效果不够理想——例如，面部骨骼绑定检测的置信度较低。               |
| `未设置`   | 在列出的问题修复之前，角色不会正确表现——例如，没有 `ConvaiCharacter` 组件。 |

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

某个 **设置此角色** 部分底部的按钮会添加一个 `StandardRigBinding` 组件（如果该角色尚未拥有），然后重建它。

#### 功能

该 `功能` 部分列出项目中注册的每个具身模块—— `对话流程`, `注视`, `身体动画`, `肢体语言`，以及 `情绪` ——每个模块一行。每行显示模块的显示名称，以及该模块的控制器组件是否存在于该角色上的状态指示：

* **已存在** ——该行会显示一个 **选择** 按钮，用于在检查器中选中该组件。
* **缺失** ——该行会显示一个 **添加** 按钮，用于将该模块的控制器组件添加到角色中。

### 预设选项卡

该 `预设` 选项卡（提示：“此项目中的预设资源及其是否有效。”）打开时会显示一个信息框：“预设是可选的——预设会一次性把一组设置交给每个功能。每个功能也可以独立工作，因此预设是可选的。”

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

每个列出的预设都会显示一个状态标签，使用与 `设置` 选项卡的 `骨骼绑定` 部分（`Ready`, `需要注意`, `未设置`）相同的三词词汇，其计算方式是检查预设的槽位：重复的模块 ID、未安装匹配功能的槽位、指向错误配置文件类型的槽位，以及——当窗口也在跟踪某个角色时——该角色上存在但预设中缺失的功能，或者槽位命名了该角色没有的功能。选择 **打开** 任意行可选中该预设资源，使其完整诊断和槽位列表在检查器中可见。

### 实时选项卡

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

| 条件                                      | 选项卡显示内容                                      |
| --------------------------------------- | -------------------------------------------- |
| 不在播放模式                                  | “进入播放模式以查看角色的实时状态。”                          |
| 在播放模式下，未运行 `EmbodimentContext` 已为所选角色解析 | “未选择正在运行的角色——请选择一个正在运行的 Convai 角色以查看其正在做什么。” |
| 在播放模式下，已解析出一个角色                         | 该 `对话` 和 `情绪` 部分如下。                          |

#### 对话

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

* **State** ——当前的 `DialogueState` 值。
* **过渡到** ——角色正在过渡到的状态。
* 一个带有两个状态之间混合权重标签的进度条。
* **状态持续时间** ——在当前状态中已花费的秒数。
* **能量** ——当前能量水平。

#### 情绪

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

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

### 下一步

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

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

{% content-ref url="/pages/5027f813885b08acbe9044a4bb7b9166e9b01bc2" %}
[排查具身化问题](/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 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/embodiment-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.