空間プロファイラ

Unreal Editor for Fortnite (UEFN) では、プロジェクトのパフォーマンスを把握し改善するために必要なツールを提供しています。フォートナイトは多くのプラットフォームで実行されるため、プロジェクト特有のメトリクスを知っておくことで、UEFN で必要な調整を行いスムーズなパフォーマンスを保証できます。

大まかなワークフローを確認するには サンプリング セッションを開始する をご覧ください。空間プロファイラ ツールの詳細を知るにはこのまま読み進めてください。

役に立つ用語

空間メトリクス は、ワールド内で 3D 空間位置を使用するプロパティについて測定できます。一定数の空間値から成り、各空間値は、測定値に相当する数値と関連座標を持ちます。この座標は、ワールド内で値が測定された空間位置を示します。

空間値 とは、任意の 3D 位置における空間メトリクスの具体的な測定値です。空間値は 3 つの座標値 (X、Y、Z) と測定結果の値を持ちます。空間値をまとめたものが空間メトリクス サンプルです。

空間メトリクス サンプル は、定義された期間にわたる具体的な空間メトリクス測定値です。測定された複数の空間値と、それに伴う 1 つの結果が含まれます。サンプルには、空間値を内包する 3D 境界、使用する距離精度、取得した日付など、他の関連データも含まれます。

空間メトリクス プロパティ は、空間メトリクス サンプルに含まれるすべての情報を表します。

空間プロファイラ は、空間メトリクスの 2D ヒートマップを提供するビジュアライゼーション ウィジェットです。ここで空間メトリクス サンプルを記録、保存、ロードすることもできます。空間メトリクス更新関数からデータを収集し、定期的にデータを更新できます。

UEFN エディタにドッキングした空間プロファイラ ウィンドウ。

空間プロファイラでは現在 7 つの空間メトリクスに対応しています。

空間プロファイラ UI

空間プロファイラはドッキングもできるスタンドアローン ウィジェットで、4 つのエリアに分かれています。

空間プロファイラ ウィジェット エリア

1. コントロール ツールバー

2. メトリクス ブラウザ

3. ヒートマップ ビュー

4. 概要セクション

コントロール ツールバー

このエリアには、空間プロファイラの操作に使用する主なインタラクティブ エレメントが含まれます。それらを使用して空間メトリクス サンプルの作成、可視化、保存ができます。キャプチャーしたサンプルを使用して生成したデータにより、UEFN 体験を向上できます。

空間プロファイラのコントロール ツールバー エレメント。

コントロール ツールバーには次のエレメントが含まれます。

1. メトリクス セレクタ： このドロップダウンで、UEFN プロジェクトでキャプチャーしたいメトリクスを選択できます。選択したメトリクスはすべて、メトリクス バーに自動的に追加されます。選択を解除すると削除されます。メトリクス セレクタは有効な UEFN セッションへの接続を要求しますが、これは空間プロファイラで利用可能なメトリクスをリストアップするためです。

2. サンプリングを開始： ユーザーが選択したメトリクス一式のキャプチャーを開始するボタンです。メトリクスをサンプリングするには UEFN セッションに接続する必要があります。サンプリング中は、ヒートマップのビューの中心には自動的にそのセッションのプレイヤー ポーン位置が来て、キャプチャーする空間値に照準を合わせます。

3. サンプリングを停止： 選択したメトリクスのキャプチャーを停止するボタンです。

4. サンプル ファイルを開く： 既存のサンプル ファイル (複数のメトリクスが含まれる場合があります) を開くボタンです。ファイルを開くと、すべてのロード済みメトリクスがメトリクス ブラウザにロードされ、そのデータにアクセスできるようになります。

5. サンプルをファイルに保存： アクティブなプロファイリング セッションを保存するボタンです。ファイルに保存するためのダイアログが開きます。サンプルのタイムスタンプが付いたファイル名がデフォルトで提案されます。空間プロファイラが現在のサンプリング セッションのすべてのメトリクスを保存先のファイルに保存します。

