Unreal Engine の動的アセットの選択 | Unreal Engine 5.7 ドキュメンテーション

プロキシ 、プロキシテーブル およびチューザーテーブル のアセットを組み合わせて、動的アセットの選択ロジックを作成し、プロジェクトの変数に基づいてアニメーションを制御できます。たとえば、プロキシアセットとプロキシテーブルアセットを使用すると、さまざまな武器セットなど、キャラクターのためにロードおよび使用されるアニメーションセットの種類を選択できます。または、チューザーテーブルを使用して、キャラクターが攻撃された場所に基づいたさまざまなヒットリアクションなど、個別のアニメーションアセットをプロジェクトのコンテキスト変数によって動的に選択できます。

以下のドキュメントで、Unreal Engine の動的アニメーションの選択システムの詳細についてご確認ください。

このドキュメントは、アニメーションシーケンス、モンタージュまたは AnimInstance クラスなどのアニメーションに関連したアセットの選択にチューザーテーブルとプロキシテーブルを使用することに重点を置いていますが、システム自体は汎用的で、アセット、オブジェクトまたはクラスのタイプの選択に使用できます。

前提条件

Chooser プラグインを有効にします。 メニューバー から [Edit (編集)] >[Plugins (プラグイン)] の順に選択し、[Animation (アニメーション)] セクションで [Chooser (チューザー)] を見つけるか、検索バー を使用して検索します。このプラグインを有効にして、エディタを再起動します。
プロジェクトには、ランタイム時の状況に応じて動的に選択するアニメーションセットが含まれています。これは、一意の装飾的なアニメーションセット、コンテキストアニメーションシナリオなどの関連ゲームプレイアニメーション、または武器などの装備可能なアイテムに関連するアニメーションセットです。
プロジェクトには、使用可能なアニメーションブループリントが含まれていて、動的なアニメーション選択ロジックを作成できます。

アニメーション選択システムを設定する

ここでは、プロジェクトにアニメーションチューザーシステムを設定し、ランタイム時のプロジェクトのコンテキストに基づいてヒットリアクションのアニメーション再生を動的に選択する方法を確認できます。

プロキシアセットを作成する

プロキシアセット は、どのプロキシテーブルアセットがアクティブであるかについてのコンテキスト情報や、その他の関連変数を格納するために使用されます。

プロキシアセットを作成するには、コンテンツブラウザ の [+Add (+追加)] を使用して、 [Miscellaneous (その他)] > [Proxy Asset (プロキシアセット)] に移動します。

動的にアニメーションを選択する各アニメーションセット用にプロキシアセットを作成して、アイドル、歩く、走るなど、キャラクターを制御します。

プロキシアセットを作成した後で、それぞれを開いて設定にアクセスします。

それぞれのプロキシアセットで使用しているアニメーションアセットタイプに [Type (型)] プロパティを設定します。この場合は AnimSequenceBase です。

[Context Data (コンテキストデータ)] プロパティをアニメーションブループリント オプションに設定します。これには、Context Object Type Class オプションを選択して、[+ Add (+追加)] で新しいインデックス 配列を追加します。

インデックス 配列の設定を展開して、アニメーションブループリントを使用するように Class プロパティを設定します。この場合は ABP_Manny です。次に、Direction プロパティが Read に設定されていることを確認します。

アニメーションブループリントの設定

プロキシアセットを設定した後、キャラクターのアニメーションブループリントに変数を作成して、ランタイム時にアクティブなプロキシテーブルを格納する必要があります。この変数を作成するには、キャラクターのアニメーションブループリントを開き、[+ Add (+追加)] を使用して、[My Blueprint (マイブループリント)] パネルで新しい変数を作成します。次に、変数の型を Proxy Table Object Reference に設定します。変数を作成した後、アニメーションブループリントを保存および コンパイル します。

プロキシテーブル変数は Evaluate Proxy ノードによってアニメーショングラフで使用され、ランタイム時にアクティブなプロキシテーブルを決定します。

プロキシテーブルアセットを作成する

プロキシテーブル アセットは、ランタイムに動的に選択できるアニメーションアセットセットの格納に使用されます。たとえば、キャラクターのアイドルアニメーションを格納するプロキシテーブルもあれば、歩くまたは走るアニメーションセットを格納するプロキシテーブルもあります。

