Unity 版本和套件中的已知問題
某些版本的 Unity 或 Unity 外掛程式已知不相容，封鎖應用程式在 HoloLens 2 或 Windows Mixed Reality 裝置上如預期般運作。 雖然我們通常會支援所有 LTS 版本的 Unity 及其已驗證的外掛程式，但建議您避免這些特定的 Unity 和 Unity 外掛程式組建，以確保您的應用程式如預期般運作。
建議您使用 2021.3 LTS 的最新修補程式版本及其建議的 Unity 外掛程式版本，以及最新的 Mixed Reality OpenXR 外掛程式。
如果使用先前的 Unity 修補程式版本，請務必參閱 已知的封鎖問題數據表 ，以確保避免建置發生其他封鎖問題。
作用中封鎖問題
| 封鎖問題 | 上次更新 & 狀態 | 有問題的版本 | 風險降低 |
|---|---|---|---|
| 使用 URP 的 HL2 應用程式在使用預設 URPLit 材質時，Unity 2022 中的轉譯效能比 Unity 2021 更差。 | 調查： 2023/01/04 |
Unity 2022.*.* 具有 URP 13.*.* |
請避免 Unity 2022 中的 URP、避免使用預設 URP 材質，或在 Unity 2021.3.14+ 中使用 URP |
| 無法在 Unity 2021 和 2022 中 (APPX 或 MSIX) 建置 UWP 應用程式套件 | 進行中： 2023/09/29 |
可重現：2021.3.30f1、2022.3.8f1 | 使用 Unity 2021.3.27 或更早版本。 或手動將Appx指令清單新增至應用程式的 VS 專案。 如需詳細資訊 ，請參閱 Unity 的論壇 和 Unity 的問題追蹤器 。 |
| 當 ARFoundation 套件版本不符合匯入的 ARSubsystems 版本時，匯入 MRTK3 和 Azure Spatial Anchors 的 HL2 應用程式可能會顯示「資產衝突的 Guid」錯誤。 | 使用 ARFoundation 5.x+時，手動將 com.unity.xr.arsubsystems 5.0.2 版新增至專案的套件管理員。 您會收到一則警告，指出 ARSubsystems 已被取代，但可以忽略。 |
已解決封鎖問題
| 封鎖問題 | 上次更新 & 狀態 | 有問題的版本 | 具有修正的版本 |
|---|---|---|---|
| 偵測到手部時 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 及更新版本 |