Slate Insights の概要

ユーザー インターフェース (UI) の開発時には、UI の更新を必要とする変更の元 (ソース) を見つけるのに苦労する場合があります。Slate Insights によって Unreal Insights の機能が拡張され、特定のスレートおよび UMG の更新の原因を明らかにするためのツールを通じて、デベロッパーによる UI パフォーマンス向上を支援します。

Slate Insights を実行する Slate Frame View (クリックしてフルサイズで表示)

Slate Insights プラグインを使用している場合、デベロッパーは Slate Frame View を使用して、フレームごとにペイント、無効化、更新されているウィジェットのリストを取得することができます。Slate Insights により、デベロッパーは UI をデバッグして最適化することができます。

設定

Slate Insights を使用する

エディタで Slate Insights を使用するには、このプラグインをエディタ内、または「*.uproject」ファイルで有効にします。エディタ内で Slate Insights プラグインを有効にするには、[Edit (編集)] > [Plugins (プラグイン)] > [Built-In (ビルトイン)] で [Slate Insights] を見つけます。

もしくは、プロジェクトの「*.uproject」ファイルでこのプラグインを有効にします。

	{
		"FileVersion":3,
		"EngineAssociation": "{2118FE05-4070-6D80-44FC-17A9E96EAE93}",
		"Category": "",
		"Description": "",
		"Plugins": [
			{
				"Name": "SlateInsights",
				"Enabled": true
			}
		]
	}
Copy full snippet

{ "FileVersion":3, "EngineAssociation": "{2118FE05-4070-6D80-44FC-17A9E96EAE93}", "Category": "", "Description": "", "Plugins": [ { "Name": "SlateInsights", "Enabled": true } ] } エディタをソースからビルドした場合は、必要なプラグインを有効にした後に、プロジェクトのエディタをコンパイルして実行する必要があります。

必要なプラグインを有効にしたらエディタを再起動します。以下の手順に従って Slate Insights 用のデータをトレースします。

1. エディタでゲーム プロジェクトを開き、[Editor Preferences (エディタの環境設定)] を開きます。

2. [Level Editor (レベル エディタ)] > [Play (プレイ)] > [Play in Standalone Game (スタンドアローン ゲームでのプレイ)] に行き、[Additional Launch Parameters (追加の起動パラメータ)] テキスト ボックスに「-trace=slate」と入力します。

   コマンドライン オプションの詳細については、「Unreal Insights のリファレンス」を参照してください。 ~~~

~~~

1. プロジェクトの [Active Play Mode (アクティブなプレイ モード)] を [Standalone Game (スタンドアローン ゲーム)] に設定します。

2. Unreal Insights がまだビルドされていない場合は、Engine\Source\Programs\UnrealInsights で Unreal Insights プロジェクトを見つけてアプリケーションをビルドします。

3. UnrealInsights アプリケーションを実行します。このアプリケーションは「Engine\Binaries\<プラットフォーム>」にあります。

4. Unreal Insights が実行されている状態でプロジェクトを実行し、アプリケーションのトレース データを記録します。

   • トレースでは、次のプロジェクト ディレクトリに自動的にログが作成されます：<プロジェクト名>/Saved/TraceSessions。
   • トレース セッションのサイズは時間の経過とともに大きくなる場合があるため、「*.utrace」ファイルを頻繁に確認し、管理するようにしてください。

5. プロジェクトのトレース データを記録したら、スタンドアローンのアプリケーションを閉じます。

6. Unreal Insights で分析を開始するには、(1) プロジェクトのトレース セッションを選択し、(2) [Open (開く)] をクリックします。

7. [Slate Frame View (スレート フレーム ビュー)] タブを開くには、[Menu (メニュー)] > [Slate Frame View] を選択します。

   Unreal Insights のナビゲーションおよび使用については、「Unreal Insights の概要」を参照してください。

8. UI データを [Slate Frame View] タブで分析します。

スレート フレーム ビュー

Unreal Insights を使ってアプリケーションのトレース データをキャプチャしたら、「*.utrace」ファイルを開いて、[Slate Frame View] で UI の状態の分析を始めます。

[Slate Frame View] には [Invalidation (無効化)] および [Update (更新)] という 2 つのレポート領域があり、それぞれには一連の独自のトレース フラッグが含まれています。

無効化トレース フラグ

無効化トレース フラグの領域には ウィジェット に関する情報が表示されます。これには、無効化されたウィジェットの 数量 とその 理由 が含まれます。[Slate Frame View] では「LPUCRV」フラグ リストのフラグがハイライトされて、ウィジェットが無効化された理由が示されます。各フラグの定義は次のとおりです。

更新トレース フラグ

更新トレース フラグの領域には ウィジェット に関する情報が表示されます。これには、無効化されたウィジェットの 数量 とその 理由 が含まれます。[Slate Frame View] では「UTPV」フラグ リストのフラグがハイライトされて、ウィジェットが更新された理由が示されます。各フラグの定義は次のとおりです。