プロキシテーブルアセットを作成するには、コンテンツブラウザ の [+Add (+追加)] を使用して、 [Miscellaneous (その他)] > [Proxy Table (プロキシテーブル)] に移動します。

非武装のキャラクターおよびピストルやライフルを持ったキャラクターのロコモーションアニメーションなど、さまざまなアニメーションセットが必要なすべての状況用に、プロキシテーブルアセットを作成します。

プロキシテーブルアセットを作成した後で、アセットを開いてプロキシテーブルの値にアクセスします。

[ProxyTable (プロキシテーブル)] で、[+Add Row (行を追加)] を使用してアセットを選択し、各プロキシアセット にエントリを追加します。 [Value (値)] 列を使用して、設定から関連するアニメーションアセットを割り当てることができます。

以下のワークフロー例では、ProxyTable_Unarmed アセットは、Unarmed_Idle に割り当てられ、Unarmed_Walk アニメーションは、ProxyAsset_Idle と ProxyAsset_Walk の各行に割り当てられています。次に、ProxyTable_Pistol アセットでは、同じプロキシアセット行が Pistol_Idle と Pistol_Walk アニメーションに割り当てられています。

ProxyTable_Unarmed	ProxyTable_Pistol

[Value (値)] 列には、より動的なアニメーション選択システムに対して、 クラス 参照、チューザーアセット 、または ルックアッププロキシ が含まれている場合もあります。

プロキシテーブルをランタイム時に使用する

Sequence Player ノードでアニメーションノード関数を使用して、プロキシテーブルアセットをランタイムに使用できます。新しい関数を作成してプロキシテーブルアセットを選択するには、Sequence Player ノードを選択し、On Update バインディングで新しい関数を追加します。

On Update ノードから Evaluate Proxy ノードを追加します。

次に、ノードを選択し、ドロップダウンを使用して Proxy プロパティでプロキシアセットを選択します。

次に結果を変数に昇格させ、出力を Sequence Player ノードにつなげます。

その後、チューザーテーブルなど、さまざまな方法を使用して Evaluate Proxy ノードでアクティブなプロキシテーブルアセットを設定して、キャラクターを制御するアニメーションセットを動的に変更できます。

チューザーテーブルアセットを作成する

チューザーアセットは、コンテキストに基づいて選択および再生できる、さまざまなアニメーションのイテレーションから構成されるアニメーションデータセットの格納に使用されます。たとえば、チューザーテーブルは一連のヒットリアクションのアニメーションが含まれる場合があり、各エントリは攻撃されているボディの各部分 (腕、脚、胸、頭) に基づいて反応するアニメーションです。これは、ヒットの位置など、コンテキスト変数に基づいて選択できます。

チューザーテーブルアセットを作成するには、コンテンツブラウザ の [+Add (+ 追加)] を使用して、[Miscellaneous (その他)] > [Chooses Table (チューザーテーブル)] に移動します。

チューザーテーブルを作成した後で、アセットを開いてそのプロパティにアクセスできます。

[+Add (+追加)] を使用し、Context Data プロパティで新しい配列要素を作成して、プロパティを Context Object Type Class オプションに設定します。次に、インデックス配列を展開して、Class プロパティを自分のキャラクターのアニメーションブループリントに設定し、Direction プロパティが Read に設定されていることを確認します。使用しているアニメーションアセットに出力オブジェクトタイプを設定できます。このワークフローの例は、アニメーションシーケンスを使用しているので、AnimSequenceBase クラスオプションが選択されています。

[Chooser Table (チューザーテーブル)] パネルで、選択プロセスに影響を与えるアニメーションブループリントから変数を設定するために、[+Add Column (列を追加)] ボタンを使用して列の追加を開始します。列を作成した後で、選択に影響できるアニメーションブループリントの変数、および各行内でアニメーションシーケンスアセットを選択するためにアクセスする必要がある変数の値または状態を定義できます。

このワークフローの例では、ブール変数 IsCrouching は、値が false の場合は MM_HangingIdle アニメーションを選択し、値が true の場合は MM_Rifle_Walk_Left を選択します。 MoveemntAngle 変数は、値が -100 と 100 の間の場合に MM_HangingIdle を選択し、値が 0.0 の場合にのみ MM_Rilfe_Walk_Left アニメーションを選択します。