第一次提交

Plugins/GCS/Source/GenericGameplayAbilities/Public/AsyncTasks/GGA_AsyncTask_AttributeChanged.h

@@ -0,0 +1,47 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "AbilitySystemComponent.h"
+#include "Abilities/Async/AbilityAsync.h"
+#include "GGA_AsyncTask_AttributeChanged.generated.h"
+
+DECLARE_DYNAMIC_MULTICAST_DELEGATE_ThreeParams(FOnAttributeChanged, FGameplayAttribute, Attribute, float, NewValue, float, OldValue);
+
+/**
+ * 蓝图节点，用于监听AbilitySystemComponent上的属性变化。
+ * 一般用于UI。
+ */
+UCLASS()
+class GENERICGAMEPLAYABILITIES_API UGGA_AsyncTask_AttributeChanged : public UAbilityAsync
+{
+	GENERATED_BODY()
+
+public:
+	UPROPERTY(BlueprintAssignable)
+	FOnAttributeChanged OnAttributeChanged;
+
+	// Listens for an attribute changing.
+	UFUNCTION(BlueprintCallable, Category = "GGA|Tasks", meta = (BlueprintInternalUseOnly = "true"))
+	static UGGA_AsyncTask_AttributeChanged* ListenForAttributeChange(UAbilitySystemComponent* AbilitySystemComponent, FGameplayAttribute Attribute);
+
+	// Listens for an attribute changing.
+	// Version that takes in an array of Attributes. Check the Attribute output for which Attribute changed.
+	UFUNCTION(BlueprintCallable, Category = "GGA|Tasks", meta = (BlueprintInternalUseOnly = "true"))
+	static UGGA_AsyncTask_AttributeChanged* ListenForAttributesChange(UAbilitySystemComponent* AbilitySystemComponent, TArray<FGameplayAttribute> Attributes);
+
+	// You must call this function manually when you want the AsyncTask to end.
+	// For UMG Widgets, you would call it in the Widget's Destruct event.
+	UFUNCTION(BlueprintCallable, Category = "GGA|Tasks", meta=(DeprecatedFunction, DeprecationMessage="Use EndAction"))
+	void EndTask();
+
+protected:
+	virtual void Activate() override;
+	virtual void EndAction() override;
+
+	FGameplayAttribute AttributeToListenFor;
+	TArray<FGameplayAttribute> AttributesToListenFor;
+
+	void AttributeChanged(const FOnAttributeChangeData& Data);
+};