はじめに

AbilityTask は GameplayAbility の実行中に実行できる自己完結型のタスクです。タスクは「何かを開始し、イベントを受信、または終了するまで待つ」という非同期処理を提供します。これらはアビリティの実装自由度、柔軟性を高めてくれる非常に重要な要素となります。

自己完結型とは

アビリティの BP グラフ内でイベントをバインドする必要はありません！グラフは非常にシンプルになります。
ネットワーク処理もタスクに内包されます（対応していないものもあります）。
処理がタスク毎に分割され、依存が小さく再利用しやすい設計になります。

エンジンから提供される AbilityTask

AbilityTask は BP での実装が出来ず、C++ で書くしかありません。GameplayAbility が BP プロジェクトをサポートできないのも、この辺が原因にあるなぁ、と思ったり。しかしプラグイン内には汎用的に使えるタスクが最初から数多く実装されています！今回はそれらについて紹介します。
タスクの作成については次の記事に続きます。

使ったことがないタスクは項目だけ作って説明を省いてます。そのうち使ったら埋める。かも。

PlayMontageAndWait

アニメーション（Montage）を再生し、終了を待つ。BlendOut（OnCompleted）/Interrupted/Cancelled から EndAbility に繋ぐことが多い。BlendOut -> OnCompleted と呼ばれる、どちらに繋げるかはゲームデザインによる（片方だけで OK）。
おそらく GAS 使いで最も使用頻度が高いタスクではなかろうか。もはや AbilityTask と意識することなく使っているかもしれない。

AbilitySystem で MontageInfo が管理されているので、アビリティで Montage を再生する場合は（PlayMontage その他ではなく）このノードを使う。アビリティ終了時に再生を停止、再生位置の同期、AbilitySystem,GameplayAbility の Montage 関数での操作、などに影響する。

WaitGameplayEvent

指定した EventTag と一致する GameplayEvent を待機する。EventTag は GameplayTag なので、階層をまとめて監視することも可能（その場合は OnlyMatchExact のチェックを外す）。Event.Damage で待ち受けておいて、Event.Damage.Slash, Event.Damage.Blow を受け取るなど。OptionalExternalTarget は他者のイベント（敵のダメージなど）を取得したいときに指定する。

WaitGameplayTagAdd / WaitGameplayTagRemove

GameplayTag の付与/削除を通知する。GameplayTag は GameplayAbility.ActivationOwnedTags, GameplayEffect.GrantedTags, AddLooseGameplayTags など、いろんなところで付与されるので多様なイベントが取れる半面、管理は難しいかもしれない。GameplayEffect.GrantedTags は AssetSearch でも検索に引っかからないしな！そうなるともうコールスタック追いかけるしかない。。GameplayTag のご利用は計画的に。

AbilitySystem で管理された GameplayTag はスタックするが、WaitGameplayTagAdd/Remove での通知はスタック状態を無視する（スタック数が 0-1 の時のみ通知される）ので注意。

WaitInputPress / WaitInputRelease

アビリティに紐づけられた入力の押下/離上で通知される。中の処理で通信の同期まで取ってくれる結構すごいやつ。
TestAlready~ にチェックを入れると、既に条件を満たした場合そのまま通知してくれます。

入力のセットアップについて補足

初期状態ではアビリティに対してイベントがバインドされておらず、入力の通知を受け取ることができません。

https://t.co/AgtR3eV8ST
4.6.2 Binding Input to the ASC にInputPressed/Releasedへの実装が書いてあります。ちょっとこの辺は仕様がややこしいですね。。GiveAbilityで渡すFGameplayAbilitySpecに指定するInputIDが一致してればAbilityTaskのInputPressedでイベントが発行されるって感じです。
— あいす (@koorinonaka) December 23, 2021

UAbilitySystemComponent::BindAbilityActivationToInputComponent の部分は、自分は以下のように簡略しました。

MyPlayerController.cpp

void AMyPlayerController::SetupInputComponent()
{
	Super::SetupInputComponent();

	InputComponent->BindAxis( TEXT( "MoveForward" ) );
	...

	auto BindPressedAndReleased = [&]( FName ActionName, int32 InputID )
	{
		FInputActionBinding IABPressed( ActionName, IE_Pressed );
		IABPressed.ActionDelegate.GetDelegateForManualSet().BindWeakLambda( this,
			[this, InputID]
			{
				if ( UAbilitySystemComponent* ASC = UAbilitySystemGlobals::GetAbilitySystemComponentFromActor( GetPawn() ) )
				{
					ASC->AbilityLocalInputPressed( InputID );
				}
			} );
		InputComponent->AddActionBinding( IABPressed );

		FInputActionBinding IABReleased( ActionName, IE_Released );
		IABReleased.ActionDelegate.GetDelegateForManualSet().BindWeakLambda( this,
			[this, InputID]
			{
				if ( UAbilitySystemComponent* ASC = UAbilitySystemGlobals::GetAbilitySystemComponentFromActor( GetPawn() ) )
				{
					ASC->AbilityLocalInputReleased( InputID );
				}
			} );
		InputComponent->AddActionBinding( IABReleased );
	};
	// ActionNameはプロジェクト設定->インプット->アクションマッピング、DefaultInput.iniで定義する名前
	BindPressedAndReleased( TEXT( "Jump" ), (int32) EMyAbilitySlot::Jump );
	...
}

MyAbilitySystemComponent.cpp

