> 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/mr-automatic-installation.md).

# MR 自动安装

## 自动安装步骤

{% hint style="success" %}
自动安装方法非常适合刚开始新项目、希望获得直接明了设置的用户。它从一开始就提供一个完全集成的 Convai MR 项目，确保更顺畅的开发体验。
{% endhint %}

### 步骤 1

在顶部菜单中，点击 **Convai**。然后，选择 **自定义包安装程序**.

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

### 步骤 2

在出现的 Convai 面板中，点击 **包管理** 然后选择 **安装 MR 包**.

<figure><img src="/files/4031d311a9ac056f746101605657c1fd5b13954a" alt=""><figcaption></figcaption></figure>

### 步骤 3

将会出现一个新窗口，提示您选择安装类型。对于本说明文档，我们将继续使用 **自动安装**.

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

### 步骤 4

在下一个窗口中，请仔细阅读设置说明、警告以及将要应用的更改详情。

### 步骤 5

准备继续时，点击 **是，继续**.

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

### 第 6 步

安装过程将开始，大约需要 5 分钟。具体时长可能会因您的计算机性能而有所不同。

<figure><img src="/files/8b4dc34a852e3dfe013f2e9cf0c4056095868d3b" alt=""><figcaption></figcaption></figure>

### 第 7 步

如果出现标题为 **检测到 OVRPlugin** 的 MetaSDK 提示，请点击 **重启编辑器** 以继续。

<figure><img src="/files/2d79734477b80bb30ad74d1960e7a43adcf41f1f" alt=""><figcaption></figcaption></figure>

### 第 8 步

安装完成后，就可以打开演示场景了。

* 导航到 **资源 > Convai > ConvaiXR > ConvaiMR > 场景** 并打开 **Convai 演示 - MR**.

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

### 第 9 步

如果您没有 **TextMeshPro** 包已安装，您需要它才能在演示场景中正确显示文本。要安装它：

* 前往 **窗口 > TextMeshPro > 导入 TMP 必需资源**.

<figure><img src="/files/2a568babecbbc62b75d8cfabcedf27b24b47f27e" alt="" width="563"><figcaption></figcaption></figure>

* 在 **Unity 包导入** 出现的窗口中，点击 **导入**.

<figure><img src="/files/a60f668943fa85c31117cf913a870f6d194f50d5" alt="" width="375"><figcaption></figcaption></figure>

### **步骤 10**

现在一切都已设置完成！ :tada::sunglasses:

您可以通过以下路径构建项目： **文件 > 构建设置**.

## 替换生成的角色

### 步骤 1

在演示场景中，选择 **\[BuildingBlock] 查找生成位置** 在层级中。

### 步骤 2

在 **生成对象** 字段，将你导入到项目中的角色拖放进去。

* 如果你不确定如何导入你的角色，请参考相关文档 [这里](/api-docs/zh/cha-jian-yu-ji-cheng/unity-plugin/unity-importing-ready-player-me-rpm-characters.md).

<figure><img src="/files/10898dbd4e58baae2727a0b8ccffa1bbc4bf0711" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
此演示场景默认使用 **MetaSDK** 。不过，由于没有限制，你也可以使用其他方法或 SDK 来生成你的角色。
{% 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/building-for-supported-platforms/convai-xr/building-for-mr/mr-automatic-installation.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.