Environment Query System クイック スタート ガイド

Environment Query System (EQS) をビヘイビア ツリーで使用すると、さまざまなテストで環境をポーリングし、それらのテストの結果に基づいて処理方法を決定できます。EQS のユースケースの例としては、AI キャラクターにプレイヤーから離れたカバー位置を見つけさせたり、レベル内で最も近い体力や弾薬を見つけさせたりすることが挙げられます。

Environment Query は、実際にはさまざまな要素で構成されています。Environment Query は、ビヘイビア ツリーから呼び出すことができます。その後、実際の Environment Query はジェネレータを使用して、コンテキストを参照し、テストを使用することで、最も大きくウェイト付けされた結果をビヘイビア ツリーに提供します。

このガイドでは、プレイヤーが見えるまでランダムに環境を動き回る AI を作成します。プレイヤーが見えたら、AI は EQS システムを使用して、その距離を維持しながら、見晴らしの利く最も良い地点のある環境内の場所を見つけます。これは複数の種類の遠隔攻撃を実行する AI キャラクターがいる状況で役に立ちます。このような場合、以下の例に示すように、AI がプレイヤーとの距離を保ちながら、プレイヤーが見える状態を保持しようとするためです。

このガイドを修了すると、次のシステムの基本について理解することができます。

1. ブループリント ビジュアル スクリプティング

2. AI コントローラー

3. ブラックボード

4. ビヘイビア ツリー

5. Environmental Query System (EQS)

6. EQS のコンテキスト

7. AI デバッグ ツール

1 - 必要なプロジェクト設定

このステップでは、AI に必要な複数のアセットを使用するプロジェクトを設定し、EQS システムを有効にします。

1. プロジェクト内の [Editor Preferences (エディタの環境設定)] > [Experimental (実験的)] > [AI] セクションで、[Environment Querying System] をオンにします。

   EQS システムが有効になっている場合、EQS 関連のアセットを作成してアクセスできます。

