#include <GrantedHandles.h>

FGrantedHandles에 대한 협력 다이어그램:

Public 멤버 함수
FGameplayAbilitySpecHandle	GiveAbility (UAbilitySystemComponent *ASC, const FGameplayAbilitySpec &Spec)

FActiveGameplayEffectHandle	ApplyEffectSpecToSelf (UAbilitySystemComponent *ASC, const FGameplayEffectSpec &Spec)

void	TakeFromAbilitySystem (UAbilitySystemComponent *ASC)

bool	IsEmpty () const

Public 속성
TArray< FGameplayAbilitySpecHandle >	AbilitySpecHandles

TArray< FActiveGameplayEffectHandle >	EffectHandles

상세한 설명

ASC 에 부여한 어빌리티/GE 핸들을 한 묶음으로 추적하기 위한 유틸 구조체. 무기/장비/패시브 세트 등 "한 단위가 부여한 것을 한 번에 회수" 하는 패턴에 사용.

GiveAbility / ApplyEffectSpecToSelf 로 부여하면서 자동으로 핸들이 누적된다.
회수는 TakeFromAbilitySystem 단일 호출.
자기가 직접 부여한 항목만 추적. 정책성 일괄 정리(예: 전역 쿨다운 리셋)는 별도 처리.

멤버 함수 문서화

◆ ApplyEffectSpecToSelf()

FActiveGameplayEffectHandle FGrantedHandles::ApplyEffectSpecToSelf	(	UAbilitySystemComponent *	ASC,
		const FGameplayEffectSpec &	Spec
	)

{
    if (ASC == nullptr)
    {
        return FActiveGameplayEffectHandle();
    }
 
    const FActiveGameplayEffectHandle Handle = ASC->ApplyGameplayEffectSpecToSelf(Spec);
    if (Handle.IsValid())
    {
        EffectHandles.Add(Handle);
    }
    return Handle;
}

◆ GiveAbility()

FGameplayAbilitySpecHandle FGrantedHandles::GiveAbility	(	UAbilitySystemComponent *	ASC,
		const FGameplayAbilitySpec &	Spec
	)

{
    if (ASC == nullptr)
    {
        return FGameplayAbilitySpecHandle();
    }
 
    const FGameplayAbilitySpecHandle Handle = ASC->GiveAbility(Spec);
    if (Handle.IsValid())
    {
        AbilitySpecHandles.Add(Handle);
    }
    return Handle;
}

◆ IsEmpty()

bool FGrantedHandles::IsEmpty ( ) const

inline

    {
        return AbilitySpecHandles.Num() == 0 && EffectHandles.Num() == 0;
    }

◆ TakeFromAbilitySystem()

void FGrantedHandles::TakeFromAbilitySystem ( UAbilitySystemComponent * ASC )

{
    if (ASC == nullptr)
    {
        AbilitySpecHandles.Reset();
        EffectHandles.Reset();
        return;
    }
 
    // 1) 활성 어빌리티 취소.
    for (const FGameplayAbilitySpecHandle& Handle : AbilitySpecHandles)
    {
        if (Handle.IsValid() == false)
        {
            continue;
        }
 
        const FGameplayAbilitySpec* Spec = ASC->FindAbilitySpecFromHandle(Handle);
        if (Spec == nullptr)
        {
            continue;
        }
 
        if (Spec->IsActive())
        {
            ASC->CancelAbilityHandle(Handle);
        }
    }
 
    // 2) 어빌리티 부여 자체 제거.
    for (const FGameplayAbilitySpecHandle& Handle : AbilitySpecHandles)
    {
        if (Handle.IsValid())
        {
            ASC->ClearAbility(Handle);
        }
    }
 
    // 3) 적용된 GE 제거.
    for (const FActiveGameplayEffectHandle& Handle : EffectHandles)
    {
        if (Handle.IsValid())
        {
            ASC->RemoveActiveGameplayEffect(Handle, /*StacksToRemove=*/ -1);
        }
    }
 
    AbilitySpecHandles.Reset();
    EffectHandles.Reset();
}

멤버 데이터 문서화

◆ AbilitySpecHandles

TArray<FGameplayAbilitySpecHandle> FGrantedHandles::AbilitySpecHandles

◆ EffectHandles

TArray<FActiveGameplayEffectHandle> FGrantedHandles::EffectHandles

이 구조체에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

Source/CK_UE/GAS/GrantedHandles.h
Source/CK_UE/GAS/GrantedHandles.cpp

Public 멤버 함수

Public 속성