Unity 版本和包中的已知问题
某些版本的 Unity 或 Unity 插件包含已知的不兼容性，阻止应用在 HoloLens 2 或 Windows 混合现实 设备上按预期工作。 虽然我们通常支持 Unity 的所有长期支持（LTS）版本及其已验证的插件，但我们建议避免使用 Unity 和 Unity 插件的特定版本，以确保应用按预期工作。
建议使用 2022.3 LTS 的最新修补程序版本及其建议的 Unity 插件版本，以及最新的 混合现实 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 中，转到 Project 设置 > Player Other 设置 > Un检查 Auto Graphics API > Add Direct3D11 > remove Direct3D12 > |
| 当 ARFoundation 包版本与导入的 ARSubsystems 版本不匹配时，导入 MRTK3 和 Azure 空间定位点的 HL2 应用可能会出现“资产的 GUID 冲突”错误。 | 使用 ARFoundation 5.x+ 时，请手动将 com.unity.xr.arsubsystems 版本 5.0.2 添加到项目的包管理器中。 你可能会看到一条警告消息，指出 ARSubsystems 已弃用，但可以忽略此消息。 |
已解决的阻止问题
| 阻止问题 | 状态和上次更新时间 | 有问题的版本 | 具有修补程序的版本 |
|---|---|---|---|
| 使用默认 URP Lit 材料时，使用 URP 的 HL2 应用在 Unity 2022 中的渲染性能比 Unity 2021 差。 | 在预览版中： 2024/05/01 |
Unity 2022.*.* 使用 URP 13.*.* |
避免 Unity 2022 中的 URP，避免使用默认 URP 材料，或者在 Unity 2021.3.14+ 中使用 URP。 Unity 6 预览版中解决了问题。 |
| 无法在 Unity 2021 和 2022 中生成 UWP 应用包（APPX 或 MSIX） | 修复： 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 或更高版本 |
| 与 Unity 2020 相比，使用 URP 的 HL2 应用在 Unity 2021 中渲染性能较差。 | 修复： 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 的 Holographic App Remoting 远程处理应用无法连接到远程处理播放器。 | 修复： 2022/10/04 |
Unity 2020 或 Unity 2021 与 Unity OpenXR 插件 = 1.5.0、1.5.1 和 1.5.2 |
如果使用 Holographic App Remoting，请使用 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 的 HL2 应用、WindowsXR 插件和 Gamma 色彩空间渲染在 Unity 2020 或更高版本中的渲染性能较差。 | 修复： 2022/06/15 |
Unity 2020.*.* 使用 URP 10.*.* 和 Windows XR 插件 <=4.6.3 |
使用 Windows XR 插件版本 >= 4.6.4 |
| 使用 Unity 的突发包（例如，使用 URP 时常用的）的 HL2 应用将在 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 及更高版本 |