使用 MRTK 设置新的 OpenXR 项目

author
0 minutes, 50 seconds Read

本文内容

设置混合现实 Unity 项目的最简单方法是使用混合现实工具包 (MRTK)。 MRTK for Unity 是一款开源、跨平台开发工具包,旨在简化构建出色的混合现实应用程序。

显示混合现实工具包的一些功能的信息图。/

MRTK 提供跨平台输入系统、基础设施组件和用于空间交互的通用构建块。 它可以帮助您加速 Microsoft HoloLens、Windows 混合现实沉浸式 (VR) 耳机以及许多其他 VR/AR 设备的应用程序开发。 该项目旨在降低进入门槛,让每个人都可以构建混合现实应用程序,并在我们共同成长的过程中回馈社区。

MRTK支持多种平台,包括:

注意

我们最近推出了第三代 Microsoft Mixed Reality Toolkit for Unity MRTK3,它基于 Unity 的 XR 管理系统和 XR 交互工具包构建,可以更好地支持各种 OpenXR 兼容设备和新的设计语言。 有关详细信息,请参阅 MRTK3 文档。

注意

也可以在没有 MRTK 的情况下建立一个新的 OpenXR 项目。

其他需要考虑的非 OpenXR 配置选项

Windows XR:Microsoft 不建议在 Unity 2020 中的任何新项目中使用 Windows XR 插件。而是使用混合现实 OpenXR 插件。 但是,如果您使用的是 Unity 2019 并要求 AR Foundation 2.0 与 ARCore/ARKit 设备兼容,则可以使用此插件来启用该支持。

重要的

在 Unity 2019 中使用此插件与 Azure 空间锚点不兼容。

旧版XR:

如果您仍在使用“Unity 2019”或更早版本,Microsoft 建议您使用“旧版内置 XR 支持”。 虽然 Windows XR 插件在 Unity 2019 上运行良好,但我们不建议使用它,因为它与 Unity 2019 上的 Azure 空间锚点不兼容。

如果您要开始新项目,建议安装 Unity 2020 并使用混合现实 OpenXR 插件。

OpenXR 入门:创建新的 Unity 项目

启动 Unity 中心。

在“项目”选项卡中,单击“新建项目”。

“项目”选项卡中

单击“新建项目”下方的下拉列表,然后选择您需要的编辑器版本。

显示了编辑器版本下拉列表的

确保所选模板是 3D Core。

在“项目名称”框中,输入项目的名称,例如“MRTK 教程”。

在“位置”框中,单击文件夹图标,然后导航到要保存项目的文件夹并选择它。 您还可以创建一个新文件夹。

突出显示了“3D”、“项目名称”、“位置”和“创建”的

单击“创建项目”。 这将在 Unity 中打开该项目。

在

注意

在 Windows 上创建项目时,MAX_PATH 限制为 255 个字符。 Unity 受到这些限制的影响; 如果任何文件路径超过 255 个字符,则可能无法编译。 因此,建议将 Unity 项目存储在尽可能靠近驱动器根目录的位置。

设定构建目标

在菜单栏上,选择“文件”>“构建设置…”。

要构建适用于 Windows Mixed Reality 的应用程序,您必须选择构建目标。 通用 Windows 平台(UWP 的构建设置)面向任何设备,包括 HP Reverb G2 等沉浸式耳机。 如果您正在为 HoloLens 2 进行构建,这是最好的选择; 但是,如果您的目标是桌面 VR,我们建议您使用 PC、Mac 和 Linux 独立平台。

执行以下操作之一:

如果针对桌面 VR:

Unity

如果定位 HoloLens 2:

构建类型:D3D 项目

目标 SDK 版本:安装的最新版本

最低平台版本:10.0.10240.0

Visual Studio 版本:安装的最新版本

Unity

单击“切换平台”按钮。 Unity 在切换平台时显示进度条。

切换平台过程完成后,关闭“构建设置”窗口。

下载并安装混合现实工具

混合现实 OpenXR 插件作为 Unity 包提供。 发现、更新和导入功能包的最佳方法是使用混合现实功能工具。 您可以按名称或类别搜索包、查看其依赖项,并在导入之前查看对项目清单文件的建议更改。

