AI デバッグ ツール に加えて、Environment Query System には、Environment Query System Testing Pawn (EQSTestingPawn) と呼ばれる特別な Pawn クラスがあります。このクラスでは、Environment Query が実際に実行している内容を確認できます。Environment Query の正確な特性では作成されるもののサイズと形状を定義していますが、常に色付きの球体で表されます。球体は、緑から赤のカラー スケールで、Environment Query が実行した各種テストに対する一致レベルを表します。青の球体は失敗、または Trace テストなどの boolean 型のテストが false を返したことを表します。
EQS Testing Pawn の使用方法
EQS を有効にして、EQS Query を作成したら、エディタで EQS Testing Pawn を使用してデータをテストできます。
-
コンテンツ ブラウザ で、EQSTestingPawn クラスの新規の ブループリント を作成して、名前を付けます。
-
EQSTestingPawn をレベルに置き、[Details (詳細)] パネルで、「EQS Query」テンプレートをテストに割り当てます。
Environment Query System の実験的な性質を考慮すると、EQSTestingPawn はプロセッサをきわめて集中的に使用する可能性があるため、有効なクエリ テンプレートに変更を加えると、システムが長時間ハングする場合があります。Environment Query を編集している間は、[Query Template (クエリ テンプレート)] プロパティをクリアすることをお勧めします。
レベルで EQSTestingPawn を選択すると、クエリの内容に応じて、条件に基づいた一致の値を示すデバッグ球体がレベルに表示されます。以下では、EQSTestingPawn を使用して、プレイヤー キャラクターが視野に入るレベルでのできる限り最も良い位置を提供するクエリをテストします。EQSTestingPawn を動かすと、球体の色と値が更新され、プレイヤーと EQSTestingPawn の位置に基づいて新しい最良の一致が示されます。
結果の評価
EQSTestingPawn を使用してテストの結果を評価すると、色付きの球体と値で、特定の位置にあるアイテムの一致レベルが示されます。
- 青の球体:アイテムに対してテストは失敗したので、アイテムは完全にウェイトが外され、結果から除外されました。これは、通常、Distance テストを使用して特定の範囲を上回る (あるいは下回る) アイテムを除外するなど、値をフィルタリングすると発生します。値を完全に除外したくない場合は、スコアリングセクションの [Clamp (クランプ)] オプションを使います。以下では、プレイヤーが見える場所を見つけるために実行されているクエリがあります。[Visibility (可視性)] を使用して、AI がプレイヤーが見えないアイテム (青い球体で表される) を除外します。

- 緑から赤の球体:球体の色は緑から赤の範囲であり、指定されたテストに最も一致するものとして、アイテムの好ましさの度合いを示します。赤より緑の方が好ましく、以下に示されている数字はアイテムのウェイトです。デバッグ ステップを 1 つだけプレビューする場合は、この値が選択されているテストの最終値となります。以下では、可視性に関係なく、クエリを使用してプレイヤーから最も離れたポイントを見つけます。

EQS Testing Pawn のプロパティ
レベルで EQSTestingPawn が選択されていると、[Details (詳細)] パネル内で次のプロパティを使用できます。
プロパティ | 説明 | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Query Template | EQSTestingPawn が使用すべき Environment Query です。 | ||||||||||||||||||||||
Query Config | 指定した値を Environment Query にパスして、設定値を素早く調整します。 | ||||||||||||||||||||||
Time Limit Per Step | 0.0 より大きい値に設定されると、このプロパティが設定された時点で EQSTestingPawn がステップの計算を停止します。EQSTestingPawn の使用中の Environment Query の調整を軽減することができます。 注:Density が高い、大きな Simple Grid などを使用している ジェネレータ の位置計算にかかる時間は短縮されません。 |
||||||||||||||||||||||
Step to Debug Draw | デバッグ ステップを 1 つだけ表示します。ステップは Environment Query 内に表示される順序ではマップされない場合があります。 | ||||||||||||||||||||||
Highlight Mode | すべての球体を同じサイズで表示するかどうか、5% または25% 最適な球体を表示するかどうかを決定します (他の球体のサイズが縮小されます)。 |
||||||||||||||||||||||
Draw Labels | ビューポートのデバッグ球体にウェイトまたは失敗の理由の描画を可能にします。 | ||||||||||||||||||||||
Draw Failed Items | トレースがターゲットを見つけられなかった場合など、失敗したテストのカリングを可能にします。 | ||||||||||||||||||||||
Re Run Query Only on Finished Move | EQSTestingPawn の移動を停止すると、ビューポートのビジュアル化のデバッグのアップデートのみ行われます。非常に速い Environment Query を操作する場合以外は、これを有効にしておくことをお勧めします。 | ||||||||||||||||||||||
Should be Visible in Game | EQSTestingPawn とそのデバッグのビジュアル化を実行中のゲームで可視にします。 | ||||||||||||||||||||||
Tick During Game | 実行中のゲームで EQSTestingPawn とそのデバッグの視覚化をティックします。 | ||||||||||||||||||||||
Querying Mode | デバッグ ビューが表示する内容を変更します。
|
||||||||||||||||||||||
Nav Agent Properites | Pawn の移動方法を決定するプロパティ。
|