Unity バージョンとパッケージの既知の問題
Unity または Unity プラグインの一部のバージョンでは、アプリが HoloLens 2 または Windows Mixed Reality デバイスで期待どおりに動作するのを妨げる非互換性があることが知られています。 一般に、Unity のすべての LTS バージョンとその検証済みプラグインはサポートされていますが、アプリが期待どおりに動作するように、Unity と Unity プラグインの特定のビルドは避けるようにすることをお勧めします。
最新のパッチ バージョンの 2021.3 LTS と Unity プラグインの推奨バージョンを、最新の Mixed Reality OpenXR プラグインと共に使用することをお勧めします。
以前の Unity パッチ リリースを使用する場合は、処理を妨げる既知の問題の表を参照して、処理を妨げる他の問題を含むビルドを回避してください。
障害となっているアクティブな問題点
| 障害となっている問題点 | 最終更新 & 状態 | 問題のあるバージョン | 対応策 |
|---|---|---|---|
| 既定の URP Lit マテリアルを使用する場合、URP を使用する HL2 アプリは、Unity 2021 と比較して Unity 2022 でのレンダリングのパフォーマンスが悪化します。 | 調査中: 2023/01/04 |
Unity 2022.*.* と URP 13.*.* |
Unity 2022 で URP を回避するか、既定の URP マテリアルを使用しないようにするか、Unity 2021.3.14 以降で URP を使用します |
| Unity 2021 および 2022 で UWP アプリ パッケージ (APPX または MSIX) をビルドできない | 進行中: 2023/09/29 |
再現可能: 2021.3.30f1、2022.3.8f1 | Unity 2021.3.27 以前を使用します。 または、Appx マニフェストをアプリの VS プロジェクトに手動で追加します。 詳細については、 Unity のフォーラム と Unity の Issue Tracker に関するページを参照してください。 |
| MRTK3 と Azure Spatial Anchors の両方をインポートする HL2 アプリでは、ARFoundation パッケージのバージョンがインポートされた ARSubsystems バージョンと一致しない場合、"資産の競合に対する 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 以降を使用する |
| URP を使用する HL2 アプリは、Unity 2020 と比較して 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、または 2020.3.42f1、2021.3.14f1、2022.1.23f1、2022.2.0b16、2023.1.0a19 以上の Unity バージョンを使用してください |
| ホスト PC に他の 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、WindowsXR プラグイン、ガンマ色空間レンダリングを使用する HL2 アプリでは、Unity 2020 以降でレンダリングのパフォーマンスが低下します。 | 解決済み: 2022/06/15 |
Unity 2020.*.* と URP 10.*.* と 4.6.3 以前の Windows XR プラグイン |
バージョン 4.6.4 以降の Windows XR プラグインを使ってください |
| Unity の Burst パッケージを使用する HL2 アプリ (通常 URP を使用する場合に使用される) で、VisualStudio で ILCPP コンパイル エラーが発生する。 | 解決済み: 2022/06/06 |
Unity Burst パッケージ 1.6.5、1.7.0、または 1.7.1 |
Unity バースト パッケージ 1.6.6 または 1.7.2 以降のバージョンを使用します。 |
| HL2 で起動したとき、またはアプリケ―ションが一時停止して再開された後、既定のスプラッシュ スクリーンを持つアプリケーションに 4 つの回転するドットが表示される。 | 解決済み: 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 を使用する 以降 |