6. UEFN セッション セレクタ： セッションには複数のクライアントを接続できます。セッション セレクタでは、接続しメトリクスを実行するセッションを選択します。セッションを起動すると、空間プロファイラが自動的にクライアントに接続し、そのセッションに接続されたユーザーの名前でセッション セレクタを更新します。

7. Settings (設定)： 空間プロファイラの環境設定を表示するボタンです。ウィジェット エレメントの一部を表示/非表示にできます。

メトリクス ブラウザ

このエリアでは、サンプリングのために選択したメトリクスや、保存ファイルから開いたメトリクスを確認できます。メトリクス ブラウザは追加された各メトリクス用のボタンを作成します。

メトリクスをクリックして選択すると、そのメトリクスのデータと統計情報でヒートマップ ビューが更新され、そのメトリクスの合計統計値が表示されます。

メモリ使用量とゲーム更新時間のブラウジングの比較。

ヒートマップ ビュー

ヒートマップ ビューは、選択したメトリクスのヒートマップの上に、サンプル内のすべての空間値を重ねて表示します。各空間値はサンプルのデータに応じて色付けされます。各メトリクスのカットオフ値をすばやく設定して目的の値範囲を定義できます。

上部の 4 つのボタンを使うと、ヒートマップに手を加えてカスタマイズできます。

• ハンバーガー メニュー

• Show Options (オプションを表示)

• Focus Player (プレイヤーにフォーカス)

• Focus Bounds (境界にフォーカス)

ヒートマップ ビュー内をダブルクリックすると、プロジェクト内の該当箇所にエディタ カメラが配置されます。セッションが起動している場合、ダブルクリックした箇所にプレイヤー ポーンがテレポートします。

ハンバーガー メニュー

ヒートマップ ビジュアライゼーション オプションにアクセスできます。次の 2 つのセクションがあります。

• Heat Colors (ヒート カラー)

• Metric Options (メトリクス オプション)

• Alpha Settings (アルファ設定)

空間プロファイラのハンバーガー メニュー オプション。

これらのセクションでは、各フィールドの右にあるリセット矢印ボタンをクリックすると、設定をリセットできます。

Heat Colors は、色覚多様性に配慮した読み取りやすいカラー パレットを提供します。キーとなる色を定義して、ヒートマップの色の範囲をカスタマイズすることができます。

[Metric Settings (メトリクスの設定)] は、メトリクスの視覚化に影響するすべての設定をグループ化します。

• Threshold (しきい値)：しきい値は、通常のゲームプレイで予想される最大値を定義します。

• Display Unit (表示単位)：指定すると、メトリクスで優先される視覚化単位が定義されます。指定しないままにすると、ツールによって各メトリクスに最適な単位が選択されます。この表示単位は、ヒートマップ ビューおよび概要ビューに使用される単位に影響します。

• Cell Method (セルの方式)：この設定は、各セルの境界範囲内の値のリストから各 2D セル値を計算する際にツールで使用する減少方式を指定します。利用可能な減少方式は、次のとおりです。

  • Median Value (中央値) (デフォルト)
  • Min Value (最小値)
  • Max Value (最大値)
  • Average Value (平均値)

[Alpha Settings (アルファ設定)] は求められる範囲の外の空間値を表示します。空間値の密度が高い部分があるメトリクス サンプルを確認するときに、メトリクスを細かい粒度で読み取れるため、これらのオプションを調整すると便利です。

• Min Alpha (最小アルファ)： 空間値に与える開始値。サンプル内のすべての空間値のアルファ値で、各空間値に応じて、最小値 (最小アルファ) から最大値またはしきい値 (最大アルファ) まで増加します。最小アルファ値を低くすることで、低い空間値が見えにくくなり、最大値またはしきい値に近い空間値が目立つようになります。

• Max Alpha (最小アルファ)： 空間値に与える最大開始値。

• Alpha Exp (アルファ Exp)： アルファ値がサンプルの空間値範囲の最小値から最大値まで、どのくらいすばやく移行するかを示す値です。

• Mid Point (中間点)： サンプルの正規化値範囲にある値で、中間値の色は範囲の中間を示します。デフォルトでは 0.5 が正規化値範囲の中央値です。

軸

