通过

Unity版本和包中的已知问题

某些版本的 Unity 或 Unity 插件包含已知不兼容性，阻止应用在HoloLens 2或Windows Mixed Reality设备上按预期工作。 虽然我们通常支持所有长期支持 (LTS) 版本的Unity及其已验证的插件，但我们建议避免使用Unity和Unity插件的特定版本，以确保应用按预期工作。

重要

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

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

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

活动阻塞问题

阻止问题 上次更新 & 状态   有问题的版本   缓解
Unity中使用 DirectX 12 的 HL2 应用表现出比使用 DirectX 11 的应用更差的渲染性能。 Unity 6 默认为 DirectX 12，导致性能意外下降。 调查：
2024/05/23		 Unity 2021.3.0f1 到 Unity 6000.*.*
使用 DirectX 12		 避免使用 DirectX 12。 在Unity转到“项目设置”“>播放器>其他设置”>取消选中“自动图形 API > 添加 Direct3D11 > 删除 Direct3D12

已解决阻止问题

阻止问题 上次更新 & 状态   有问题的版本   具有修补程序的版本
使用默认 URP Lit 材料时，使用 URP 的 HL2 应用在 2022 Unity的呈现性能低于 2021 Unity。 预览版：
2024/05/01		 Unity 2022.*.*
与 URP 13.*.*		 在 Unity 2022 中避免使用 URP，避免使用默认 URP 材料，或者在 Unity 2021.3.14+ 中使用 URP。 Unity 6 预览版中已解决问题。
无法在 Unity 2021 和 2022 中 (APPX 或 MSIX) 生成 UWP 应用包 固定：
2023/10/03		 可重现：2021.3.30f1、2022.3.8f1 使用 Unity 2021.3.31f1+、Unity 2022.3.13f1+或手动将 APPX 清单添加到应用的 Visual Studio 项目。 有关详细信息，请参阅Unity的论坛和Unity的问题跟踪器。
检测到手部时，HL2 应用崩溃。 固定：
2023/03/24		 Unity 2022、Unity 2021、Unity 2020
com.unity.inputsystem 1.5.0		 使用 com.unity.inputsystem 1.5.1 或更高版本
与 2020 Unity 相比，2021 Unity使用 URP 的 HL2 应用呈现性能较差。 固定：
2023/01/13		 Unity版本 < 2021.3.14f1
与 URP 12.*.*		 使用 Unity 2021.3.14f1 及更高版本
由于编译错误，Unity中通过 IL2CPP 生成应用程序失败。 有关根本原因的详细信息，请参阅 此处的讨论。 固定：
2022/11/10		 Visual Studio 2022
版本 17.4+ 与
Unity版本<
2020.3.42f1、2021.3.14f1、2022.1.23f1、2022.2.0b16 和 2023.1.0a19		 使用 Visual Studio 2019 或 Unity 版本 >= 2020.3.42f1、2021.3.14f1、2022.1.23f1、2022.2.0b16 或 2023.1.0a19
如果托管电脑未附加其他 VR 头戴显示设备，则使用 Unity OpenXR 插件 1.5.1 的全息应用远程处理应用无法连接到远程处理播放器。 固定：
2022/10/04		 Unity 2020 或 2021 Unity
使用 Unity OpenXR 插件 =
1.5.0、1.5.1 和 1.5.2		 如果使用全息应用远程处理，请使用 Unity OpenXR 插件 <= 1.4.3 或 >= 1.5.3
使用 Visual Studio 2022 在发布模式下生成的 ARM32 UWP Unity应用将在 Visual Studio 中遇到内部编译器错误。 固定：
2022/08/09		 Visual Studio 2022
版本 17.1.1+		 使用 Visual Studio 2019 或 Visual Studio 2022 版本 >= 17.3。*
使用 URP、WindowsXR 插件和 Gamma 颜色空间渲染的 HL2 应用在 Unity 2020 或更高版本中呈现性能较差。 固定：
2022/06/15		 Unity 2020.*.*
使用 URP 10.*.*
和 Windows XR 插件 <=4.6.3		 使用 Windows XR 插件版本 >= 4.6.4
例如，使用 Unity 的突发包的 HL2 应用 (通常在使用 URP) 时会命中 VisualStudio 中的 ILCPP 编译错误。 固定：
2022/06/06		 Unity突发包
1.6.5、1.7.0 或 1.7.1		 使用 Unity突发包 1.6.6 或 1.7.2 或更高版本。
在 HL2 上启动时，或在应用程序暂停和恢复后，具有默认初始屏幕的应用程序将显示四个旋转点。 固定：
2022/05/20		 Unity 2020.3.32-34f1
和 Unity 2021.2.17~19f1 和 Unity 2021.3.0~3f1		 使用 Unity 2020.3.35f1 或 Unity 2021.3.4f1 或更高版本
HL2 应用程序显示严重抖动的图像。 固定：
2021/12/02		 Unity 2020.3.21f1 到
Unity 2020.3.23f1		 使用 Unity 2020.3.24f1
及更高版本
具有 URP 的 OpenXR 后端在 HL2 上可能会死锁。 固定：
2021/05/13		 Unity 2020.3.0f1 到
Unity 2020.3.7f1		 使用 Unity 2020.3.8f1
及更高版本
  • Last updated on