某些版本的 Unity 或 Unity 外掛程式包含已知的不相容性，導致應用程式無法如預期般在 HoloLens 2 或 Windows Mixed Reality 裝置上運作。 雖然我們通常支援所有長期支援 (LTS) 版本的 Unity 及其已驗證的外掛程式，但建議您避免使用這些特定的 Unity 和 Unity 外掛程式組建，以確保您的應用程式如預期般運作。
重要事項
從 2025 年 6 月 23 日開始，對 Unity 中 HoloLens 2 的支援正在變更。 如需支援 HoloLens 2 Unity 的最後版本，請參閱這裡。
建議您搭配使用 2022.3 LTS 的最後一個修補程式版本與 HoloLens 2 支援，以及最新的 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 Lit 材質時的 Unity 2021 相比，使用 URP 的 HL2 應用程式在 Unity 2022 中的轉譯效能較差。 |
在預覽版中： 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 或更新版本 |
| 相較於 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 的全像攝影應用程式遠端遠端處理應用程式無法連線到遠端播放機。 |
固定： 2022/10/04 |
Unity 2020 或 Unity 2021 使用 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 和更新版本 |