2. 「Content」>「ThirdPersonBP」>「[Blueprints」フォルダで、「AI」という新しいフォルダに ThirdPersonCharacter をコピーします。

3. 「AI」フォルダで、[Add New (新規追加)] > [Create Advanced Asset (高度なアセットの作成)] > [Artificial Intelligence (人工知能)] オプションから次の 3 つの AI アセットを作成します。

   • BB_Enemy という名前の ブラックボード

   • BT_Enemy という名前の ビヘイビア ツリー

   • EQS_FindPlayer という名前の Environment Query

4. AIController タイプの新しい ブループリント クラス を作成し、そのクラスを AIC_Enemy という名前にします。

5. EnvQueryContext_BlueprintBase タイプの新しい ブループリント クラス を作成し、そのクラスを EQC_PlayerContext という名前にします。

   コンテキスト は、さまざまなテストを適用する際の基準として EQS システムで使用できます。「EQS、指定のコンテキストにどれだけ接近しているか」などのテストを実行できます。このガイドのすぐ後で、テストを実行するときに、このアセットを使用して、プレイヤー キャラクターをコンテキストとして提供します。

2 - Environment Query のコンテキスト

このステップでは、このガイドの後半のテストで使用するプレイヤー キャラクターの EQS システムのコンテキストを設定します。

1. EQC_FindPlayer アセットを開き、[My Blueprint (マイ ブループリント)] パネルで、Provide Single Actor 関数をオーバーライドします。

   個々の アクタ または 位置、および一連の アクタ または一連の 位置 をコンテキストとして指定できます。

2. Provide Single Actor 関数で、[Resulting Actor (結果アクタ)] として、Get Player Character を呼び出します。

   これにより、実行時にコンテキストとしてプレイヤー キャラクターを取得できます。

   このケースではブループリントを取り上げていますが、コンテキストの作成方法としては C++ を使用する方がより最適化されています。

3 - EQS の設定

このステップでは、EQS エディタに移動して、プレイヤー キャラクターが見える位置を見つけるためのテストを設定します。

1. EQS_FindPlayer 内で、グラフ内の Root ノードをドラッグして、Points: Grid ノードを追加します。

   コンテキストに関連する アイテム を作成するために使用する ジェネレータ には様々なタイプがあります。これらのアイテムはテスト (コンテキスト Y からアイテム X までの距離はどれくらいかなど) で使用されます。アイテムは、テストの結果からを絞り込み、スコアリングされるため、アイテムを使用すると、「一番良い」(最高または最低のスコア) 選択肢を特定できます。

   この例では、プレイヤー キャラクターが見える位置に配置される AI の周りのグリッド上に一連のポイントが生成されます。

2. [Details (詳細)] パネルで、[ GridHalfSize] を [ 800 ] に、[Space Between (ポイント間のスペース)] を [ 150.0 ] に変更します。

   これらの設定は、テスト対象の使用可能なポイント数とそれらのポイント間の距離を定義するために使用されます。パフォーマンス上の理由から、これを管理しやすいサイズに維持することをお勧めします。グリッドが大き過ぎるとゲームのパフォーマンスに影響が出始める可能性があるためです。

   [Generate Around (周りに生成)] フィールドを使用して、グリッドを配置する必要がある場所 (この場合、Querier または AI キャラクターの周り) を特定できます。作成したプレイヤー コンテキストを使用するように [Generate Around (周りに生成)] を設定した場合にも機能しますが、プレイヤーがすでに見えている場合は、AI をプレイヤーの近くのグリッド上のポイントまで移動させる必要はありません。

   [Projection Data (投影データ)] オプションには、グリッドの生成方法を決定するためのその他のフィールドがあります。この例では、そのようなフィールドをデフォルトのままにできますが、必要に応じて、後で設定を調整することができます。

3. SimpleGrid ノードを右クリックして、[Add Test (テストの追加)] で [ Trace ] を選択します。

   Trace テストを使用すると、グリッド上のポイントで、プレイヤー キャラクターを実際に見ることができるかどうかを特定できます。

   ジェネレータにテストを追加する順序は重要ではありません。テストでは最初にフィルタリングを行ってソートし (後続のテストで処理するアイテムをできる限り減らすように)、さらに負荷でフィルタリングします (そのため、Distance (距離) フィルタは Line of Sight (見ることができる) フィルタの前に実行されます)。

4. 右クリックして、Distance タイプの別のテストを追加します。

   Trace テストでプレイヤー キャラクターを見ることができるポイントが返されたら、Distance テストで、プレイヤー キャラクターへの近さに基づいてそれらのポイントをスコアリングします。

5. Trace テストを選択して、[Details (詳細)] パネルで次のオプションを設定します

   • [Test Purpose (テスト目的)] = [Filter Only (フィルタのみ)]

   • [Context (コンテキスト)] = [ EQC_PlayerContext ]

   • [Bool Match (ブーリアン一致)] = オフ

   ここでは、見えるかどうかに関する Trace テストの基準ポイント (コンテキスト) としてプレイヤー キャラクターを提供しています。[Bool Match (ブーリアン一致)] オプションをオフにすることで、プレイヤー キャラクターを見ることができないポイントを除外するように指示しています。

6. Distance テストを選択して、[Details (詳細) ] パネルで、[Test Purpose (テスト目的)] を [Score Only (スコアのみ)] に、[Scoring Factor (スコアリング係数)] を [ -1.0 ] に変更します。

   Distance テストの目的は、返されたアイテムをスコアリングすることです。また、スコアリング係数 -1.0 ではプレイヤー キャラクターにより近いポイントをスコアリングします。これを 1.0 のままにすると、プレイヤーから最も離れたポイントが返され、最も離れたポイントに到達しようとして、AI がプレイヤー キャラクターの側を走って通り過ぎる可能性があります。

   その他にも、スコアを最小値または最大値に固定するオプション、[Scoring Equation (スコアリング式)] を変更するオプション ([Scoring Factor (スコアリング係数)] を掛ける前に正規化スコアに適用される曲線方程式を変更する)、[Normalization Type (正規化タイプ)] を定義するオプション、またはスコアの正規化使用する [Reference Value (基準値)] の割り当てを行うオプションなどのスコアリング オプションがあります。この例では、これらすべてのオプションをデフォルト設定のままにします。

4 - ブラックボードとビヘイビア ツリーの設定

このステップでは、ブラックボード キーを設定して、ビヘイビア ツリーのブランチをレイアウトします。

1. BB_Enemy ブラックボード アセットで、次の 3 つのキーを作成します。

   • HasLineOfSight という名前の ブーリアン

   • MoveToLocation という名前の ベクター

   • [Base Class (基本クラス)] が TargetActor という名前の [Actor (アクタ)] に設定されている オブジェクト

   これらのキーは、ビヘイビア ツリーのブランチ間で更新または移動をするために使用されます。

2. BT_Enemy ビヘイビア ツリーを開き、 Selectors、 Sequences および Wait タスク ノードを使用して次のグラフを作成します。

   クリックして拡大

   この例には、3 つの主要なブランチがあります。一番左のブランチは Selector ノード (In Combat という名称) を使用して、2 つの Sequence ノード (1 つは Attack で、もう 1 つは Move into Position) を切り替えます。AI が [In Combat] ブランチを実行していない場合は、[ Patrolling ] という名称の次のブランチを実行します。何らかの理由で、AI が戦闘中でもパトロール中でもない場合は、別のブランチに移動を試みる前にフェイル セーフ タスクを待機します (待機は 1 秒に設定しています)。

5 - ビヘイビア ツリー：パトロールの設定

このステップでは、ビヘイビア ツリーのパトロール ブランチを設定します。

1. Patrolling Sequence ノードから、Move To タスク ([ MoveToLocation ] に設定) と Wait タスク (5 +/- 1 秒に設定) を追加します。

   これで、AI はブラックボード キー MoveToLocation に移動して、指定の時間待機するように指示されます。ただし、引き続き MoveToLocation のベクター値を定義する必要があります。

2. ツールバーで [New Task (新規タスク)] を作成してから、 コンテンツ ブラウザ でそのタスクに BTT_RandomLocation という名前を付けます。

3. BTT_RandomLocation で、次のブループリント グラフを再作成します。

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

   Event Receive Execute AI ノードを使用して、[Controlled Pawn (制御されたポーン)] から、[Get Actor Location] に接続し、その戻り値を Get Random Reachable Point in Radius 関数の [Origin (原点)] として使用します ([Radius (半径)] として 1000 を設定)。

   Branch の [Conditions (条件)] として、GetRandomReachablePointInRadius ノードの [Return Value (戻り値)] を使用します。True ピンでは、[Random Location (ランダムな位置)] 値と [Key (キー)] が MoveToLocation という名称の Blackboard Key Selector 変数である Set Blackboard Value as Vector を使用します。

   False ピンでは、[Value (値)] として [Get Actor Location] を使用している Set Blackboard Value as Vector を使用します。これは、ランダムなポイントが見つからなかった場合に、新しい位置を見つけようとする前にキャラクターが存在する位置を取得します。タスクの最後では、両方の実行ワイヤが [Success (成功)] がオンになっている Finish Execute ノードに接続します。

   ビヘイビア ツリーでタスクとしてこれを追加する前に、[ MoveToLocation ] の値を設定できる必要があります。そのため、[My Blueprint (マイ ブループリント)] パネルの目のアイコンをクリックして、この値が [Instance Editable (編集可能インスタンス)] に設定されていることを確認してください。

4. ビヘイビア ツリーで、 Patrolling 配下の最初のノードとして、 BTT_RandomLocation タスク ([Details (詳細)] パネル で MoveToLocation を設定) を追加します。

6 - ビヘイビア ツリー：In Combat の設定

このステップでは、EQS_FindPlayer クエリを含む、In Combat ブランチに関連付けられているタスクを設定します。EQS_FindPlayer クエリは、プレイヤー キャラクターが視野に入る位置を見つけるために使用されます。

1. In Combat Selector を右クリックして、次のように設定されている [Blackboard (ブラックボード)] タイプの [Decorator (デコレーター)] を追加します。

   • [Observer aborts (オブザーバーによる中断)] が [Lower Priority (低優先度)] に設定されている

   • [Blackboard Key (ブラックボード キー)] が [ TargetActor ] に設定されている

   この設定では、TargetActor が設定されたら、優先度の低いタスクを中断して、In Combat ブランチを実行します。

2. Attack Sequence を右クリックして、次のように設定されている [Blackboard (ブラックボード)] タイプの [Decorator (デコレーター)] を追加します。

   • [Notify Observer (オブザーバーに通知)] が [On Value Change (値の変更時)] に設定されている

   • [Observer aborts (オブザーバーによる中断)] が [Lower Priority (低優先度)] に設定されている

   • [Blackboard Key (ブラックボード キー)] が [ HasLineOfSight ] に設定されている

   この設定では、 HasLineOfSight が設定されている場合、Attack ブランチを実行するように指示しています。 HasLineOfSight が設定されていない場合は、 HasLineOfSight が再度設定されるまで、他のブランチを実行します。

3. Attack ノードから、[Rotate to face BB entry] （TargetActor に設定） を追加します。

   これにより、「Attack」ブランチの間、AI が TargetActor に向かって方向転換します。この例では、AI に提供する攻撃はないものの、必要に応じて、後で攻撃などを追加できます。

4. Move Into Position ノードで、 Run EQSQuery ノードを使用します。

   Run EQSQuery ノードを使用すると、割り当てられたブラックボード キーを更新する EQS Query を実行できます。

5. Run EQSQuery ノードの [Details (詳細)] パネルで、[Blackboard Key (ブラックボード キー)] を [MoveToLocation ] に、[Query Template (クエリ テンプレート)] を [ EQS_FindPlayer ] に設定します。

6. Run EQS Query に続いて、MoveTo (MoveToLocation に設定) および Rotate to face BB entry (TargetActor に設定) を追加します。

   ビヘイビア ツリーが EQS Query を実行して [Blackboard Key (ブラックボード キー)] の [ MoveToLocation ] を更新し、AI がその位置に移動して、TargetActor (プレイヤー キャラクター) の方に向くように方向転換します。

   全体のビヘイビア ツリーは、次のようになります。

   クリックして拡大

7 - AI コントローラーの設定

このステップでは、AI コントローラーを設定してビヘイビア ツリーを実行し、AI が AI Perception を使用して、プレイヤー キャラクターを確認する方法を提供します。

1. AIC_Enemy ブループリントで、Event On Possess を追加して、 Run Behavior Tree (BT_Enemy に設定) に接続します。

2. 次のように [AI Sight config (AI の視野設定)] が設定されている AIPerception コンポーネントを追加します。

   • [Senses Config (感知設定)] で [AI Sight config (AI の視野設定)] を追加する

   • [Detect Neutrals (中立を検出)] を オンにする

   この設定により、AI は他のアクタを感知し、アクタが Perception システムで認識されたときにイベントを開始することができます。現在、デフォルトでは、プレイヤーには所属が割り当てられておらず、所属は C++ コードを使用して割り当てたもののみである場合があります。この状況を回避するために、Perception システムで中立を検出できるようにしています。アクタのタグ付けを使用すると、「プレイヤー」としてタグ付けされたアクタだけを認識できます。

3. AIPerception コンポーネントでは、[Events (イベント)] で On Target Perception Updated を追加して、Perceived Actor という名称の変数に Actor ピンを昇格します。
   

   クリックして拡大

   AI が何かを認識すると、そのアクタは変数として格納され、後でブラックボードを更新するために使用されます。

4. 次の条件で 2 つの Branch ノードを追加します。

   クリックして拡大

   • 1 番目のブランチ 条件は Actor Has Tag に設定されています。[Tag (タグ)] は [Player (プレイヤー)] であり、[Target (ターゲット)] は Perception Updated の [Actor (アクタ)] に接続されています。

   • 2 番目のブランチ 条件 は、 Perception Updated イベントの [Stimulus (刺激)] のピンから [Successfully Sensed (正常に感知)] に設定されています。

   この例では、認識されたアクタにプレイヤーのタグがある場合、ブランチにより、そのアクタが正常に感知されているかどうかを引き続き確認します。アクタのタグがない場合 (おそらく他の敵) は、ブランチではこの処理を進めません。

5. 第 2 ブランチの False ピンから、以下に示す 3 つのノードを追加します。

   ここでは、Set Timer by Event ノード (8.0 に設定) があり、[Return Value (戻り値)] が LostSightTimer という変数に昇格されています。次に、作成した LostSight という名前のカスタム イベントを イベント デリゲート として割り当てます。

6. [My Blueprint (マイ ブループリント) ] パネルで UpdateSightKey と UpdateTargetKey という 2 つの関数を作成します。

   これら 2 つの関数を使用して、ビヘイビア ツリーで決定を行うために使用されるブラックボード キーを更新します。

7. UpdateSightKey で、HasLineOfSight という名前の [Boolean (ブーリアン)] 入力を追加します。

8. UpdateSightKey で右クリックして Blackboard 変数を取得して、[Key Name (キー名)] を [ HasLineOfSight ] を使用する Set Value as Bool に接続します。

   これで、この関数を使用してブーリアン値経由でブラックボード キーに渡し、HasLineOfSIght キーを更新できます。

9. UpdateSightKey で、 TargetActor という名前の [Actor (アクタ)] 入力を追加します。

10. UpdateTargetKey で右クリックして Blackboard 変数を取得して、[Key Name (キー名)] を TargetActor を使用する Set Value as Object に接続します。

    UpdateSightKey 関数と同様に、これを使用すると、通過するすべてのアクタでブラックボード キー TargetActor が更新されます。

11. 次のように、 UpdateSightKey 関数および UpdateTargetActor 関数を False 条件に追加します。

    AIStimulus でプレイヤーのタグを持つアクタを正常に感知されない場合、false 条件によりタイマーが開始され (後でタイマーをハンドルに格納する)、ブラックボード キー HasLineOfSight が false に更新されます。指定された時間 (8.0 秒) が経過すると、カスタム イベント LostSight が実行され、TargetActor ブラックボード キーがクリアされます (つまり、プレイヤーがターゲットでなくなり、プレイヤーを見失ったことを意味します)。

    タイマーの [Time (時間)] 値を調整することで、AI がプレイヤー キャラクターの追跡を「あきらめる」までの時間を微調整できます。

12. 第 2 ブランチの True ピンでは、LostSIghtTimer および Clear and Invalidate Timer by Handle を使用します。

    これにより、プレイヤー キャラクターを見失った時に使用するタイマーが停止され、リセットされます。

13. UpdateSightKey (オン に設定されている) と UpdateTargetKey (Perceived Actor に設定) を追加します。

    全体的なグラフは次のようになります。

    クリックして拡大

    これで、AI コントローラーが設定され、ビヘイビア ツリーが実行され、AI Perception システムでプレイヤーのタグを持つアクタが認識されたときに基づいてブラックボード キーが更新されます。

8 - 最終設定

このステップでは、敵の AI キャラクターのブループリントを設定し、AI が認識できるようにタグ プレイヤーをプレイヤー キャラクターのブループリントに追加して、AI が環境を動き回る方法を認識し、視野を簡単に遮ることができるように Nav Mesh Bounds Volume といくつかのメッシュを追加します。

1. BP_Enemy を開き、[Details (詳細)] パネルで [Use Controller Rotation Yaw (コントローラーのヨー回転を使用する)] をオンにして、[AI Controller Class (AI コントローラー クラス)] を[ AIC_Enemy ] に設定します。

   クリックして拡大

   AI がビヘイビア ツリー内で回転タスクを実行するには、[Controller Rotation Yaw (コントローラーのヨー回転)] をオンにする必要があります。また、ロジックを含むAI コントローラーのカスタム クラスを割り当て、ビヘイビア ツリーを実行します。オプションで、プレイヤー キャラクター (および Camera コンポーネント) からコピーしたすべてのスクリプトを削除しました。AI キャラクターには必要ないためです。

2. [Mode (モード) ] パネルから、Nav Mesh Bounds Volume をレベルに追加し、レベルをカプセル化するようにスケーリングします。

   P キーを押すと、移動可能なパスを緑で表示するデバッグ グリッドのオン/オフを切り替えることができます。ゲームプレイ中に、コンソール コマンド show Navigation true (Nav Mesh を表示する) または false (Nav Mesh を非表示にする) で、Nav Mesh の表示を切り替えることができます。

3. レベルの ThirdPersonCharacter を右クリックして、[Edit ThirdPersonCharacter (サードパーソンキャラクタの編集)] を選択します。

4. [Details (詳細)] パネルで、「Tag」を検索して、[Player (プレイヤー)] という名前の [Tag (タグ)] を追加します。

   AIC_Enemy ブループリント内では、AI Perception システムがアクタを認識すると、ブランチが True と評価されるように、このアクタにプレイヤーのタグがあります。

5. レベル内で、視野を遮るための追加のカバー ポイントを提供するために、複数のバージョンの [Cube Mesh (キューブ メッシュ) ] をスケールアップして追加します。

6. ツールバーの [Play (プレイ)] ボタンをクリックしてレベルで再生します。

9 - 最終結果

エディタでプレイしている間、AI はプレイヤーが見えるまでランダムに巡回します。プレイヤーが見えたら、AI は方向転換してプレイヤーの方を向き、プレイヤーを見失ったら新しい場所に移動しようとします。AI は EQS を使用して、プレイヤーが視野に入るものの、離れた距離を保つことができる場所を見つけます。新しい位置に移動している間に再びプレイヤーを見失ったら、下のビデオに示されているように、AI はしばらくの間追跡をあきらめて、巡回に戻ります。

AI デバッグ ツールを使用すると、(ビヘイビア ツリーや認知情報に加えて) アクティブな EQS Query を表示できます。実行時に AI デバッグを有効にするには、' (アポストロフィ) キーを押してから 1 (一般的な AI デバッグ)、2 (ビヘイビア ツリー)、3 (EQS) または 4 (AI Perception) を選択します。以下では、AI デバッグを有効にして EQS デバッグ ツールを表示しています。

EQS デバッグ ツールが実行されている間、それらのスコア値と一緒にグリッド テストのポイントが表示されます。また、選択され、 Winner というテキストが表示されるポイントも確認できます。これらのツールは、どのポイントが評価されているのか、およびスコア値に基づいてあるポイントが別のポイントよりも選択される理由を確認するのに役立ちます。

EQS デバッグ ツールの使用に加えて、エディタで EQS Query をデバッグするために使用できる EQS Testing Pawn という名前の特別なタイプのポーンがあります。この Pawn を作成するには、 EQS Testing Pawn クラスの新しいブループリント クラスを作成します。

現在の設定では、EQS テストで評価するコンテキストとしてプレイヤー キャラクターを使用します。ゲームが実行されていない間にテストするには、 EQS_PlayerContext ブループリントを少し修正して、 Provide Actors Set 関数をオーバーライドする必要があります。

Resulting Actors Set を提供する ThirdPersonCharacter に設定された Get All Actors of Class を使用できます。

EQS Testing Pawn をレベルに追加するときは、[Details (詳細) ] パネルで [Query Template (クエリ テンプレート)] （EQS_FindPlayer クエリに設定） を割り当てることができます。

これにより、次に示すように、エディタでテストの結果を確認できます。