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

EQS ノードのリファレンス：コンテキスト

EQS システムのテストとジェネレータでコンテキストがどのように使用されるかについて説明します。

Choose your operating system:

Windows

macOS

Linux

Environment Query System (EQS) では、 コンテキスト が使用されるすべての テスト または ジェネレータ の基準となる枠組みを提供します。コンテキストは、 Querier (テストの実行者) のように単純な場合もあれば、 All Actors of a Type のように複雑な場合もあります。 Points: Grid などのジェネレータは、複数の位置またはアクタを返すコンテキストを使用できます。これにより、(定義したサイズと密度の) グリッドが各コンテキストの位置に作成されます。エンジンで提供されているコンテキストの他、 EnvQueryContext_BlueprintBase クラスを使用してブループリントで、または C++ コードを使用して、カスタム コンテキストを作成できます。

EnvQueryContext_Item

アイテム はジェネレータで生成されます。 EQS Testing Pawn を使用している場合、アイテムはエディタに表示される球体です。EnvQueryContext_Item は位置 (FVector) またはアクタ (AActor) のいずれかです。

EnvQueryContext_Querier

Querier は、この Environment Query を呼び出している ビヘイビア ツリーを 実行している AI コントローラーによって現在所有されているポーンです。コンテキストとして Querier を使用する可能性のある例として、AI キャラクターが使用できるアイテムについて AI キャラクターの周囲の環境を検索したい場合や、プレイヤーからのカバーを提供する場所を探したい場合、または単に AI がクエリを実行している現在の位置を特定したい場合が挙げられます。

[Generator (ジェネレータ)] タイプの [ Details (詳細) ] パネルでは、次のプロパティのコンテキストとして Querier を割り当てることができます。

ジェネレータ

プロパティ

Actors of Class

Search Center (検索センター)

Querier_SearchCenter.png

Current Location

Query Context (クエリ コンテキスト)

Querier_CurrentLocation.png

Points: Circle

Circle Center (円の中心)

Querier_Circle.png

Points: Cone

Center Actor (Center アクタ)

Querier_Cone.png

Points: Donut

Center (中心)

Querier_Donut.png

Points: Grid

Generate Around (周りに生成)

Querier_Grid.png

Points: Pathing Grid

Generate Around (周りに生成)

Querier_PathingGrid.png

EnvQueryContext_BlueprintBase

ブループリントで EnvQueryContext_BlueprintBase クラスを使用して、カスタム コンテキストを作成できます。このクラスでは、オーバーライド可能な 4 つの関数が提供されるため、クエリのテストで使用する独自のカスタム コンテキストを追加できます。

カスタム コンテキストを使用するには、次の手順を実行します。

  1. EnvQueryContext_BlueprintBase クラスの新規のブループリントを作成します。 BlueprintBase_Create.png

  2. EnvQueryContext_BlueprintBase で、[ Override (オーバーライド) ] をクリックして、使用する関数のタイプを選択します。 BlueprintBase_Function.png

各関数のオーバーライドの説明については、次の表を参照してください。

関数

説明

Provide Single Location (単一の位置を提供)

単一の位置 (ベクター) を返します。この位置は任意の方法で生成することができます。例えば、次の関数は、Querier から 1500 cm 以内で検出されたランダムなアクタ (Pawn、Vehicle など、DesiredObjectType 配列で検出されるアクタ) のトレース ヒット位置を返します。

ProvideSingleLocation.png

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

Provide Single Actor (単一のアクタを提供)

単一のアクタを返します。このアクタは任意の方法で検出することができます。この例では、関数が Player 0 で制御されたアクタを返します。

ProvideSingleActor.png

Provide Locations Set (一連の位置を提供)

位置 (ベクター) の配列を返します。これらの位置は任意の方法で生成できます。この例では、関数が、環境上でのヒットを返しながら、半径が 1500 ユニットの円上で均等に間隔をあけて 16 の位置からトレースします。

ProvideLocationsSet.png

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

Provide Actors Set (一連のアクタを提供)

アクタの配列を返します。これらのアクタは任意の方法で取得できます。この例では、Get All Actors of Class ノードを使用して、返すアクタとして指定したクラスを取得します。

ProvideActorsSet.png

Unreal Engine のドキュメントを改善するために協力をお願いします！どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
閉じる