Unity バージョンとパッケージの既知の問題
一部のバージョンの Unity または Unity プラグインには、HoloLens 2 または Windows Mixed Reality デバイスでアプリが期待どおりに動作するのを妨げている、既知の非互換性が含まれています。 一般に、Unity のすべての長期サポート (LTS) バージョンとその検証済みプラグインをサポートしていますが、アプリが期待どおりに動作するように、Unity プラグインと Unity プラグインの特定のビルドは避けてください。
最新の Mixed Reality OpenXR プラグインと共に、2022.3 LTS の最新のパッチ バージョンと Unity プラグインの推奨バージョンを使用することをお勧めします。
以前の 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 > Other 設定 >> Unチェック Auto Graphics API > Add Direct3D11 > Remove Direct3D12 に移動します |
| MRTK3 と Azure Spatial Anchors の両方をインポートする HL2 アプリでは、ARFoundation パッケージのバージョンがインポートされた ARSubsystems のバージョンと一致しない場合、"資産の Guid の競合が発生する" エラーが表示される場合があります。 | ARFoundation 5.x+ を使用する場合は、com.unity.xr.arsubsystems バージョン 5.0.2 をプロジェクトのパッケージ マネージャーに手動で追加します。 ARSubsystems が非推奨であることを示す警告メッセージが表示される場合がありますが、このメッセージは無視できます。 |
障害となっている問題点が解決されました
| 障害となっている問題点 | 状態と最終更新日 | 問題のあるバージョン | 修正プログラムを含むバージョン |
|---|---|---|---|
| 既定の URP Lit マテリアルを使用する場合、URP を使用する HL2 アプリは、Unity 2021 と比較して Unity 2022 でのレンダリングのパフォーマンスが悪化します。 | プレビュー段階: 2024/05/01 |
Unity 2022.*.* URP 13.*.* |
Unity 2022 では URP を使用しないようにするか、既定の URP マテリアルを使用しないようにするか、Unity 2021.3.14 以降で URP を使用してください。 Unity 6 プレビューで問題が解決されました。 |
| 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 以降を使用する |
| 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 または Unity バージョン >を使用する = 2020.3.42f1、2021.3.14f1、2022.1.23f1、2022.2.0b16、または 2023.1.0a19 |
| ホスト 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 のバースト パッケージを使用する 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 で起動したとき、またはアプリケ―ションが一時停止して再開された後、既定のスプラッシュ スクリーンを持つアプリケーションに 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 を使用する 以降 |