【MR开发】在Pico设备上接入MRTK3（一）——在Unity工程中导入MRTK3依赖

写在前面的话

在Pico上接入MRTK3，目前已有大佬开源。

https://github.com/Phantomxm2021/PicoMRTK3

也有值得推荐的文章。
MRTK3在PICO4上的使用小结

但由于在MacOS上使用MRTK3，无法通过Mixed Reality Feature Tool工具管理MRTK3安装包。
故记录一下完整的流程，仅作备忘。

开发环境
Unity编辑器：2022.3.49
Pico SDK：v3.0.0
MRTK3：MixedRealityToolkit-Unity的release-2024-08-29分支

---

MRTK3简介

MRTK3 是 Unity 的第三代 Microsoft 混合现实工具包。 它是 Microsoft 驱动的开源项目，旨在加速 Unity 中的跨平台混合现实开发。 此新版本建立在 Unity 的 XR 管理系统和 XR 交互工具包基础之上。 以下是它的一些功能：

为空间交互和 UI 提供跨平台输入系统和构建基块。
通过编辑器内模拟实现快速原型制作，让你能够立即看到变化。
作为可扩展的框架运行，使开发人员能够交换出核心组件。

MR工具包：MRTK3

在Unity工程中导入MRTK3

以下几种方式选择一种即可，我们需要在Unity中导入以下MRTK的依赖（speech相关依赖若不使用可以不导入）

方式1: 使用MR Feature Tool安装MRTK

在Windows系统上，可以通过使用混合现实功能工具导入MRTK3包体至Unity工程，工具下载地址：Mixed Reality Feature Tool

打开工具，选择Unity工程目录，勾选MRTK3，直接安装即可。

方式2: 使用源码的形式进行安装

由于当前使用的mac电脑，无法使用MRFeature Tool工具。

1. 从git上down下源码，git仓库：MixedRealityToolkit-Unity
   这里我选择的是较新的release分支。
   

2. 打开文件夹，查看MRTK相关依赖。（这里选中了14个依赖，在后续的步骤中我们需要将其导入到Unity工程）
   

3. 在unity中通过“Package Manager”导入这14个依赖

4. 添加“com.microsoft.mrtk.graphicstools.unity”依赖（重要）
   在’unity工程目录/Packages/manifest.json’文件中添加‘graphicstools’依赖。

    "com.microsoft.mrtk.graphicstools.unity": "https://github.com/microsoft/MixedReality-GraphicsTools-Unity.git?path=/com.microsoft.mrtk.graphicstools.unity#v0.6.6",

若没有导入graphicstools，则会有以下报错提示。

方式3: 使用整合包

整合包资源下载地址：MRTK3整合包下载链接

1. 下载资源包，解压
2. 将其拷贝至Unity工程目录
   

此外，这里需要注意检查manifest.json文件中是否引入了“com.microsoft.mrtk.graphicstools.unity”依赖

问题汇总

1. graphicstools导入失败

解决方式：请检查VPN代理或是直接通过git下载到本地后，再通过“PackageManager”导入。

2.MRTK某个依赖导入失败

解决方式：检查这个依赖的前置依赖是否导入成功。（例如，下图中的问题就是由于graphicstools未导入成功导致的。）

---

后续步骤请点击下列链接查看

---

• 【MR开发】在Pico设备上接入MRTK3（二）在Unity中配置Pico SDK
• 【MR开发】在Pico设备上接入MRTK3（三）在Unity中运行MRTK示例

---