从 Microsoft 下载中心下载最新版本的混合现实功能工具。

下载完成后,导航到可执行文件 MixedRealityFeatureTool.exe 并使用它启动混合现实功能工具。

打开

导入混合现实工具包和 OpenXR 包

在混合现实功能工具中,选择启动。

混合现实功能工具打开屏幕的屏幕截图。/

选择“浏览”按钮(下图中的“三个点”按钮),导航到您的项目并将其打开。

打开项目/

注意

工具中的“项目路径”框必须包含一个值,因此默认情况下它将插入一个反斜杠(“_”)。

选择文件夹后,该工具会检查以确保它是有效的 Unity 项目文件夹。

混合现实功能工具项目路径屏幕的屏幕截图。/

选择“发现功能”。

注意:该工具刷新源中的包时,您可能需要等待几秒钟。

在“发现功能”页面上,请注意有 6 个软件包组的列表。

混合现实功能工具中的包的主要组。/

单击 Mixed Reality Toolkit (0/10) 左侧的 + 按钮,然后选择最新版本的 Mixed Reality Toolkit Basic。

注意

“混合现实工具包基础知识”包是在项目中使用 MRTK 之前必须导入和配置的唯一包。 该软件包包含创建混合现实应用程序所需的核心组件。

点击“平台支持(0/5)”左侧的“+”按钮,选择最新版本的“混合现实OpenXR插件”。

混合现实功能工具中选择包的屏幕截图。/

做出选择后,单击“获取功能”。

选择“验证”以验证所选包。 您应该会看到一个对话框,其中显示“未检测到验证问题”。 完成后,单击“确定”。

在“导入功能”页面上,左栏中的“功能”将显示您刚刚选择的包。 右栏中的“必需的依赖项”显示了所有依赖项。 您可以单击其中任何项目的“详细信息”链接以获取更多信息。

当您准备好继续时,选择“导入”。 在审核和批准页面,您可以查看有关包的信息。

选择批准。

返回 Unity 编辑器并单击 UI 中的空白区域。 您将看到一个进度条,通知您正在导入您的包。

配置输入后端设置

Unity导入包后,会出现警告,询问是否需要重新启动编辑器来启用后端。 选择“是”。

Unity

通过项目验证为 HoloLens 2 配置项目 (MR OpenXR 1.6+)

如果您正在开发桌面 VR,请跳过本节并转到 。

在菜单栏上,单击“混合现实”>“项目”>“应用 HoloLens 2 的推荐项目设置”,并为 HoloLens 2 启用验证规则。在弹出的项目验证窗口中,确保您位于“UWP 平台”选项卡(Windows 徽标)上:指导,然后单击全部修复以解决验证问题。 请注意,单击全部修复后可能会出现问题。 在这种情况下,请尝试再次单击“全部修复”,忽略标记为“特定于场景”的任何问题(如果有),然后浏览其余问题(如果有)以查看是否有任何建议的更改。 至此,该项目已基本准备好进行 HoloLens 2 部署。“继续下一步。” 手动配置 HoloLens 2 项目

如果您正在开发桌面 VR,请跳过本节并转到 。

确保“项目设置”窗口已打开。 如果没有,请选择菜单栏上的“编辑”>“项目设置”。

在“项目设置”窗口中,确保您位于“XR 插件管理”页面和“通用 Windows 平台”选项卡上。

“项目设置”窗口中打开“XR

确保选中“启动时初始化 XR”,然后在“插件提供程序”下单击“打开 XR”。

通用

加载OpenXR插件,OpenXR下方会显示多个项目。 选择“Microsoft HoloLens 功能组”。

项目设置窗口的屏幕截图,其中突出显示了

请注意,OpenXR 旁边有一个黄色警告三角形。 这表明存在需要解决的不兼容设置。 要了解如何解决此问题,请跳过有关 VR 配置的下一部分,然后继续下一部分。

配置桌面 VR 项目

确保“项目设置”窗口已打开。 如果没有,请转到菜单栏并选择“编辑 > 项目设置”。

