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中启用所需功能: