选择Unity版本和 XR 插件

虽然我们建议使用 Unity LTS (长期支持) 版本和最新的 混合现实 OpenXR 插件进行HoloLens 2和Windows Mixed Reality开发,但也可以使用其他Unity配置生成应用。

支持Unity中的HoloLens 2

从 2025 年 6 月 23 日起,在 Unity 中生成HoloLens 2应用的支持将发生变化。 在此日期之后设置HoloLens 2 Unity项目时,需要特别小心。

生成HoloLens 2应用需要两个Unity组件:

  • Unity编辑器
  • Unity OpenXR 插件包 (它不同于从 混合现实 功能工具) 安装的 混合现实 OpenXR 插件

2025 年 6 月 23 日之后,Unity编辑器或 Unity OpenXR 插件包的新版本不包含对HoloLens 2的支持。 在此日期之后发布的Unity编辑器和Unity OpenXR 插件不能用于生成HoloLens 2应用。

更改后生成HoloLens 2 Unity应用

若要在这些更改后生成HoloLens 2应用,需要:

  • 支持HoloLens 2的Unity编辑器版本。 可以从 Unity Hub 下载旧版Unity编辑器。
  • 具有HoloLens 2支持的 Unity OpenXR 插件版本。 Unity可以使用 Unity 的包管理器为项目指定 OpenXR 插件包版本。 请参阅Unity手册。 Unity OpenXR 插件的包名称为“com.unity.xr.openxr”。

支持的版本

截至 2025 年 5 月 20 日,以下是支持HoloLens 2的 Unity 组件的最后一个版本:

  • Unity 2022.3 LTS:2022.3.62f1
  • Unity 6:6000.0.49f1
  • Unity OpenXR 插件:1.14.3

2025 年 6 月 23 日之后,Unity编辑器和具有 Unity HoloLens 2支持的 openXR 插件版本不会收到更新 (包括来自 Unity 的 bug 修复) 。

重要

从 2025 年 6 月 23 日开始,Unity中对HoloLens 2的支持将发生变化。 请参阅此处,了解具有HoloLens 2支持的 Unity 的最新版本。

建议将具有HoloLens 2支持的 2022.3 LTS 的最后一个修补程序版本最新的 混合现实 OpenXR 插件一起使用。

如果使用较早的Unity修补程序版本,请务必参阅已知阻塞问题表,以确保避免生成时出现其他阻塞性问题。

重要

Unity 2020 及更高版本不支持面向 HoloLens (第一代) 。 Unity 2019 LTS 和旧版内置 XR 在 Unity 2019 LTS 的整个生命周期内仍支持这些头戴显示设备。

安装和管理Unity的最佳方式是通过 Unity 中心

  1. 安装 Unity Hub
  2. 选择“ 安装 ”选项卡,然后选择“ 添加”。
  3. 选择“Unity 2022.3 LTSUnity 2021.3 LTS”,然后单击“下一步”。

注意

此外,虽然我们建议使用 Unity 2022.3 LTS,但使用通用呈现管道 (URP) 的应用在使用默认 URP Lit 材料时,在 Unity 2022 中的呈现性能比 Unity 2021 更差。 建议 URP 应用使用 Unity 2021 或 Unity 6 预览版。 有关详细信息,检查某些Unity版本中的已知问题

Unity Hub 安装新版本

  1. 检查 “平台”下的以下组件:
    • 通用 Windows 平台生成支持
    • Windows 版本支持 (IL2CPP)

Unity 通用 Windows 平台生成支持选项

  1. 如果以前安装Unity没有这些选项,可以通过 Unity Hub 中的“添加模块”菜单添加它们:

Unity Windows 版本支持选项

安装 Unity 2022.3 或 Unity 2021.3 后,开始使用 混合现实 OpenXR 插件创建项目或升级现有项目:

Unity 2020.3 LTS

Unity 2020.3 LTS 已Unity的两年 Long-Term 支持时段结束,不再收到来自Unity的更新,尽管项目将继续运行。

如果需要使用 Unity 2020,可以将 Unity 2020 LTS 与 OpenXR 配合使用

注意

虽然我们建议对项目使用 OpenXR,但 Unity 2020.3 也支持 Windows XR 插件。

如果有Unity 2020 项目,应考虑规划迁移到 Unity 2022.3 LTS 和 混合现实 OpenXR 插件。

Unity 2019.4 LTS

Unity 2019.4 LTS 已结束Unity的两年 Long-Term 支持窗口,并且不再接收来自 Unity 的更新,尽管项目将继续运行。

如果需要使用 Unity 2019,可以将 Unity 2019 LTS 与旧版内置 XR 配合使用

如果你正在开发适用于 HoloLens (第一代) 的应用,则这些头戴显示设备在 Unity 2019 LTS 的整个生命周期内,在具有旧式内置 XR 的 Unity 2019 LTS 中仍受支持。

Unity 2018.4 LTS

Unity 2018.4 LTS 已结束Unity的两年 Long-Term 支持窗口,不再接收来自Unity的更新,尽管项目将继续运行。

如果你有Unity 2018 项目,应考虑规划迁移到 Unity 2021.3 LTS 和 混合现实 OpenXR 插件。

后续步骤