入门指南

设置指南

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

截屏2024-07-28 23.04.13.png

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


下载开发者包

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


导入包

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

截屏2024-07-28 23.07.19.png


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 交互工具包包,建议点击“我已备份以升级交互层掩码。

截屏2024-07-28 23.12.44.png















截屏2024-07-28 23.14.07.png


更改项目设置

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

截屏2024-07-28 23.17.28.png


启用 Spaces 功能

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

特征

AR Foundation/Spaces 管理器

XR 子系统

基础运行时

AR Session
AR Pose Driver

XRSessionSubsystem
-

摄像头帧访问

AR Camera Manager

XRCameraSubsystem

手部追踪

spaces 手势追踪管理器

Spaces.XRHandTrackingSubsystem

碰撞检测(实验性)

AR Raycast Manager

XRRaycastSubsystem

图像追踪

AR Tracked Image Manager

XRImageTrackingSubsystem

平面检测

AR Plane Manager

XRPlaneSubsystem

空间锚点

AR Anchor Manager

XRAnchorSubsystem

空间网格(实验性)

AR Mesh Manager

XRMeshSubsystem


截屏2024-07-28 23.28.38.png


导入示例

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

截屏2024-07-28 23.30.43.png

截屏2024-07-28 23.32.07.png


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

截屏2024-07-28 23.33.42.png