在“项目设置”窗口中,确保您位于“XR 插件管理”页面和计算机的“Mac 和 Linux 独立”选项卡上。

“项目设置”窗口的屏幕截图,其中打开了“XR

确保选中“启动时初始化 XR”,然后在“插件提供程序”下单击“打开 XR”。

“项目设置”窗口的屏幕截图,位于电脑内的

加载OpenXR插件,“OpenXR”下会出现两个项目。 选择第一个,Windows Mixed Reality 功能组。

“项目设置”窗口的屏幕截图,其中突出显示了

请注意,OpenXR 旁边现在有一个黄色警告三角形。 这表明存在需要解决的不兼容设置。 要了解如何解决此问题,请继续阅读下一部分。

解决不兼容的设置

重要的

本部分中的图像显示通用 Windows 平台选项卡上的选项。 但是,除非另有说明,否则桌面 VR 选项卡的说明是相同的。

将光标悬停在 OpenXR 旁边的黄色警告三角形上,阅读弹出窗口中的消息,然后选择该三角形。

关于不兼容设置的警告的屏幕截图。/

在 OpenXR 项目验证窗口中,列出了几个问题。 选择“全部修复”按钮。 注意:此列表可能看起来有所不同,具体取决于您所在的选项卡。

“OpenXR

问题仍然存在,并告诉您必须添加至少一个交互配置文件。 为此,请单击“编辑”。 这将带您进入“项目设置”窗口中“OpenXR”插件的设置。

显示了

在交互配置文件下,注意加号 (+) 按钮。

“添加交互配置文件”按钮的屏幕截图。/

单击该按钮三次,每次选择不同的配置文件:

眼睛注视交互配置文件

Microsoft 手势交互配置文件

微软运动控制器简介

应该添加的交互配置文件的屏幕截图。/

如果眼睛注视交互配置文件或任何其他配置文件旁边出现黄色三角形,请选择该三角形,然后在 OpenXR 项目验证窗口中单击修复按钮。 完成后,关闭 OpenXR 项目验证窗口。

Eye

在“项目设置”窗口中的“OpenXR 功能组”下,确保选择以下选项:

如果您位于“桌面 VR”选项卡中:

Windows 混合现实

手部追踪

运动控制器型号

桌面

如果您位于通用 Windows 平台选项卡中:

微软全息镜头

手部追踪

运动控制器型号

为

单击深度提交模式下拉列表并选择深度 16 位。

为深度提交模式选择的深度

暗示

将深度格式减少到 16 位是可选的,但可能会提高项目中的图形性能。 要了解更多信息,请参阅。

注意

“渲染模式”设置位于“深度提交模式”上方,默认设置为“单通道实例化”。 在混合现实应用程序中,场景被渲染两次:每只眼睛一次。 结果就是“立体视觉”。 这会使必要的计算量增加一倍,因此在 Unity 中选择最高效的渲染路径以节省 CPU 和 GPU 时间非常重要。 单通道实例渲染是此处的最佳选择,我们建议默认为每个项目启用它。 要了解有关此内容的更多信息,请参阅 Unity 文档。

配置播放器设置

在“项目设置”窗口的左栏中,选择“播放器”。

请注意,在播放器窗口中,“产品名称”框已填充。 该名称取自您的项目名称,并将成为显示在 HoloLens“开始”菜单中的名称。

Unity

暗示

为了使您的应用程序在开发过程中更容易找到,请在名称前添加下划线,将其排在任何列表的顶部。

单击“发布设置”下拉列表,然后在“包名称”字段中输入适当的名称。

Unity

注意

包名称是应用程序的唯一标识符。 如果您想避免覆盖以前安装的同名应用程序版本,则应在部署应用程序之前更改此标识符。

关闭项目设置窗口。

您现在已准备好开始在 Unity 中使用 OpenXR 进行开发!

Unity示例项目

查看 OpenXR 混合现实示例存储库中的示例 Unity 项目,这些项目演示了如何使用混合现实 OpenXR 插件为 HoloLens 2 或混合现实耳机构建 Unity 应用程序。

也可以看看

Similar Posts