Unreal Insights を使用したプロファイリング

unreal インサイトは、unreal Engine のデータを収集、分析、視覚化するプロファイルシステムです。 プロファイリングシステムを使用すると、最適化のボトルネックや、アプリのパフォーマンスが向上する可能性のある領域を見つけることができます。 通常は、エディターから unreal インサイトを有効にしますが、HoloLens 2 については、コマンドラインを使用する必要があります。

セットアップ

unreal では、unreal インサイトを有効にするコマンドラインパラメーターを使用して、HoloLens ランチャーで "カスタムプロファイル" を作成して構成することができます。

  1. コマンドプロンプトで ipconfig コマンドを使用して、コンピューターの IP アドレスを検索します。 IP アドレスは、ipconfig によって示される IPv4 アドレスです。 後でコマンドラインパラメーターを設定するときは、この点に注意してください。

重要

VPN の背後にいる場合は、代わりに VPN 経由で提供される IP アドレスを指定する必要があります。

Ipconfig コマンドのコマンドラインの結果のスクリーンショット

  1. メインエディターウィンドウの [編集] ツールバーから Project 設定 を開きます。

Project 設定強調表示された [編集] ドロップダウンのスクリーンショット

  1. [プラットフォーム] ヘッダーが表示されるまで左のパネルを下にスクロールし、[ HoloLens] を選択します。

Project 設定左側のパネルの [プラットフォーム] セクションのスクリーンショット HoloLens 強調表示されています。

  1. [ 機能 ] セクションに [インターネットクライアント]、[インターネットクライアントサーバー]、[プライベートネットワーククライアントサーバー] が選択されていることを確認します。

インターネットクライアント、インターネットクライアントサーバー、およびプライベートネットワーククライアントサーバーが選択されている機能オプションのスクリーンショット

Launch

  1. [起動] ボタンの下にある UE4 パネルから Project 起動ツール を開きます。

プロジェクトランチャーが強調表示されている起動オプションのスクリーンショット

  1. カスタム + 起動プロファイル にカスタムプロファイルを作成するには、このボタンを選択します。 作成した後は、いつでもこのプロファイルを編集できます。

カスタム起動プロファイルが強調表示されているプロジェクトランチャーのスクリーンショット

  1. HoloLens カスタム起動プロファイルの [プロファイルの編集] ボタンを選択します。 [ ビルド ] セクションで、[ ビルド UAT ] チェックボックスをオンにし、 追加のコマンドラインパラメーター を設定します。

注意

"IP_OF_YOUR_PC" は、手順 1. で見つかった IP アドレスです。 これは、HoloLens の ip アドレスではなく、unreal インサイトを実行しているコンピューターの ip アドレスです。

重要

トレースが非常に高速になります。 トレースサイズを低く保つために必要なチャネルのみを有効にします。

プロファイル構成のビルドオプションのスクリーンショット

  1. [ クック ブック] を選択し て、 デバイスへのコピーを有効にします。 クックマップ でマップが選択されていることを確認します。

書籍と HoloLens 強調表示されているプロファイル構成のクックオプションのスクリーンショット

  1. ビルドをパッケージ & ストアパッケージ化して ローカルに保存する方法を設定します。 後で必要になるため、選択するファイルパスに注意してください。

パッケージ化してローカルに保存するように設定されたプロファイル構成のパッケージオプションのスクリーンショット

  1. ビルドを展開する方法を 設定します****か?

[デプロイしない] に設定されているプロファイル構成の展開オプションのスクリーンショット

  1. [戻る] を選択して Project 起動ツール ダイアログのルートに戻ります。
  2. エディターに戻り、カスタム起動プロファイルで [ 起動 ] をクリックします。

カスタム起動プロファイルのスクリーンショット

  1. プロジェクトがビルドされていることを確認し、デバイスポータルを使用して、.appxbundle (手順 5. のパッケージパス) を HoloLens にデプロイします。

  2. unreal インサイトを起動します。 unreal インサイト実行可能ファイルは、通常、次のようにバイナリエンジンフォルダーに格納されます。 "C:\Program Files\Epic Games\UE_4.26\Engine\Binaries\Win64\UnrealInsights.exe"

実行中の unreal insights 実行可能ファイルのスクリーンショット

  1. HoloLens でアプリを起動します。

プロファイル

unreal インサイトに戻り、デバイスへの ライブ 接続を選択してプロファイリングを開始します

カスタムプロファイルは、プロジェクト間で共有されます。 ここからは、毎回作成したカスタムプロファイルを使用できます。これを毎回行う必要はありません。 セットアップセクションで手順 3. ~ 6. を実行するたびに、デバイスへの接続を再作成する必要があります。

関連項目