4.2 游戏标签 - Gameplay Tags

FGameplayTags是通过GameplayTagManager进行注册的具备一系列层级的标签名字，如Parent.Child.Grandchild...。这些标签在分类和描述一个对象的状态时格外有用。例如，如果一个角色被眩晕了，我们可以在眩晕的持续时间之内给它一个State.Debuff.Stun的GameplayTag。

你会发现其实你是用GameplayTags替代了之前用布尔或者枚举来处理的内容，并且通过判断某个对象是否具备特定的GameplayTags来进行一些布尔逻辑运算。

当为某个对象赋予标签时，我们通常会将标签添加到对象上的ASC，这样GAS就能和他们产生相应的交互。UAbilitySystemComponent实现了接口IGameplayTagAssetInterface中的给定方法，来访问它所有拥有的GameplayTags。

多个GameplayTags可以存储在一个FGameplayTagContainer里。这里通常我们更偏向于使用GameplayTagContainer而不是TArray<FGameplayTag>，因为GameplayTagContainers中有一些高效的工具。因为标签本质上就是标准的FName，如果项目设置中的Fast Replication处于激活状态的话，他们可以被高效得打包在一起到FGameplayTagContainers中，以方便网络复制的使用。Fast Replication要求服务器和客户端们有着相同的GameplayTags列表。这通常并不会有什么问题，所以你尽管激活这个选项就好了。GameplayTagContainers在遍历时也可以一返回到一个TArray<FGameplayTag>数组。

存储在FGameplayTagCountContainer的GameplayTags有着一个TagMap，其内存储着相应GameplayTag的实例的数量。FGameplayTagCountContainer可能还存在某些GameplayTag，其对应的TagMapCount实际上已经是0了。当调试的时候可能就会遇到这种情况。HasTag()或者HasMatchingTag()或者相类似的函数都会去检查TagMapCount，并且在GameplayTag不存在或者相应的TagMapCount为0的情况下直接返回false。

GameplayTags必须在DefaultGameplayTags.ini中提早进行定义。虚幻编辑器在项目设置中提供了一个编辑界面来让开发者管理GameplayTags，而无需手动编辑DefaultGameplayTags.ini文件。GameplayTag的编辑器内可以进行创建、改名、查找引用以及删除操作。

查找GameplayTag的引用将会在编辑器内打开一个类似Reference Viewer的图形界面，其中展示了所有引用GameplayTag的资产。当然，不包括任何C++类。

重命名GameplayTag实际上是创建了一个重定向，与原GameplayTag有引用关系的资产可以通过这个重定向找到新的GameplayTag。我偏向于创建一个新的GameplayTag，然后手动更新所有的引用，然后删除掉旧的GameplayTag，从而避免创建一个重定向。

除了Fast Replication，GameplayTag编辑器中有一个选项可以选择常用的网络复制的GameplayTag，从而进一步实现优化。

如果GameplayTag是由GameplayEffect添加的话，那他们就会被复制。ASC可以让你添加不会被复制并且必须手动管理的LooseGameplayTags。示例项目使用LooseGameplayTag来作为State.Dead，这样所属客户端在他们的hp降为0后就能够立即响应。重生的时候需要手动得将TagMapCount设置回0。仅在使用LooseGameplayTags时才会用到手动调整TagMapCount。我偏向于使用UAbilitySystemComponent::AddLooseGameplayTag()和UAbilitySystemComponent::RemoveLooseGameplayTag() 这两个函数，而不是直接手动调整TagMapCount。

在C++中去获取GameplayTag的引用：

FGameplayTag::RequestGameplayTag(FName("Your.GameplayTag.Name"))

至于高级的GameplayTag的相关操作如获取父级或者子级的GameplayTag，参考GameplayTagManager中提供的一些方法。要访问GameplayTagManager，首先要包含GameplayTagManager.h头文件，然后调用UGameplayTagManager::Get().FunctionName函数即可。实际上GameplayTagManager将GameplayTag存储为关系节点（父，子，等等），所以处理速度要快于字符串的操作和比较。

GameplayTags和GameplayTagContainers可以通过UPROPERTY中的说明符Meta = (Categories = "GameplayCue")来过滤蓝图中的标签，从而仅显示父级标签为GameplayCue的那些GameplayTags。当你知道那些仅用于GameplayCues的GameplayTag或者GameplayTagContainer变量时这样的操作就非常有用处了。

此外，还有一个单独的结构体FGameplayCueTag封装了FGameplayTag，这样也可以实现上面的那种过滤的效果。

如果你想在一个函数中过滤GameplayTag参数时，可以使用UFUNCTION中的说明符Meta = (GameplayTagFilter = "GameplayCue")。而函数中的GameplayTagContainer参数是不可以被过滤的（译者注：现在已经支持过滤的特性，但是后续翻译时仍然保留了相关描述，目的是让大家了解相关特性是如何通过元数据进行支持的）。如果你想要让你的引擎支持这个特性，参考Engine\Plugins\Editor\GameplayTagsEditor\Source\GameplayTagsEditor\Private\SGameplayTagGraphPin.cpp中的函数SGameplayTagGraphPin::ParseDefaultValueData()是怎样调用FilterString = UGameplayTagsManager::Get().GetCategoriesMetaFromField(PinStructType);并且在函数SGameplayTagGraphPin::GetListContent()中传递FilterString到SGameplayTagWidget。Engine\Plugins\Editor\GameplayTagsEditor\Source\GameplayTagsEditor\Private\SGameplayTagContainerGraphPin.cpp中的GameplayTagContainer相关函数并没有检查元字段属性并代入过滤器。

示例项目广泛使用了GameplayTags。

4.2.1 响应游戏标签的变化 - Responding to Changes in Gameplay Tags

ASC为GameplayTags的添加和删除提供了相应的委托。需要给定一个EGameplayTagEventType来表明事件类型，即是GameplayTags的增加亦或是删除，还是GameplayTag的 TagMapCount发生了变化之类的。

AbilitySystemComponent->RegisterGameplayTagEvent(FGameplayTag::RequestGameplayTag(FName("State.Debuff.Stun")), EGameplayTagEventType::NewOrRemoved).AddUObject(this, &AGDPlayerState::StunTagChanged);

回调函数中有两个参数，分别是GameplayTag和新的TagCount。

virtual void StunTagChanged(const FGameplayTag CallbackTag, int32 NewCount);