3. 开发环境搭建：Unity3D / Unreal Engine 5 环境配置，XR插件与SDK安装

好，咱们正式开始动手了。这一章，说白了就是给你的电脑“装上武器”。没有趁手的开发环境，再好的3D显示方案也只是纸上谈兵。

我个人习惯把环境搭建分成三步走：选引擎 → 装插件 → 配SDK。别小看这步，我见过太多项目在最后联调时出幺蛾子，追根溯源，都是环境没搭干净。

核心原则： 版本号必须严格对齐。Unity、Unreal、XR插件、SDK，这四个东西的版本就像四把钥匙，一把不对，门就开不了。

3.1 引擎选择：Unity vs Unreal，你选哪把枪？

先别急着下载。你得想清楚，你的3D显示方案是跑在什么设备上？

对比维度 Unity 3D (推荐版本 2022.3 LTS) Unreal Engine 5 (推荐版本 5.3 / 5.4)
上手曲线 较平缓，C# 语法友好 较陡峭，C++ 或蓝图
XR 生态 极其成熟，XR Interaction Toolkit 很完善 原生支持好，但第三方插件不如 Unity 丰富
渲染质量 够用，适合移动端/一体机 顶级，适合 PC VR / 主机级画质
我的建议 做 Meta Quest / PICO / HoloLens 首选 做 SteamVR / PSVR2 / 影视级模拟 首选

嗯，这里要注意。如果你做的是轻量级、快速迭代的项目，比如企业培训、展览展示，我建议你选 Unity。我在2022年帮一家车企做AR看车项目时，用Unity从零到原型只花了2周。但如果你追求的是照片级真实感，比如建筑可视化、高端模拟器，那 UE5 的 Nanite 和 Lumen 就是你的不二之选。

3.2 Unity 环境配置实战

假设你选了 Unity。咱们一步步来。

3.2.1 安装 Unity Hub 与 Editor

  1. 去官网下载 Unity Hub。别下成旧版了。
  2. 在 Hub 里安装 Unity 2022.3 LTS。为什么是 LTS？稳定，不折腾。
  3. 安装时，记得勾选 Android Build Support 和 Windows Build Support。如果你做苹果生态，再加个 iOS。
小技巧： 安装模块时，把 OpenJDK 和 Android SDK & NDK 也一并勾上。Unity Hub 会自动帮你配好路径，省得你后面手动配环境变量。

3.2.2 安装 XR 插件

打开你的项目，进入 Window → Package Manager。在包列表里，你需要装这几个核心插件：

  • XR Interaction Toolkit：交互框架，帮你处理抓取、射线、传送。
  • XR Plugin Management：插件管理，统一开关各平台支持。
  • OpenXR Plugin：跨平台标准接口，现在主流设备都支持。

我曾经踩过一个坑：装了 XR Interaction Toolkit 但忘了装 OpenXR Plugin，结果手柄死活连不上。你想想看，排查了半天，最后发现是少打了一个勾。

3.2.3 配置项目设置

装完插件，别急着写代码。先做这几步：

  1. 打开 Edit → Project Settings → XR Plug-in Management。
  2. 在 Windows 和 Android 标签页下，都勾上 OpenXR。
  3. 点击 OpenXR 下的 Interaction Profiles，添加你设备的 Profile（比如 Oculus Touch Controller Profile）。
避坑指南： 我曾经在项目中期从 Unity 2021 升级到 2022，结果 XR Interaction Toolkit 的 API 变了，所有抓取逻辑都得重写。所以，项目启动前定好版本，中途尽量别升级。

3.3 Unreal Engine 5 环境配置实战

如果你选了 UE5，流程略有不同，但逻辑一样。

3.3.1 安装 Epic Games Launcher 与 UE5

  1. 下载 Epic Games Launcher，注册账号。
  2. 在库中安装 Unreal Engine 5.3 或 5.4。我建议用 5.3，更稳定。
  3. 安装时，确保勾选了 Android Platform 和 Windows Platform。

3.3.2 启用 XR 插件

创建或打开你的项目后：

  1. 进入 Edit → Plugins。
  2. 搜索 OpenXR，勾选启用。
  3. 搜索 XR Interaction，勾选启用。
  4. 重启编辑器。

UE5 的 OpenXR 支持很原生。我记得在 5.2 版本之前，手柄的震动反馈还有点问题，但到了 5.3 基本就稳了。

3.3.3 配置项目设置

在 Edit → Project Settings → Platforms → Android 里：

  • 设置 Minimum SDK Version 为 29（Android 10）。
  • 设置 Target SDK Version 为 33 或更高。
  • 勾选 Support OpenXR。
提示： UE5 的打包时间比较长。我建议你第一次打包时，先打一个空场景，验证环境是否通。别等到项目做完了才发现打包失败，那太痛苦了。

3.4 SDK 安装：让设备认识你的代码

引擎装好了，插件配好了，但你的电脑还不认识你的头显。你需要装设备厂商的 SDK。

设备平台 SDK 名称 安装方式
Meta Quest 2 / 3 / Pro Meta XR Simulator / Oculus SDK Unity Package Manager 或 手动下载
PICO 4 / 4 Ultra PICO XR SDK Unity Package Manager 或 GitHub 下载
HTC Vive / Valve Index SteamVR SDK Steam 安装 SteamVR，引擎内启用 OpenXR
HoloLens 2 Mixed Reality Toolkit (MRTK) Unity Package Manager

以 Meta Quest 为例，在 Unity 里：

  1. 打开 Window → Package Manager。
  2. 点击左上角 +，选择 Add package by name。
  3. 输入 com.meta.xr.sdk.core，安装。
  4. 再安装 com.meta.xr.sdk.interaction 和 com.meta.xr.sdk.voice（如果需要语音）。
注意： 不同厂商的 SDK 可能会冲突。比如你同时装了 Meta 和 PICO 的 SDK，在打包时可能会报符号重复。我建议你 只装目标设备的 SDK，别贪多。

3.5 知识体系总览：一张图看懂环境搭建

说了这么多，你可能有点晕。没关系，我画了一张图，把整个流程串起来。

3D显示开发环境搭建流程 3D显示开发环境搭建流程 选择游戏引擎 Unity 2022.3 LTS Unreal Engine 5.3 安装 XR 插件 启用 OpenXR 插件 安装设备 SDK（Meta/PICO/SteamVR） 配置平台 SDK（Android/Windows） 验证：打包空场景测试 核心原则：版本号严格对齐，只装目标设备 SDK，项目启动后不升级引擎主版本

3.6 验证你的环境：跑通第一个空场景

所有东西都装好了。怎么知道它能不能用？

很简单，创建一个空场景，放一个 Cube，然后打包到你的设备上。如果 Cube 能显示，手柄能交互，那环境就通了。

我的经验： 第一次打包通常不会一次成功。别慌。看报错日志，90% 的问题都是 SDK 版本不匹配或 Android SDK 路径没配好。去 Edit → Preferences → External Tools 里检查一下路径，基本能解决。

嗯，环境搭建这一步，确实有点繁琐。但磨刀不误砍柴工。你想想看，如果这一步没做好，后面写再多交互逻辑，到头来发现设备连不上，那才叫崩溃。

← 上一章 📖 返回目录 下一章 →