> 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/unity-plugin-beta-overview/getting-started/installation/install-via-unity-asset-store.md).

# 通过 Unity Asset Store 安装

## 简介

如果你的团队更偏好 Unity 商店分发和标准的“我的资源”工作流，那么从 Asset Store 安装是理想选择。

## 先决条件

* 已登录到 Asset Store 的 Unity ID
* Convai 包已添加到你的账户

## Convai Unity Asset Store 页面

<https://assetstore.unity.com/packages/tools/behavior-ai/npc-ai-engine-dialog-actions-voice-and-lipsync-convai-235621>

## 分步骤

{% stepper %}
{% step %}
**将该包添加到你的 Unity 账户**

* 打开 Convai Asset Store 页面。
* 单击 **添加到我的资源**.

<figure><img src="/files/33471e60ccce4238d77e0c47c35f9a2cea579361" alt=""><figcaption></figcaption></figure>

* 如果出现提示，请登录你的 Unity 账户。
* **预期结果：** 该资源已添加到你的“我的资源”中。
  {% endstep %}

{% step %}
**打开 Package Manager**

在 Unity 中，前往 **窗口 → 包管理器**.
{% endstep %}

{% step %}
**下载并导入（两个选项）**

**选项 A — “在 Unity 中打开”**

* 如果在 Asset Store 页面上可用，请点击 **在 Unity 中打开**.
* Unity 会打开包管理器并显示该资源页面。

<figure><img src="/files/c281feb5710703711b4c267b55b92fb38fabf555" alt=""><figcaption></figcaption></figure>

**选项 B — 通过“我的资源”**

* 在包管理器中，打开 **My Assets**.
* 搜索 **Convai**，然后选择它。
  {% endstep %}

{% step %}
**先下载，然后导入**

* 单击 **下载**.
* 完成后，点击 **导入**.

<figure><img src="/files/71463332abb288e1e13c964abce9c2b2ffb0b5ca" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**验证安装**

* 检查 **控制台** 中的错误。
* **预期结果：** 控制台中没有错误，并且 **Convai** 菜单会出现在顶部工具栏中。
  {% endstep %}
  {% endstepper %}

## 故障排查

* **Convai 没有出现在“我的资源”中**
  * 确认你已登录到正确的 Unity 账户。
  * 确认该资源已在商店页面上添加到“我的资源”。
* **导入已完成，但缺少 Convai 菜单**
  * 重新启动 Unity，并再次检查控制台中的错误。

## 结论

你已通过 Asset Store 安装了 SDK，并确认编辑器已成功编译。接下来，前往 **设置 → 配置 API 密钥**.

{% hint style="info" %}
**需要帮助？** 如有疑问，请访问 [**Convai 开发者论坛**](https://forum.convai.com/).
{% endhint %}


---

# 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/unity-plugin-beta-overview/getting-started/installation/install-via-unity-asset-store.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.