虚幻GameAbilitySystem源码与设计解析-GameEffect中的结构体
// Copyright Epic Games, Inc. All Rights Reserved. #pragma once #include "CoreMinimal.h" #include "UObject/ObjectMacros.h" #include "UObject/Object.h" #include "UObject/Class.h" #include "Templates/SubclassOf.h" #include "Engine/NetSerialization.h" #include "Engine/EngineTypes.h" #include "GameplayTagContainer.h" #include "Engine/CurveTable.h" #include "AttributeSet.h" #include "EngineDefines.h" #include "GameplayEffectTypes.h" #include "GameplayEffectAggregator.h" #include "GameplayPrediction.h" #include "GameplayTagAssetInterface.h" #include "GameplayAbilitySpec.h" #include "ActiveGameplayEffectIterator.h" #include "UObject/ObjectKey.h" #include "VisualLogger/VisualLoggerDebugSnapshotInterface.h" #include "VisualLogger/VisualLoggerTypes.h"
第一个结构体
似乎是用于设置编辑器中的计算方式，常用
1 UENUM() 2 enum class EGameplayEffectMagnitudeCalculation : uint8 3 { 4 //预先设置好的固定数值。 5 ScalableFloat, 6 //基于属性执行计算 7 AttributeBased, 8 //执行自定义计算，能够在蓝图（BP）或原生代码中捕捉并作用于多个属性。 9 CustomCalculationClass, 10 //此数值将由创建该规格的代码 / 蓝图显式设置。 11 SetByCaller, 12 };
第二个结构体
1 /** 概述可能的基于属性的浮点数计算策略的枚举。 */ 2 UENUM() 3 enum class EAttributeBasedFloatCalculationType : uint8 4 { 5 /** 使用属性最终计算得出的数值。 */ 6 AttributeMagnitude, 7 /** 使用属性的基础值。 */ 8 AttributeBaseValue, 9 /** 使用属性的“额外”计算数值：等同于（最终数值 - 基础值）。 */ 10 AttributeBonusMagnitude, 11 /** 使用计算得出的数值，计算截止到指定的“最终通道”评估环节。 */ 12 AttributeMagnitudeEvaluatedUpToChannel 13 };
第三个结构体
1 UENUM() 2 enum class EGameplayEffectVersion : uint8 3 { 4 //// 虚幻引擎 5.3 之前的旧版本（在我们开始进行版本管理之前） 5 Monolithic, 6 // 虚幻引擎 5.3 中可用的新模块化版本 7 Modular53, 8 // 授予的能力被移至能力组件中 9 AbilitiesComponent53, 10 // 当前版本 = 能力组件 5.3 版本 11 Current = AbilitiesComponent53 12 };
第四个结构体
1 struct GAMEPLAYABILITIES_API FGameplayEffectConstants 2 { 3 /** 无限持续时间 */ 4 static const float INFINITE_DURATION; 5 6 /** 无持续时间；表示效果立即应用的时间 */ 7 static const float INSTANT_APPLICATION; 8 9 /** 常量，指定战斗效果没有周期，并且不检查随时间的应用情况 */ 10 static const float NO_PERIOD; 11 12 /** 无效等级/等级未设置 */ 13 static const float INVALID_LEVEL; 14 };
第五个结构体
FAttributeBasedFloat 结构体用于表示一个基于属性的浮点数，其数值大小由一个关联属性和特定的计算策略共同决定。这种设计在游戏开发中非常有用，例如可以根据角色的某个属性（如攻击力、防御力等）来动态计算一个数值（如伤害值、减伤比例等）。
/** * 结构体表示一个浮点数，其数值大小由一个关联属性和一种计算策略决定，基本形式如下： * (系数 * (乘法前累加值 + [根据策略计算得出的属性值])) + 乘法后累加值 */ USTRUCT() struct FAttributeBasedFloat { GENERATED_USTRUCT_BODY() public: /** 构造函数 */ FAttributeBasedFloat() : 系数(1.0f) , 乘法前累加值(0.0f) , 乘法后累加值(0.0f) , 关联属性() , 属性计算类型(EAttributeBasedFloatCalculationType::AttributeMagnitude) , 最终通道(EGameplayModEvaluationChannel::Channel0) {} /** * 根据指定的游戏玩法效果规格计算并返回该浮点数的数值大小。 * * @注意: 此函数假设（并通过断言检查）规格中存在所需的捕获属性。 * 调用者有责任在调用此函数之前验证规格是否已正确设置。 * * @param InRelevantSpec 提供关联属性捕获的游戏玩法效果规格 * * @return 根据规格和计算策略计算得出的数值 */ float CalculateMagnitude(const FGameplayEffectSpec& InRelevantSpec) const; /** 属性计算的系数 */ UPROPERTY(EditDefaultsOnly, Category=AttributeFloat) FScalableFloat 系数; /** 属性计算的累加值，在系数应用之前添加 */ UPROPERTY(EditDefaultsOnly, Category=AttributeFloat) FScalableFloat 乘法前累加值; /** 属性计算的累加值，在系数应用之后添加 */ UPROPERTY(EditDefaultsOnly, Category=AttributeFloat) FScalableFloat 乘法后累加值; /** 作为计算基础的属性 */ UPROPERTY(EditDefaultsOnly, Category=AttributeFloat) FGameplayEffectAttributeCaptureDefinition 关联属性; /** 如果指定了曲线表条目，属性将用于在曲线中查找值，而不是直接使用属性值。 */ UPROPERTY(EditDefaultsOnly, Category=AttributeFloat) FCurveTableRowHandle 属性曲线; /** 关于属性的计算策略 */ UPROPERTY(EditDefaultsOnly, Category=AttributeFloat) EAttributeBasedFloatCalculationType 属性计算类型; /** 当使用 AttributeEvaluatedUpToChannel 计算类型时，用于终止评估的通道 */ UPROPERTY(EditDefaultsOnly, Category=AttributeFloat) EGameplayModEvaluationChannel 最终通道; /** 用于源标签的过滤器；如果指定，只有带有所有这些标签的修饰符才会纳入计算 */ UPROPERTY(EditDefaultsOnly, Category=AttributeFloat) FGameplayTagContainer 源标签过滤器; /** 用于目标标签的过滤器；如果指定，只有带有所有这些标签的修饰符才会纳入计算 */ UPROPERTY(EditDefaultsOnly, Category=AttributeFloat) FGameplayTagContainer 目标标签过滤器; /** 相等/不相等运算符 */ bool operator==(const FAttributeBasedFloat& Other) const; bool operator!=(const FAttributeBasedFloat& Other) const; };
默认值 这个在菜单中很常见，实际上是菜单中的选项
FAttributeBasedFloat() : Coefficient(1.f) , PreMultiplyAdditiveValue(0.f) , PostMultiplyAdditiveValue(0.f) , BackingAttribute() , AttributeCalculationType(EAttributeBasedFloatCalculationType::AttributeMagnitude) , FinalChannel(EGameplayModEvaluationChannel::Channel0) {}
属性成员
重载了相等和不相等运算符，用于比较两个FAttributeBasedFloat结构体是否相等。
bool operator==(const FAttributeBasedFloat& Other) const; bool operator!=(const FAttributeBasedFloat& Other) const;
重载了相等和不相等运算符，用于比较两个
![]()
FSetByCallerFloat（SetByCaller）
![]()
FGameplayEffectModifierMagnitude
FCustomCalculationBasedFloat 结构体是否相等，方便在代码中进行结构体的比较操作。
bool operator==(const FCustomCalculationBasedFloat& Other) const; bool operator!=(const FCustomCalculationBasedFloat& Other) const;
第七个结构体
FSetByCallerFloat 结构体用于存储那些由调用者（可以是代码或者蓝图）来设置具体数值的数据相关信息。在游戏开发里，有时需要让外部调用者动态地为某些数据赋予特定值，这个结构体就提供了一种方式来管理这些数据的标识和相关标签。
/** 用于保存由调用者设置数据的结构体 */ USTRUCT() struct FSetByCallerFloat { GENERATED_USTRUCT_BODY() FSetByCallerFloat() : DataName(NAME_None) {} /** 调用者（代码或蓝图）用于设置此数值大小的名称。 */ UPROPERTY(VisibleDefaultsOnly, Category=SetByCaller) FName DataName; /** 在编辑器中仅可编辑一次，属于 SetByCaller 类别，元数据指定标签类别为 "SetByCaller" */ UPROPERTY(EditDefaultsOnly, Category = SetByCaller, meta = (Categories = "SetByCaller")) FGameplayTag DataTag; /** 相等/不相等运算符 */ bool operator==(const FSetByCallerFloat& Other) const; bool operator!=(const FSetByCallerFloat& Other) const; };
构造函数对结构体的 DataName 成员进行初始化，将其设置为 NAME_None，这是 FName 类型的一个特殊值，表示空名称。
FSetByCallerFloat()
: DataName(NAME_None)
{}
bool operator==(const FSetByCallerFloat& Other) const; bool operator!=(const FSetByCallerFloat& Other) const;
重载了相等和不相等运算符，用于比较两个 FSetByCallerFloat 结构体是否相等。这样在代码中就可以方便地判断两个此类结构体是否具有相同的 DataName 和 DataTag 等内容。
第八个结构体
/** 结构体表示游戏玩法效果修饰符的数值大小，可能通过多种不同方式计算得出 */ USTRUCT() struct GAMEPLAYABILITIES_API FGameplayEffectModifierMagnitude { GENERATED_USTRUCT_BODY() public: /** 默认构造函数 */ FGameplayEffectModifierMagnitude() : MagnitudeCalculationType(EGameplayEffectMagnitudeCalculation::ScalableFloat) { } /** 在代码中设置值的构造函数（用于自动化测试） */ FGameplayEffectModifierMagnitude(const FScalableFloat& Value) : MagnitudeCalculationType(EGameplayEffectMagnitudeCalculation::ScalableFloat) ,ScalableFloatMagnitude(Value) { } FGameplayEffectModifierMagnitude(const FAttributeBasedFloat& Value) : MagnitudeCalculationType(EGameplayEffectMagnitudeCalculation::AttributeBased) , AttributeBasedMagnitude(Value) { } FGameplayEffectModifierMagnitude(const FCustomCalculationBasedFloat& Value) : MagnitudeCalculationType(EGameplayEffectMagnitudeCalculation::CustomCalculationClass) , CustomMagnitude(Value) { } FGameplayEffectModifierMagnitude(const FSetByCallerFloat& Value) : MagnitudeCalculationType(EGameplayEffectMagnitudeCalculation::SetByCaller) , FSetByCallerFloat(Value) { } /** * 判断使用指定的游戏玩法效果规格是否能正确计算出数值大小（如果依赖的属性不存在等情况可能会失败） * * @param InRelevantSpec 用于检查数值计算的游戏玩法效果规格 * * @return 是否能正确计算出数值大小 */ bool CanCalculateMagnitude(const FGameplayEffectSpec& InRelevantSpec) const; /** * 尝试根据提供的规格计算数值大小。如果规格中缺少必要信息（如捕获的属性），计算可能会失败。 * * @param InRelevantSpec 用于计算数值大小的游戏玩法效果规格 * @param OutCalculatedMagnitude [输出] 计算得出的数值大小，计算失败时将被设置为 0.0f * * @return 如果计算成功返回 true，否则返回 false */ bool AttemptCalculateMagnitude(const FGameplayEffectSpec& InRelevantSpec, OUT float& OutCalculatedMagnitude, bool WarnIfSetByCallerFail = true, float DefaultSetbyCaller = 0.f) const; /** 尝试根据变更的聚合器重新计算数值大小。只有当我们是与给定聚合器关联（非快照）的修饰符时才会重新计算。 */ bool AttemptRecalculateMagnitudeFromDependentAggregatorChange(const FGameplayEffectSpec& InRelevantSpec, OUT float& OutCalculatedMagnitude, const FAggregator* ChangedAggregator) const; /** * 收集计算数值大小所需的所有属性捕获定义，并将它们放入提供的数组中 * * @param OutCaptureDefs [输出] 填充了必要属性捕获定义的数组 */ void GetAttributeCaptureDefinitions(OUT TArray<FGameplayEffectAttributeCaptureDefinition>& OutCaptureDefs) const; EGameplayEffectMagnitudeCalculation GetMagnitudeCalculationType() const { return 数值计算类型; } /** 如果可能，返回数据中输入的数值大小。仅适用于可缩放浮点数或任何无需上下文即可返回数据的类型 */ bool GetStaticMagnitudeIfPossible(float InLevel, float& OutMagnitude, const FString* ContextString = nullptr) const; /** 如果该数值是由调用者设置的，返回与之关联的数据名称 */ bool GetSetByCallerDataNameIfPossible(FName& OutDataName) const; /** 返回由调用者设置的数据结构，用于检查目的 */ const FSetByCallerFloat& GetSetByCallerFloat() const { return 由调用者设置的数值; } /** 如果存在，返回此数值的自定义数值计算类。仅适用于自定义数值 */ TSubclassOf<UGameplayModMagnitudeCalculation> GetCustomMagnitudeCalculationClass() const; /** 实现 Serialize 以清除对不需要的资产的引用 */ bool Serialize(FArchive& Ar); bool operator==(const FGameplayEffectModifierMagnitude& Other) const; bool operator!=(const FGameplayEffectModifierMagnitude& Other) const; #if WITH_EDITOR FText GetValueForEditorDisplay() const; void ReportErrors(const FString& PathName) const; #endif protected: /** 用于推导数值大小的计算类型 */ UPROPERTY(EditDefaultsOnly, Category = Magnitude) EGameplayEffectMagnitudeCalculation MagnitudeCalculationType; /** 由可缩放浮点数表示的数值大小 */ UPROPERTY(EditDefaultsOnly, Category = Magnitude) FScalableFloat ScalableFloatMagnitude; /** 由基于属性的浮点数表示的数值大小 (系数 * (乘法前累加值 + [根据策略计算得出的属性值])) + 乘法后累加值 */ UPROPERTY(EditDefaultsOnly, Category = Magnitude) FAttributeBasedFloat AttributeBasedMagnitude; /** 由自定义计算类表示的数值大小 */ UPROPERTY(EditDefaultsOnly, Category = Magnitude) FCustomCalculationBasedFloat CustomMagnitude; /** 由调用者设置的数值大小 */ UPROPERTY(EditDefaultsOnly, Category = Magnitude) FSetByCallerFloatSetByCallerMagnitude; friend class UGameplayEffect; friend class FGameplayEffectModifierMagnitudeDetails; };
整体功能
构造函数
方法
友元类
第九个结构体
template<> struct TStructOpsTypeTraits<FGameplayEffectModifierMagnitude> : public TStructOpsTypeTraitsBase2<FGameplayEffectModifierMagnitude> { enum { WithSerializer = true, }; };
模板特化
template<>
struct TStructOpsTypeTraits<FGameplayEffectModifierMagnitude>
这是一个模板特化的语法。template<> 表示这不是一个普通的模板定义，而是针对特定类型 FGameplayEffectModifierMagnitude 的特化版本。也就是说，对于 FGameplayEffectModifierMagnitude 这个结构体
TStructOpsTypeTraits 会有特定的行为，而不是使用通用的模板定义。
继承了
TStructOpsTypeTraitsBase2: public TStructOpsTypeTraitsBase2<FGameplayEffectModifierMagnitude>
TStructOpsTypeTraitsBase2 是 Unreal Engine 提供的一个基础模板结构体，它包含了一些默认的结构体操作特性设置。通过继承 TStructOpsTypeTraitsBase2<FGameplayEffectModifierMagnitude>，可以复用其默认的特性设置，同时可以根据需要进行修改和扩展。
枚举设置操作特性
enum { WithSerializer = true, };
第十个结构体
/** 枚举，代表可用的作用域修饰符聚合器的使用类型 */ UENUM() enum class EGameplayEffectScopedModifierAggregatorType : uint8 { /** 聚合器由属性捕获支持 */ CapturedAttributeBacked, /** 聚合器完全是临时的（充当“临时变量”），必须通过游戏玩法标签来识别 */ Transient };
这段代码定义了一个名为 EGameplayEffectScopedModifierAggregatorType 的枚举类，用于表示作用域修饰符聚合器的不同使用类型。在游戏开发中，作用域修饰符聚合器通常用于管理和计算与游戏玩法效果相关的属性值，不同的使用类型决定了聚合器的工作方式和数据来源。
枚举值含义
void ApplyGameplayEffect(const EGameplayEffectScopedModifierAggregatorType aggregatorType) { if (aggregatorType == EGameplayEffectScopedModifierAggregatorType::CapturedAttributeBacked) { // 处理由属性捕获支持的聚合器 // 例如，从捕获的属性中获取数据并进行计算 } else if (aggregatorType == EGameplayEffectScopedModifierAggregatorType::Transient) { // 处理临时聚合器 // 例如，根据游戏玩法标签查找并使用临时聚合器 } }
第十一个结构体
/** * 结构体表示专门用于瞬时发生的“作用域”执行的修饰符信息。这些修饰符仅在计算期间纳入计算，绝不会永久添加到聚合器中。 */ USTRUCT(BlueprintType) struct FGameplayEffectExecutionScopedModifierInfo { GENERATED_USTRUCT_BODY() // 构造函数 FGameplayEffectExecutionScopedModifierInfo() : AggregatorType(EGameplayEffectScopedModifierAggregatorType::CapturedAttributeBacked) , ModifierOp(EGameplayModOp::Additive) {} FGameplayEffectExecutionScopedModifierInfo(const FGameplayEffectAttributeCaptureDefinition& InCaptureDef) : CapturedAttribute(InCaptureDef) , AggregatorType(EGameplayEffectScopedModifierAggregatorType::CapturedAttributeBacked) , ModifierOp(EGameplayModOp::Additive) { } FGameplayEffectExecutionScopedModifierInfo(const FGameplayTag& InTransientAggregatorIdentifier) : TransientAggregatorIdentifier(InTransientAggregatorIdentifier) , AggregatorType(EGameplayEffectScopedModifierAggregatorType::Transient) , ModifierOp(EGameplayModOp::Additive) { } //作用域修饰符所针对的支持属性 UPROPERTY(VisibleDefaultsOnly, Category=Execution) FGameplayEffectAttributeCaptureDefinition CapturedAttribute; //如果作为临时“临时变量”聚合器时，聚合器的标识符 UPROPERTY(VisibleDefaultsOnly, Category=Execution) FGameplayTag TransientAggregatorIdentifier; //支持作用域修饰的聚合器类型 UPROPERTY(VisibleDefaultsOnly, Category=Execution) EGameplayEffectScopedModifierAggregatorType AggregatorType; //要执行的修饰符操作 UPROPERTY(EditDefaultsOnly, Category=Execution) TEnumAsByte<EGameplayModOp::Type> ModifierOp; //作用域修饰符的数值大小 UPROPERTY(EditDefaultsOnly, Category=Execution) FGameplayEffectModifierMagnitude ModifierMagnitude; //作用域修饰符的评估通道设置 UPROPERTY(EditDefaultsOnly, Category=Execution) FGameplayModEvaluationChannelSettings EvaluationChannelSettings; //修饰符应用所需的源标签要求 UPROPERTY(EditDefaultsOnly, Category=Execution) FGameplayTagRequirements SourceTags; //修饰符应用所需的目标标签要求 UPROPERTY(EditDefaultsOnly, Category=Execution) FGameplayTagRequirements TargetTags; };
构造函数
成员变量
使用场景
第十一个结构体
USTRUCT(BlueprintType) struct GAMEPLAYABILITIES_API FConditionalGameplayEffect { GENERATED_USTRUCT_BODY() // 检查该条件GE是否可以应用 bool CanApply(const FGameplayTagContainer& SourceTags, float SourceLevel) const; //创建一个GESpec句柄 FGameplayEffectSpecHandle CreateSpec(FGameplayEffectContextHandle EffectContext, float SourceLevel) const; /** gameplay effect that will be applied to the target */ /** 将会应用到目标上的游戏玩法效果类 */ UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = GameplayEffect) TSubclassOf<UGameplayEffect> EffectClass; /** Tags that the source must have for this GE to apply. If this is blank, then there are no requirements to apply the EffectClass. */ /** 源对象必须拥有的标签，该GE才会应用。如果为空，则应用该效果类没有任何要求。 */ UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = GameplayEffect) FGameplayTagContainer RequiredSourceTags; bool operator==(const FConditionalGameplayEffect& Other) const; bool operator!=(const FConditionalGameplayEffect& Other) const; };
整体功能
成员函数
成员变量
第十二个结构体
FGameplayModifierInfo 结构体用于描述游戏玩法中的修饰符信息，它主要说明了要修改的目标（属性），但不涉及具体的修改逻辑实现。
在游戏开发中，这样的结构体可用于定义各种属性修改规则，比如角色属性的增益、减益效果等。
/** * 此修饰符的数值运算类型：覆盖、加法、乘法等 * 当多个修饰符聚合在一起时，计算公式为： * ((基础值 + 基础加法值) * 加法乘法因子 / 加法除法因子 * 复合乘法因子) + 最终加法值 */ UPROPERTY(EditDefaultsOnly, Category=GameplayModifier) TEnumAsByte<EGameplayModOp::Type> ModifierOp = EGameplayModOp::Additive; /** 修饰符的数值大小 */ UPROPERTY(EditDefaultsOnly, Category=GameplayModifier) FGameplayEffectModifierMagnitude ModifierMagnitude; /** 修饰符的评估通道设置 */ UPROPERTY(EditDefaultsOnly, Category=GameplayModifier) FGameplayModEvaluationChannelSettings EvaluationChannelSettings; UPROPERTY(EditDefaultsOnly, Category=GameplayModifier) FGameplayTagRequirements SourceTags; UPROPERTY(EditDefaultsOnly, Category=GameplayModifier) FGameplayTagRequirements TargetTags; /** 相等/不相等运算符 */ bool operator==(const FGameplayModifierInfo& Other) const; bool operator!=(const FGameplayModifierInfo& Other) const; };
成员变量
使用场景
第十三个结构体
/** * FGameplayEffectCue * 这是一种可以与 UGameplayEffect 关联的视觉或听觉提示。 * 本质上，它是一个游戏玩法标签加上一个最小/最大等级范围，用于将游戏玩法效果的等级映射到游戏玩法提示系统使用的归一化值。 */ USTRUCT(BlueprintType) struct FGameplayEffectCue { GENERATED_USTRUCT_BODY() // 默认构造函数 FGameplayEffectCue() : MinLevel(0.f) , MaxLevel(0.f) { } // 带参数的构造函数 FGameplayEffectCue(const FGameplayTag& InTag, float InMinLevel, float InMaxLevel) : MinLevel(InMinLevel) , MaxLevel(InMaxLevel) { GameplayCueTags.AddTag(InTag); } // 用作提示强度来源的属性。如果未指定，则使用等级 UPROPERTY(EditDefaultsOnly, Category = GameplayCue) FGameplayAttribute MagnitudeAttribute; // 此提示支持的最小等级 UPROPERTY(EditDefaultsOnly, Category = GameplayCue) float MinLevel; //此提示支持的最大等级 UPROPERTY(EditDefaultsOnly, Category = GameplayCue) float MaxLevel; // 当此提示激活时传递给游戏玩法提示处理器的标签 UPROPERTY(EditDefaultsOnly, Category = GameplayCue, meta = (Categories="GameplayCue")) FGameplayTagContainer GameplayCueTags; float NormalizeLevel(float InLevel) { float Range = MaxLevel - MinLevel; if (Range <= KINDA_SMALL_NUMBER) { return 1.f; } return FMath::Clamp((InLevel - MinLevel) / Range, 0.f, 1.0f); } };
FGameplayEffectCue 结构体用于定义与游戏玩法效果相关的视觉或听觉提示。
它通过游戏玩法标签和等级范围，将游戏玩法效果的等级映射为一个归一化值，这个归一化值可以被游戏玩法提示系统使用，以实现不同等级下的不同提示效果。
成员变量
构造函数
成员函数
使用场景
第十四个结构体
//用于以安全方式合并来自父蓝图和子蓝图标签的结构体 USTRUCT(BlueprintType) struct GAMEPLAYABILITIES_API FInheritedTagContainer { GENERATED_USTRUCT_BODY() //我继承的标签、我添加的标签减去我移除的标签 UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = Application, meta=(Tooltip="CombinedTags = Inherited - Removed + Added")) FGameplayTagContainer CombinedTags; //我拥有的标签（除了我父级的标签之外） UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = Application, meta=(DisplayName="Add to Inherited")) FGameplayTagContainer Added; //应该移除的标签（仅当我的父级拥有这些标签时）。注意：我们不能用它来移除目标上存在的标签。它仅修改合并标签的结果。 UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = Application, meta=(DisplayName="Remove from Inherited")) FGameplayTagContainer Removed; // 根据父级的继承标签容器更新自身的继承标签属性 void UpdateInheritedTagProperties(const FInheritedTagContainer* Parent); //将添加和移除的标签应用到传入的容器（不一定要是之前配置的父级容器！） void ApplyTo(FGameplayTagContainer& ApplyToContainer) const; //添加一个除任何继承标签之外还会出现的标签 void AddTag(const FGameplayTag& TagToAdd); //移除一个会从任何继承标签中省略的标签 void RemoveTag(const FGameplayTag& TagToRemove); bool operator==(const FInheritedTagContainer& Other) const; bool operator!=(const FInheritedTagContainer& Other) const; };
FInheritedTagContainer 结构体的主要目的是安全地合并来自父蓝图和子蓝图的游戏玩法标签。它通过管理添加和移除的标签，计算出最终的合并标签集合，使得在蓝图继承体系中能够灵活地处理标签的继承和修改。
成员变量
成员函数
第十六个也是枚举类型
/** 枚举，用于定义游戏玩法效果在堆叠时处理周期的策略 */ UENUM() enum class EGameplayEffectStackingPeriodPolicy : uint8 { /** 每当成功应用一次堆叠时，周期性效果到达下一次触发的进度将被丢弃 */ ResetOnSuccessfulApplication, /** 无论堆叠是否应用，周期性效果到达下一次触发的进度都不会被重置 */ NeverReset, };
此代码定义了一个名为 EGameplayEffectStackingPeriodPolicy 的枚举类，该枚举用于描述游戏玩法效果在堆叠时处理周期的不同策略。在游戏开发里，某些游戏玩法效果可以堆叠，比如多次施加同一个增益效果；同时部分效果具有周期性，例如每隔一段时间产生一次伤害或者恢复一定数值。该枚举规定了在效果堆叠时，周期性效果的进度该如何处理。
第十七个也是枚举类型
/** 枚举类型，用于定义游戏玩法效果在堆叠时处理周期的策略 */ UENUM() // 虚幻引擎中用于标记枚举的宏，使其支持反射和序列化等功能 enum class EGameplayEffectStackingPeriodPolicy : uint8 // 定义一个名为 EGameplayEffectStackingPeriodPolicy 的枚举类，底层类型为 uint8 { /** 每当成功进行一次堆叠应用时，周期性效果到下一次触发的进度将被舍弃 */ ResetOnSuccessfulApplication, // 成功堆叠时重置进度的策略 /** 无论是否进行堆叠应用，周期性效果到下一次触发的进度都不会被重置 */ NeverReset, // 无论堆叠与否都不重置进度的策略 };
第十八个也是枚举类型
/** 枚举类型，用于定义处理过期的游戏玩法效果堆叠（基于持续时间的效果）的策略 */ UENUM() // Unreal Engine 中用于标记枚举的宏，使枚举可用于反射和序列化等操作 enum class EGameplayEffectStackingExpirationPolicy : uint8 // 定义一个名为 EGameplayEffectStackingExpirationPolicy 的枚举类，底层类型为 uint8 { /** 当活动的游戏玩法效果过期时，整个堆叠将被清除 */ ClearEntireStack, /** 当前堆叠计数将减 1，并且持续时间将被刷新。游戏玩法效果不会 “重新应用”，只是以少一个堆叠的状态继续存在 */ RemoveSingleStackAndRefreshDuration, /** 游戏玩法效果的持续时间将被刷新。这实际上使效果的持续时间变为无限。这可用于通过 OnStackCountChange 回调手动处理堆叠计数的减少 */ RefreshDuration, };
此枚举类 EGameplayEffectStackingExpirationPolicy 用于定义在处理基于持续时间的游戏玩法效果堆叠过期时的不同策略。在游戏中，某些效果可以堆叠，并且有一定的持续时间，当这些效果过期时，需要根据不同的策略来处理堆叠。
枚举值解释
第十九个也是枚举类型
/** 枚举类型，用于定义在游戏玩法效果的抑制状态解除时，处理其周期的策略 */ UENUM() // Unreal Engine 中用于标记枚举的宏，支持反射和序列化等功能 enum class EGameplayEffectPeriodInhibitionRemovedPolicy : uint8 // 定义名为 EGameplayEffectPeriodInhibitionRemovedPolicy 的枚举类，底层类型为 uint8 { /** 不重置。周期计时将继续，就好像抑制状态从未发生过一样。 */ NeverReset, /** 重置周期。从抑制状态解除开始，下一次执行将在一个完整周期后发生。 */ ResetPeriod, /** 立即执行，并重置周期。 */ ExecuteAndResetPeriod, };
这段代码定义了一个枚举类 EGameplayEffectPeriodInhibitionRemovedPolicy，用于确定当游戏玩法效果的抑制状态被移除时，如何处理该效果的周期。在游戏里，某些游戏玩法效果可能会有周期性的触发机制（如每秒恢复一定生命值），但这些效果可能会因为某些原因（例如角色被眩晕）进入抑制状态，当抑制状态解除后，就需要根据不同的策略来处理效果的周期。
枚举值解释
浙公网安备 33010602011771号