Environment Query Testing Pawn

EQS Testing Pawn を使用して EQS クエリの実行内容をデバッグおよび表示する方法を概説します。

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 を使用してデータをテストできます。 

  1. コンテンツ ブラウザ で、EQSTestingPawn クラスの新規の ブループリント を作成して、名前を付けます。

    Create a new Blueprint of the EQSTestingPawn class and give it any name in the Content Browser

  2. EQSTestingPawn をレベルに置き、[Details (詳細)] パネルで、「EQS Query」テンプレートをテストに割り当てます。

    Place the EQSTestingPawn in the Level, then in the Details panel and assign the EQS Query Template to test *
    クリックしてフルサイズで表示。

Environment Query System の実験的な性質を考慮すると、EQSTestingPawn はプロセッサをきわめて集中的に使用する可能性があるため、有効なクエリ テンプレートに変更を加えると、システムが長時間ハングする場合があります。Environment Query を編集している間は、[Query Template (クエリ テンプレート)] プロパティをクリアすることをお勧めします。

レベルで EQSTestingPawn を選択すると、クエリの内容に応じて、条件に基づいた一致の値を示すデバッグ球体がレベルに表示されます。以下では、EQSTestingPawn を使用して、プレイヤー キャラクターが視野に入るレベルでのできる限り最も良い位置を提供するクエリをテストします。EQSTestingPawn を動かすと、球体の色と値が更新され、プレイヤーと EQSTestingPawn の位置に基づいて新しい最良の一致が示されます。

結果の評価

EQSTestingPawn を使用してテストの結果を評価すると、色付きの球体と値で、特定の位置にあるアイテムの一致レベルが示されます。

  • 青の球体:アイテムに対してテストは失敗したので、アイテムは完全にウェイトが外され、結果から除外されました。これは、通常、Distance テストを使用して特定の範囲を上回る (あるいは下回る) アイテムを除外するなど、値をフィルタリングすると発生します。値を完全に除外したくない場合は、スコアリングセクションの [Clamp (クランプ)] オプションを使います。以下では、プレイヤーが見える場所を見つけるために実行されているクエリがあります。[Visibility (可視性)] を使用して、AI がプレイヤーが見えないアイテム (青い球体で表される) を除外します。

Blue Spheres

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

Green To Red Spheres

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

デバッグ ビューが表示する内容を変更します。

値

説明

Single Result

Step to Debug Draw プロパティにリスト化されたアイテムの結果のみ表示します。

All Matching

フィルターをかけ、ウェイト付けした、Environment Query 全体の最終的な点数を表示します。

Nav Agent Properites

Pawn の移動方法を決定するプロパティ。 

値

説明

Nav  Agent Radius

ナビゲーション/パス検索に使用されるカプセルの半径です。

Nav Agent Height

ナビゲーション/パス検索に使用されるカプセルの全高です。

Nav Agent Step Height

使用するステップの高さ、または NavData の構成設定のデフォルト値を使用する場合は -1 です。

Nav Walking Search Height Scale

Nav ウォーキング時に投影する NavMesh を検索するときに境界の高さに適用するスケーリング係数です。

Preferred Nav Data

このプロパティは、Testing Pawn にテストの実行対象となる Navigation Data クラスの型を指定します。

Can Crouch

true の場合、Pawn はしゃがむことができます。

Can Jump

true の場合、Pawn はジャンプできます。

Can Walk

true の場合、Pawn は地面の上を歩いたり、移動したりできます。

Can Swim

true の場合、Pawn は泳いだり、大量の液体の中を移動することができます。

Can Fly

true の場合、Pawn は飛ぶことができます。
Unreal Engine のドキュメントを改善するために協力をお願いします！どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
キャンセル