TSubclassOf<UGameplayAbility> AbilityClass;
int32 AbilityLevel = 1;
// FGameplayAbilitySpecの第3引数にInputIDを渡す
GiveAbility( FGameplayAbilitySpec( AbilityClass, AbilityLevel, (int32) EMyAbilitySlot::Jump, this ) );

ActionName と InputID（Enum で定義する）を結び付けます。
※アビリティは単一の入力を受け付けるように設計されています。複数の入力を受け取ることはできません。

WaitConfirm

WaitForCancelInput / WaitForConfirmInput

WaitForAbilityActivate / WaitForAbilityActivate_Query / WaitForAbilityActivateWithTagRequirements

他のアビリティの開始を待つ。ActivatedAbility としてインスタンスも取得できるので、そこからさらにバインドしたり、など。

WaitForNewAbilityCommit / WaitForAbilityCommit_Query

アビリティのコミット（消費）を待つ。

アビリティは発動したときに自動で消費されるわけではなく、CommitAbility を明示的に呼んで初めて消費が実行される。

StartAbilityState

StateName の状態をアビリティ内に作ることができる。EndCurrentState にチェックを入れて新しく State を始める、もしくは EndAbilityState を呼ぶことで OnStateEnded が呼ばれる。排他処理に利用できる。

WaitForAttributeChange / WaitForAttributeChangeWithComparison

指定した Attribute（AttributeSet のパラメータ）の値が変化したときに通知される。WithComparison は、ComparisonValue との比較で一致した（ComparisonType で指定、N 値以下、以上など）とき通知が発行される。OptionalExternalOwner から、他者（敵とか）を指定することもできる。

Wait for Attribute Changed は別物なので注意

こっちは AbilityTask ではなく AbilityAsync ノード。アビリティ外部（UI など）でも呼び出し可能。アビリティでは WaitForAttributeChange を使いましょう。

WaitForAttributeChangeThreshold / WaitForAttributeChangeRatioThreshold

閾値（ComparisonValue）と比較して条件が一致したときに通知される。
ChangeThreshold はタスクの実行時に比較が実行され通知される点を除いて WaitForAttributeChangeWithComparison とほとんど同じ。
ChangeRatioThreshold は比率値（Numerator / Denominator）との比較で通知される。（現在 HP / 最大 HP）が N 以下になったとき、などを想定。

WaitGameplayEffectAppliedToSelf / WaitGameplayEffectAppliedToTarget

GameplayEffect の適用が通知される。
WaitGameplayEffectAppliedToSelf_Query, WaitGameplayEffectAppliedToTarget_Query も存在する。

WaitForGameplayEffectRemoved

GameplayEffect の削除が通知される。引数には FActiveGameplayEffectHandle を指定する必要があるので、その場で取得できない場合は WaitGameplayEffectApplied で ActiveHandle を受け取るなどする必要がある。

WaitForGameplayEffectStackChange

既に発動済みのエフェクトに対して、スタックが変化したときに通知される。

WaitGameplayEffectBlockedByImmunity

GameplayEffect を適用したとき、Immunity（免疫、レジスト）により発動しなかったときに通知される。

ApplyRootMotion

RootMotion といえばアニメアセットから参照するルート移動の方を想像します（すると思う）が、実はプログラムから直接呼び出すこともできます。こういった移動処理は挙動も調整しやすいように自前で実装する方も多いと思いますが、マルチプレイでもきれいに同期をとって動作してくれるのがポイントです。

ApplyRootMotionConstantForce

定量（Force）の移動値を与える。IsAdditive が false の場合は Velocity を上書きするような挙動になります。VelocityOnFinish でタスク終了時の Velocity を調整できる。

Duration はその期間で力を加え続けるわけではなく、間隔をあけて再度処理が走るような挙動となる（Force が切れたタイミングかな？）。

ApplyRootMotionJumpForce

一定時間（Duration）で指定の高さ（Height）と指定方向（Rotation）への距離（Distance）でジャンプする。時間を長くすれば軌道は緩やかに、高さはきっちりぶれずに指定できる、など。調整値を指定できるのは便利（逆計算いらず！）ですが、慣性や減衰は働かないので動きは固くなります。カーブアセットでその辺も調整できるかな？

ApplyRootMotionMoveToActorForce

TargetActor に向かって指定時間（Duration）をかけて移動する。ただの線形移動なのでぬるっと動く（TargetLerpSpeed で調整できると思う）。ターゲット位置が移動すると追従します。TargetData で指定する ApplyRootMotionMoveToTargetDataActorForce も存在する。

縦になが～い！！個人的に愛用している BlueprintAssist さんから怒られるんだよね。

ApplyRootMotionMoveToForce

Location に向かって指定時間（Duration）をかけて移動する。MoveToActorForce の追従なし版。

ApplyRootMotionRadialForce

指定位置（Location/LocationActor）から発生する力（Strength、Radiusにより減衰する）を加える。これも Duration は ConstantForce と似た挙動だったかな？時間は 0.01 など短く指定する。IsPush を false にすると引き寄せとなるのが面白いところ。グラビティホール！！

MoveToLocation

Location に向かって指定時間（Duration）をかけて移動する。ApplyRootMotionMoveToForce と挙動はほぼ一緒、と思うじゃない？中身は SetActorLocation でテレポート（bSweep=false）してるから結構危険なんだな。コリジョン内部でスタックしちゃうので気を付けましょう。。ｗ