World Locking Tools のトラブルシューティング

  • [アーティクル]

煩わしい問題は、ここで説明します。 また、ワールド ロックの問題を絞り込むための推奨される方法もご覧ください。

ワールド ロックの問題

低フレーム レート

ワールド ロック ツールは、フレームレートに気付くような影響を与えないはずです。 (例外は、多くのアンカーが作成された後に、視覚化が最終的にフレームレートを引き下げることですが、ビジュアライザーは診断用であり、アプリケーションに同梱するものではありません)。

アプリケーションにワールド ロック ツールを追加した後にフレームレートの低下が見られる場合は、Unity ログを確認してください。 これは通常、例外が繰り返し発生しているという意味です。

"DLL がありません" エラー

これらのエラーは、通常、Frozen World Engine DLL からのものです。 これらを解決するには、セットアップのドキュメントの手順に従って、FrozenWorld エンジンを新しいバージョンにアップグレードします。 バージョン番号を変更せずにそれらの手順を実行すると、インストールが修復されます。

または、MR Feature Tool を使ってインストールすることもできます。 このツールでは、依存関係のインストールが自動的に処理されます。

'FrozenWorld' 名前空間がありません

次のようなエラー (通常は多数):

Assets\WorldLocking.Engine\Plugin.cs(10,37): エラー CS0234: 型または名前空間名 'FrozenWorld' が名前空間 'Microsoft.MixedReality' に存在しません (アセンブリ参照がありませんか? )

FrozenWorld.Engine DLL がありません。 「NuGet セットアップ」を参照してください。

または、 MR 機能ツールを使用してインストールし、依存関係のインストールを処理します。

うまく行きません

エラーと例外を Unity ログで確認してください。

シーン カメラが少なくとも 1 つの他のオブジェクトにアタッチされていることを確認します。 例については、WorldLocking.Examples.WorldLockingPhysicsSample の設定をご覧ください。 動的なカメラ操作を行っている場合は、WorldLockingManager に現在のカメラの情報を伝え続けることが必要な場合があります。 WorldLockingManager.AdjustmentFrame と WorldLockingManager.CameraParent に関するページを参照してください。

Unity/AR のより一般的な問題

"DirectoryNotFoundException: パスの一部が見つからない"

パスが長すぎます。 詳細な説明はこちらをご覧ください。

"リモート操作に予想以上に時間がかかっています" というメッセージ ボックスが表示され、デプロイが失敗する

USB 接続を確認します。 不良ケーブル、不良ポート、IPOverUSB の欠落はすべて、この問題の原因になる可能性があります。 ただし、PC からデバイスへの通信パスのどこかの可能性があります。

不足している Windows SDK コンポーネント

Unity で示された Visual Studio バージョンと、ビルドしようとしている Visual Studio バージョンの不一致。 次のことを確認してください。

Unity > File > Build Settings > Visual Studio Version

特に危険なのは、それが Latest Installed に設定されていて、複数のバージョンの Visual Studio がインストールされている場合です。

HoloLens では、アプリケーションは AR エクスペリエンスではなくスレートとして起動します

Unity の組み込み VR サポート (レガシ XR とも呼ばれる) を対象とする場合は、次のチェックを行います:

Unity > Project Settings > Player > XR Settings

[Virtual Reality Supported](仮想現実のサポート) チェック ボックスをオンにし、[Virtual Reality SDKs](仮想現実の SDK) で [Windows Mixed Reality] をオンにする必要があります。

Unity の AR Subsystems および XR SDK を使っている場合は、「Cross Platform using Unity's XR SDK Plugin system (Unity の XR SDK プラグイン システムを使用するクロス プラットフォーム)」の記事のすべての手順に従っていることを確認してください。 次のような原因が考えられます。

  • 必要なパッケージの 1 つが見つかりません。
  • MixedRealityToolkit オブジェクトで適切なプロファイルが設定されていません (MRTK を使っている場合)。

アプリが HoloLens2 上の ARM 用にビルドされていると、アプリは起動時に停止し、ARM64 は正常に機能します

既知の問題。

修正は、 [グラフィックス ジョブ] を無効にするか、

Project Settings > Player > Other Settings > Graphics Jobs

または ARM64 用にビルドすることです。

この問題は、Unity 2019.4 と Unity 2020.3 で修正されました。

関連項目