高通6490之Snapdragon Spaces 集成指南（Unity 版）

最新推荐文章于 2026-01-07 13:48:09 发布

原创

最新推荐文章于 2026-01-07 13:48:09 发布 · 649 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#unity #游戏引擎

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