> 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/other-integrations/omniverse-extension.md).

# Omniverse 扩展

{% embed url="<https://www.youtube.com/playlist?list=PLn_7tCx0ChiqbU3J3JPIKagfiv6S3wK7i>" %}
扩展概览
{% endembed %}

### 安装

要安装 Convai Omniverse 扩展，请按以下步骤操作：

1. 下载 [最新版本](https://github.com/Conv-AI/ov_extension/archive/refs/tags/1.0.3.zip) 的扩展。
2. 将 zip 文件解压到你选择的目录中。
3. 打开你选择的 Omniverse 应用（例如 Code），然后在 `窗口` 菜单中点击 `扩展`.
4. 在 `扩展` 选项卡，点击右上角的齿轮图标。\
   ![](/files/c9f6900f4c402e8df7fc9ceef410009a2649ab0a)
5. 点击 Edit 列中的绿色加号图标，并添加到以下位置的绝对路径： `exts` 文件夹，该文件夹位于仓库目录中。<br>

   <figure><img src="/files/d5e9f3288d1f247c119e3123284f3ef520302e2f" alt=""><figcaption></figcaption></figure>
6. 选择 `第三方` 选项卡并搜索 `Convai` 在左上角搜索栏中，确保勾选 Enabled。<br>

   <figure><img src="/files/ba11a6a79179d1cba9113540b044631f8431e45a" alt=""><figcaption></figcaption></figure>
7. Convai 窗口应该会出现，拖动并将其停靠到 UI 的任意合适区域。
8. 如果 Convai 窗口没有出现，请转到 `窗口` 菜单并选择 `Convai` 从列表中选择。

## 配置

要添加你的 API Key 和 Character ID，请按以下步骤操作：

1. 在以下网站注册： [Convai](https://convai.com/).
2. 在网站上，点击 playground 右上角的齿轮图标，然后将 API key 复制并粘贴到 Convai 扩展窗口中的 `Convai API 密钥` 字段中。
3. 前往 [仪表板](https://convai.com/pipeline/dashboard) 并在左侧面板中创建一个新角色，或者选择一个示例角色。
4. 复制 Character ID 并将其粘贴到 `角色 ID` 扩展窗口中的字段中。

## 与角色交互

1. 单击 `开始说话` 以开始对话
2. 单击 `Stop` 说完后等待角色回应。

### 运行演示

1. 打开你选择的 Omniverse 应用（例如 Code）。
2. 前往 `文件->打开` 并导航到仓库目录。
3. 导航到 `<repo directory>/ConvaiDemoStage/ConvaiDemo.usd` 然后点击 \`打开它。
4. 点击 `播放` 按钮，从 `工具栏` 左侧菜单。\
   ![](/files/72a52e9b3e06dc97666a584588496e2c54491ff3)
5. 单击 `开始说话` 在 `Convai` 窗口与角色对话，然后点击 `Stop` 发送请求。

## 动作

动作可用于触发与以下内容中同名的事件： `动作图`。它们可用于根据收到的动作运行动画。要试用动作：

1. 向以下字段添加几个以逗号分隔的动作： `以逗号分隔的动作` 字段（例如 jump、kick、dance 等）。
2. 角色会根据对话选择其中一个动作，并在以下位置运行与该动作同名的任何事件： `动作图`.

### 说明

* 演示场景仅包含对话和待机动画。不过，可以添加更多动画，并使用角色选择的动作来触发它们。更多内容将在未来介绍。


---

# 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/other-integrations/omniverse-extension.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.