左下に表示される 3D 軸を表示/非表示にできます。この軸はヒートマップ ビューの上下の向きに対応しています。この向きは、エディタではなくクライアントのミニマップ ビューと同じです。

ヒートマップ軸の表示

グリッド

2D ヒートマップ グリッドを表示/非表示にできます。グリッドは、サンプル値の範囲で可視空間を細分化できます。

ヒートマップ レジェンド

ヒートマップ ビューの右下にあるヒートマップの色範囲の凡例を表示/非表示にできます。

ヒートマップのカラー パレットのレジェンドを表示

境界

サンプル内のすべての空間値から成る 2D バウンディング ボックスを表示/非表示にできます。

ヒートマップ上にサンプル境界 (白) を表示

Focus Player (プレイヤーにフォーカス)

セッション接続中のプレイヤー ポーン周辺をビューの中心に据えます。セッションが接続されている必要があります。

Focus Bounds (境界にフォーカス)

2D バウンディング ボックス周辺をヒートマップ ビューの中心に据えます。

コンテキストに応じたメニュー

ヒートマップ ビュー エリアを右クリックすると、コンテキストに応じたメニューにアクセスできます。このメニューには、次のオプションがあります。

• Teleport (テレポート)

• Default View (デフォルト ビュー)

• Focus Bounds (境界にフォーカス)

• フォーカス位置のトラッキング

空間プロファイラのヒートマップ ビューのコンテキストに応じたメニュー

Teleport

ヒートマップ ビュー上で右クリックした箇所にカメラ ビューとプレイヤー ポーンを移動させます。プレイヤー ポーンをテレポートさせるには、セッションが接続されている必要があります。セッションが接続されていないと、ヒートマップ ビュー内の任意の箇所をダブルクリックした場合と同じで、プロジェクト内の該当位置にエディタ カメラが配置されます。

Default View

ヒートマップ ビューのフォーカス値とズーム値をデフォルト設定に戻します。

概要セクション

概要セクションには、リアルタイムで収集されるデータの視覚化に役立つ ヒストグラム が含まれています。これにより、ヒストグラム内で確認したピーク値とレベル全体の実行を関連付けることができます。

ハンバーガー メニューの値を調整すると、ヒストグラムに表示されるさまざまなカットオフ ポイントが変更されます。

右側には、選択したメトリクス サンプルの統計情報の概要が表示されます。サンプルの空間値から次の統計情報をコンパイルして表示します。

サンプリング セッションを開始する

このセクションでは、空間プロファイラ ツールを使用してサンプリング セッションを開始する方法と、空間メトリクス サンプルを保存する方法を説明します。

1. [Tools (ツール)] > [Spatial Metrics (空間メトリクス)] > [Spatial Profiler (空間プロファイラ)] を選択します。空間プロファイラ ウィジェットが開きます。

2. ヒートマップの左上の ハンバーガー メニュー をクリックします。

   

3. このメニューでサンプリング パラメータを設定します。詳細については、ヒートマップ ビュー セクションを参照してください。

4. [Launch Session (セッションを開始)] をクリックし、フォートナイト クライアントを通じてゲームを開始します。

5. (任意) クライアントがロードされたら、[End Game (ゲームを終了)] を押して 編集モード に入ります。ポーンがレベルの中をすばやくフライスルーできるようになります。

   

6. エディタに戻り、[Metrics (メトリクス)] ドロップダウンをクリックして、記録中に測定したいメトリクスを選択します。

7. 記録 を押します。

   

8. ゲーム セッションではポーンを使って島の中を動き回り、目的に応じてゲームをプレイします。フライスルーする中で、空間プロファイラ ヒートマップが更新されます。

   

9. 停止 ボタンを押してサンプリング セッションを終了します。

   

10. 空間プロファイラ ウィジェットの 保存 アイコンを押し、プロジェクトのローカル ディレクトリ内の任意の位置を選択します。プロファイラが、プロジェクトに保存されたサンプルへの読み取りアクセスを提供します。サンプルはメトリクスの型とタイムスタンプ別に整理されています。

    

11. 開く アイコンをクリックすると、以前のプロジェクト サンプルの記録にアクセスできます。