Snapdragon Spaces 集成指南（Unity 版）
Snapdragon Spaces 是 Qualcomm 推出的 XR（扩展现实）开发平台，支持 AR/VR/MR 应用开发，主要针对 Snapdragon 处理器设备（如 AR 眼镜、头显）。它基于 OpenXR 标准，与 Unity 深度集成，支持手部跟踪、空间锚点、平面检测等功能。最新文档基于 2025-2026 年版本，推荐使用 Unity 2021.3.16 或更高 LTS 版本。
本指南聚焦Unity SDK 集成，分为先决条件、下载、设置、构建部署和测试。官方文档：https://docs.spaces.qualcomm.com/unity/。开发者需注册 Snapdragon Spaces Developer Portal 下载 SDK。
1. 先决条件
- 硬件：
- Snapdragon Spaces 兼容设备（如支持 Snapdragon XR2 或更高处理器的 AR/VR 头显/眼镜）。
- Android 设备用于测试（推荐 Snapdragon 8 Gen 系列）。
- USB 调试启用，开发者模式开启。
- 软件：
- Unity：2021 LTS 或更高（推荐 2021.3.16f1），安装 Android Build Support（IL2CPP 脚本后端、ARM64 架构）。
- Android SDK：通过 Unity Hub 或 Android Studio 安装（API Level 29+）。
- OpenXR：Unity Package Manager 中安装最新 OpenXR Plugin。
- 其他：JDK 11+、Android NDK（可选，自定义构建时）。
- 账户：Qualcomm Developer 账户（免费注册）。
2. 下载 Snapdragon Spaces SDK
- 访问 Snapdragon Spaces Developer Portal，登录/注册。
- 下载Unity Developer Package（.tgz 格式，如
com.qualcomm.snapdragon.spaces-x.x.x.tgz）。 - 可选：下载旧版本存档 Download Archive。
3. Unity 项目设置
推荐使用Configuration Tool（SDK 自带），否则手动设置。
3.1 导入 SDK 包
- 新建 Unity 项目（3D 模板，推荐 URP 渲染管线）。
- 打开Window > Package Manager。
- 点击+>Add package from tarball，选择下载的 .tgz 文件导入。
3.2 推荐：使用 Configuration Tool（自动设置）
- SDK 导入后，运行Window > Snapdragon Spaces > Configuration Tool。
- 工具自动配置 OpenXR、Player Settings 和 Android Manifest。
3.3 手动设置（详细步骤）
启用 OpenXR 插件：
- Edit > Project Settings > XR Plug-in Management > Android。
- 勾选OpenXR，选择Snapdragon Spaces feature group。
- 点击 OpenXR 旁的红色感叹号，打开OpenXR Project Validation窗口，逐一点击Fix修复问题（包括 API Level、架构等）。
- 最后启用Input Systems（可能需重启 Editor）。
启用 Spaces 功能：
- 在OpenXR Settings中启用所需功能：
功能
- 在OpenXR Settings中启用所需功能：
