Unity 版本和套件中的已知問題
某些版本的 Unity 或 Unity 外掛程式包含已知的不相容，會封鎖應用程式在 HoloLens 2 或 Windows Mixed Reality 裝置上如預期般運作。 雖然我們一般支援 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 其他 設定 > 取消核取自動圖形 API > 新增 Direct3D11 > 移除 Direct3D12 > |
| 當 ARFoundation 套件版本不符合匯入的 ARSubsystems 版本時，匯入 MRTK3 和 Azure Spatial Anchors 的 HL2 應用程式可能會顯示「資產衝突的 Guid」錯誤。 | 使用ARFoundation 5.x+時，手動將 com.unity.xr.arsubsystems 5.0.2版新增至專案的 封裝管理員。 您可能會看到警告訊息，指出 ARSubsystems 已被取代，但可以忽略此訊息。 |
已解決封鎖問題
| 封鎖問題 | 狀態和上次更新 | 發生問題的版本 | 具有修正的版本 |
|---|---|---|---|
| 使用 URP 的 HL2 應用程式在使用預設 URP Lit 材質時，相較於 Unity 2021，Unity 2022 的轉譯效能會更差。 | 預覽中： 2024/05/01 |
Unity 2022.*.* 具有 URP 13.*.* |
請避免 Unity 2022 中的 URP、避免使用預設 URP 數據，或在 Unity 2021.3.14+ 中使用 URP。 Unity 6 Preview 中已解決問題。 |
| 無法在 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 |
| 使用 Unity 的 OpenXR 外掛程式 1.5.1 的全像攝影應用程式遠端處理應用程式，如果主控電腦沒有附加其他 VR 頭戴式裝置，就無法連線到遠端播放程式。 | 固定： 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 和更新版本 |