高通6490之Snapdragon Spaces 集成指南（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

1. 访问 Snapdragon Spaces Developer Portal，登录/注册。
2. 下载Unity Developer Package（.tgz 格式，如com.qualcomm.snapdragon.spaces-x.x.x.tgz）。
3. 可选：下载旧版本存档 Download Archive。

3. Unity 项目设置

推荐使用Configuration Tool（SDK 自带），否则手动设置。

3.1 导入 SDK 包

1. 新建 Unity 项目（3D 模板，推荐 URP 渲染管线）。
2. 打开Window > Package Manager。
3. 点击+>Add package from tarball，选择下载的 .tgz 文件导入。

3.2 推荐：使用 Configuration Tool（自动设置）

• SDK 导入后，运行Window > Snapdragon Spaces > Configuration Tool。
• 工具自动配置 OpenXR、Player Settings 和 Android Manifest。

3.3 手动设置（详细步骤）

1. 启用 OpenXR 插件：

   • Edit > Project Settings > XR Plug-in Management > Android。
   • 勾选OpenXR，选择Snapdragon Spaces feature group。
   • 点击 OpenXR 旁的红色感叹号，打开OpenXR Project Validation窗口，逐一点击Fix修复问题（包括 API Level、架构等）。
   • 最后启用Input Systems（可能需重启 Editor）。

2. 启用 Spaces 功能：

   • 在OpenXR Settings中启用所需功能：

     功能