Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

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

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

設定

エディタで 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
        }
    ]
}

必要なプラグインを有効にしたら、エディタを再起動します。

使用方法

プラグインを有効にしたら、以下の手順に従って Slate Insights 用のデータをトレースします。

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

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

   Unreal Insights のリファレンス

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

   エディタのビューポート

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

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

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

   ライブ (LIVE) で実行されているプロジェクトの Unreal Insights ラベル。

   • トレースでは、次のプロジェクト ディレクトリに自動的にログが作成されます： <プロジェクト名>/Saved/TraceSessions 。

   • トレース セッションのサイズは時間の経過とともに大きくなる場合があるため、「 *.utrace 」ファイルを頻繁に確認し、管理するようにしてください。

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

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

   クリックしてフルサイズで表示。

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

   Unreal Insights Oveview (Unreal Insights の概要)

10. 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」フラグ リストのフラグがハイライトされて、ウィジェットが更新された理由が示されます。各フラグの定義は次のとおりです。