> 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/building-for-supported-platforms/convai-xr/building-for-mr.md).

# 为 MR 构建

## 将 Convai 与 MR 集成：快速且灵活的设置选项

{% embed url="<https://youtu.be/rfd_OPiKLh8>" %}
能够感知并参与混合现实场景的沉浸式 AI 角色 | Convai Unity 教程
{% endembed %}

为混合现实（MR）设置 Convai 比你想象的更简单。只需点击几下，你就可以将 Convai 直接集成到你的 MR 项目中。

为了给用户提供灵活性和自定义选项，我们提供 **两种安装方式**:

* **自动安装**
* **手动安装**

### **自动安装**

如果你正在开始一个新项目，并且想避免处理 MR 包或额外的设置要求，那么自动安装方式是理想之选。该方式会从一开始就为你提供一个已完整集成 Convai 的 MR 项目，包括 **Convai MR 演示场景** ，以便快速测试和探索。这种方法尤其适合初学者。

{% hint style="warning" %}
**注意：** 此安装方式将修改 Unity 项目设置。这些更改对于确保与 Convai 兼容是必要的。
{% endhint %}

### **手动安装**

手动安装方式适用于现有的 MR 项目。使用这种方式，你可以完全掌控设置，因为 **不会修改项目设置，不会添加演示场景，也不会应用任何自定义项**。只会集成 Convai 的 XR Unity 包，这让你可以自由使用任何 MR SDK，不受限制。

## 选择你的安装方式

请选择两种安装方式中的一种，然后点击下面对应的设置部分，按照说明进行操作。

{% content-ref url="/pages/45119ed4a52f145109438eb19ab4f7c2d64b67ab" %}
[MR 自动安装](/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin/building-for-supported-platforms/convai-xr/building-for-mr/mr-automatic-installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/9a721e5b8198ebb92cf616b563fe7bed05e09187" %}
[MR 手动安装](/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin/building-for-supported-platforms/convai-xr/building-for-mr/mr-manual-installation.md)
{% endcontent-ref %}

## Convai 控制器方案

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


---

# 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/building-for-supported-platforms/convai-xr/building-for-mr.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.