设置指南

本指南将详细介绍如何在 Unity 中开始使用 Snapdragon Spaces SDK。

安装 Unity 编辑器时，必须添加Android Build Support才能导出 apk 文件，该模块也可以通过 Unity Hub 后续添加。

下载开发者包

从 Snapdragon Spaces 开发者门户下载开发者包。

导入包

Snapdragon Spaces SDK 以 tarball 文件形式提供，请按照 Unity 的说明，使用位于 Unity Package 文件夹中的 tgz 文件将包导入项目。

XR交互工具包导入

Snapdragon Spaces Unity 包对 XR Interaction Toolkit 包有依赖关系。在导入 Snapdragon Spaces 包期间，导入 XR Interaction Toolkit 时可能会弹出两个提示：

●启用新输入系统：建议单击“是”以包含新输入系统包，以确保 OpenXR 和 XR Interaction Toolkit 包的完整功能，如果还需要旧输入系统，则可以将下方的“Active Input Handling”Player > Other Settings > Configuration值设置为 Both。

●交互层掩码更新：交互层掩码更新程序可能会提示升级交互层蒙版。如果之前没有将 XR 交互工具包添加到项目中，则可以选择“不，谢谢”。如果已经导入了 2.0.0 之前版本的 XR 交互工具包包，建议点击“我已备份”以升级交互层掩码。

更改项目设置

要启用 Snapdragon Spaces OpenXR 插件，请依次导航到 Edit > Project Settings > XR Plug-in Management 并打开 Android 选项卡。勾选 OpenXR 插件和 Snapdragon Spaces 功能组。最初，会有一些项目设置需要更新或修复，为此，请点击 OpenXR 旁边的红色感叹号，进入 OpenXR 项目验证窗口，点击条目旁边的修复按钮，应用所需的项目设置。最后应用启用两种输入系统的设置，因为这可能需要编辑器重启。

启用 Spaces 功能

在 OpenXR 设置中启用需要在运行时激活的功能。当前支持的功能及其对应的 AR Foundation 管理器或 XR 子系统列在下表中。

导入示例

Snapdragon Spaces SDK 包含一些示例资产，展示如何使用包中包含的感知功能。要导入这些示例，只需在包管理器中选择该包（位于菜单栏的 Window > Package Manager 下），然后点击导入核心示例。

导入示例后，可以通过菜单栏中的“窗口”>“Snapdragon Spaces”>“将场景添加到构建设置”来使用辅助工具将示例场景添加到构建设置中。