> 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/setup/import-and-run-sample-scenes.md).

# 导入并运行示例场景

## 简介

示例场景是端到端验证您的安装和 API 设置的最快方式。

## 前提条件

* Convai SDK 已安装
* API 密钥配置成功

## 分步说明

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

在 Unity 中，前往 **Window → Package Manager**.
{% endstep %}

{% step %}
**找到 Convai 包**

* 选择 **在 Project 中** （左侧面板）。
* 点击 **Convai SDK** （或已安装的 Convai 包）。
  {% endstep %}

{% step %}
**导入示例**

* 打开 **Samples** 包详情中的部分。
* 点击 **导入** 位于某个示例旁边（例如： `<SAMPLE_NAME>`).
* **预期结果：** 一个 **Samples** 文件夹会出现在 **Assets**，其中包含导入的示例内容。
  {% endstep %}

{% step %}
**打开示例场景**

* 导航到：
  * `Assets/Samples/Convai SDK for Unity/x.x.x/<SAMPLE_NAME>/Scenes`
* 打开场景：
  * `<SCENE_NAME>`
    {% endstep %}

{% step %}
**运行对话测试**

* 点击 **Play**.
* 使用麦克风说话 **或** 或在 Chat UI 输入框中输入。
* **预期结果：** 角色会回应。麦克风对话是 **免手持的** （无需按住说话）。
  {% endstep %}
  {% endstepper %}

## 故障排查

* **导入后示例未显示**
  * 确认您已导入示例，并检查 **Assets/Samples** 文件夹。
* **未检测到语音输入**
  * 检查操作系统中 Unity 的麦克风权限。
  * 确认已选择正确的麦克风设备。
* **角色没有回应**
  * 确认 API 密钥已设置且有效。
  * 检查 Console 中的身份验证/网络错误。

## 结论

您已成功导入示例场景并验证了可用的对话。接下来，您可以通过以下方式将 Convai 集成到您自己的场景中： **自定义场景设置**.

{% 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/setup/import-and-run-sample-scenes.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.