通过

从新项目开始

由于 MRTK3 是一系列松散耦合的包，因此使用 MRTK3 的方式与使用 MRTK 2.x 的方式不同。 我们不会将 MRTK 作为 Unity 项目交付，因此你需要手动将 MRTK3 包添加到项目才能使用它们。

你应该不会使用每个 MRTK 包。 请查看哪些功能对你有用，并仅添加相关的依赖项。

使用 MRTK3 设置新的 Unity 项目

1. 创建新的 Unity 项目

使用 Unity 2021.3.21f1 或更高版本创建新的 Unity 项目。 在继续执行下一步之前关闭该 Unity 项目。

2. 使用混合现实功能工具导入所需的依赖项和 MRTK3 包

MRTK3 使用的一些包不属于此工具包。 若要获得这些包，请使用 Mixed Reality Feature Tool 并在“发现功能”步骤中选择以下最新版本。

  • 平台支持 → 混合现实 OpenXR 插件
  • 空间音频 → Microsoft Spatializer（可选）

对于 MRTK3 包，强烈建议使用以下两个包来帮助快速入门：

  • MRTK3 → MRTK 输入（此设置需要）
  • MRTK3 → MRTK UX 组件

这两个包及其依赖项（由功能工具自动添加）将使你能够探索我们的大部分 UX 产品/服务，并创建准备好部署到各种 XR 设备的项目。 你之后随时可以返回功能工具，并向项目添加更多包。

请务必选择 org.mixedrealitytoolkit.* 包，而不要选择已弃用的包。 com.microsoft.mrtk.* 包已弃用，不再受支持。

Selecting the default MRTK3 packages in Microsoft's Mixed Reality Feature Tool

注意

有关 MRTK3 包的详细信息，请参阅包概述页。

选择完包后，单击“获取功能”，然后按照混合现实功能工具中的说明进行操作，将所选包导入 Unity 项目中。

3. 打开 Unity 项目

打开 Unity 项目，等待 Unity 完成导入新添加的包。 在此过程中，可能会出现两条弹出窗口消息：

  1. 第一条消息是询问是否要启用新的输入后端。 选择“是”。
  2. 第二条消息是询问是否要更新 XR InteractionLayerMask。 选择“不用了，谢谢”。

Unity 可能会在此过程期间重启几次，请等待它完成，然后再继续。

4. 在导入后配置 MRTK 配置文件

导入后，MRTK3 需要你为独立目标平台和每个其他目标平台设置配置文件。

  1. 导航到“编辑”>“项目设置”。

  2. 在“项目设置”下导航到“MRTK3”，然后切换到“独立”选项卡。请注意，配置文件最初未指定。

  3. 使用核心包随附的默认 MRTK 配置文件填充该字段。 可以在项目窗口的搜索栏中键入关键字“MRTKprofile”；请确保在 All 中进行搜索。 或者，可以在 Packages/org.mixedrealitytoolkit.core/Configuration/Default Profiles/MRTKProfile.asset 下查找该配置文件。

    注意

    并非所有 MRTK 子系统都显示在下面的屏幕截图中。 你看到的 MRTK 子系统可能有所不同，具体取决于已添加到项目的 MRTK3 包。

    assign the default MRTK profile

  4. 切换到要使用的其他生成目标（例如 UWP、Android）的选项卡并检查是否分配了配置文件。 如果未分配，请在当前选项卡上重复上一步。

如果面向的是 XR 设备（如 HoloLens 2 或 Quest），则在导入后，MRTK3 需要你在 OpenXR 上执行一些配置。

注意

以下说明适用于 HoloLens 2 或 WMR 头戴显示设备。 如果面向的是 Quest，请参阅 Quest 部署页上的说明。

  1. 导航到“编辑”>“项目设置”。

  2. 在“项目设置”下，导航到“XR 插件管理”并在“独立”和“UWP”选项卡下启用“OpenXR”。 在每个选项卡下确保已选中“在启动时初始化 XR”，并确保启用“独立”选项卡下的“Windows Mixed Reality 功能组”和“UWP”选项卡下的“Microsoft HoloLens 功能组”。

    注意

    选中“OpenXR”选项后，可能会出现黄色警告图标。 单击该图标可打开“OpenXR 项目验证”工具。 单击“全部修复”并忽略无法自动修复的交互配置文件问题。 将在以下步骤中添加配置文件。

    对于“独立”：

    Standalone XR Plug-in Management window

    对于“UWP”：

    UWP XR Plug-in Management window

  3. 在“项目设置”下，导航至“XR 插件管理”>“OpenXR”>“交互配置文件”，并为“UWP”和“独立”添加以下三个配置文件：

    • 眼睛注视交互配置文件
    • Microsoft 手势交互配置文件
    • Microsoft 运动控制器配置文件

    注意

    可能需要使用“OpenXR 项目验证”工具来消除黄色三角形。 可以手动解决某些警告：
    1.在“项目设置”下，导航到“播放器”>“分辨率和呈现”。 确保取消选中“在后台运行”。
    2.对于 UWP，请在“播放器”>“发布设置”>“功能”下，确保选中“网络摄像头”、“麦克风”、“SpatialPerception”和“GazeInput”（如果应用程序需要这些功能）。 有关 Window 应用功能的详细信息，请参阅应用功能声明。

    对于“独立”：

    Standalone OpenXR

    对于“UWP”：

    UWP OpenXR

  4. 对于 HoloLens 2，建议在上述设置中将“深度提交模式”设置为 16 位。

  5. 对于沉浸式头戴显示设备，可以使用 24 位深度提交。 有关详细信息，请参阅适用于 Unity 的 Microsoft 开发文档。

6.恭喜，项目设置现已完成

继续创建新的 MRTK3 场景。

后续步骤

完成 Unity 项目设置后，了解如何在设备上体应用程序