部分版本的 Unity 或 Unity 外掛包含已知的不相容性，導致應用程式無法在 HoloLens 2 或 Windows Mixed Reality 裝置上正常運作。 雖然我們通常支援所有長期支援 (LTS) 版本及其已驗證的外掛，但建議避免使用這些特定的 Unity 版本及 Unity 外掛，以確保你的應用程式能如預期運作。
重要事項
自 2025 年 6 月 23 日起，Unity 對 HoloLens 2 的支援將有所變動。 請參考這裡，了解支援 HoloLens 2 的最後版本 Unity。
我們建議您使用支援 HoloLens 2 的 2022.3 LTS 最新補丁版本，搭配最新的 Mixed Reality 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 的 HL2 應用程式在使用 Unity 2022 時，使用預設 URP Lit 素材時，渲染效能比 Unity 2021 差。 |
預覽： 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+，或手動在應用程式的 Visual Studio 專案中新增 APPX 清單。 欲了解更多資訊，請參閱 Unity 論壇 及 Unity 問題追蹤器。 |
| HL2 應用程式在偵測到手部時會當機。 |
修正： 2023/03/24 |
Unity 2022、Unity 2021、Unity 2020 com.unity.inputsystem 1.5.0 |
請使用 com.unity.inputsystem 1.5.1 或更新版本 |
| 使用 URP 的 HL2 應用程式在 Unity 2021 的渲染效能比 Unity 2020 差。 |
修正： 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 |
| 使用 Unity OpenXR 插件 1.5.1 的全息應用程式遠端應用程式，如果主機電腦沒有連接其他 VR 頭戴裝置，則無法連接到遠端伺服器。 |
修正： 2022/10/04 |
Unity 2020 或 Unity 2021 搭配 Unity OpenXR 插件 = 1.5.0、1.5.1 與 1.5.2 |
若使用 Holographic App 遠端支援，請使用 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 的 Burst 套件的 HL2 應用程式 (，當使用 URP 時常用) 會在 VisualStudio 中遇到 ILCPP 編譯錯誤。 |
修正： 2022/06/06 |
Unity Burst 套件 1.6.5、1.7.0 或 1.7.1 |
使用 Unity Burst 套件 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 以及之後 |
| OpenXR 後端搭配 URP 可能會在 HL2 上死鎖。 |
修正： 2021/05/13 |
Unity 2020.3.0f1 轉為 Unity 2020.3.7f1 |
使用 Unity 2020.3.8f1 以及之後 |