AMainPlayerState 클래스 참조

#include <MainPlayerState.h>

AMainPlayerState에 대한 상속 다이어그램 :

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

Public 멤버 함수
	AMainPlayerState ()
virtual UAbilitySystemComponent *	GetAbilitySystemComponent () const override
FORCEINLINE UPlayerAttributeSet *	GetPlayerAttributeSet () const
void	AddExp (float Amount)
int32	GetPlayerLevel () const
float	GetCurrentExp () const
float	GetRequiredExp () const

Public 속성
FOnExpChanged	OnExpChanged
FOnLevelUp	OnLevelUp

Protected 멤버 함수
virtual void	BeginPlay () override
void	HandleExperienceThresholdReached ()
bool	ApplyLevelRequirement ()
void	RetryLevelRequirement ()

Protected 속성
TObjectPtr< UAbilitySystemComponent >	ASC
TObjectPtr< UPlayerAttributeSet >	AttributeSet

Private 속성
FTimerHandle	LevelRequirementRetryTimerHandle

생성자 & 소멸자 문서화

AMainPlayerState()

AMainPlayerState::AMainPlayerState

(

)

{
    ASC = CreateDefaultSubobject<UAbilitySystemComponent>(TEXT("ASC"));
    AttributeSet = CreateDefaultSubobject<UPlayerAttributeSet>(TEXT("AttributeSet"));
}

멤버 함수 문서화

AddExp()

void AMainPlayerState::AddExp

(

float

Amount

)

{
    if (Amount <= 0.0f || AttributeSet == nullptr)
    {
        return;
    }
 
    // 어트리뷰트를 직접 올린다. GE 로 주고 싶으면 여기 대신 GE 를 적용하면 된다.
    AttributeSet->SetExperience(AttributeSet->GetExperience() + Amount);
 
    // SetExperience 는 PostGameplayEffectExecute 를 타지 않으므로 여기서 직접 판정한다.
    HandleExperienceThresholdReached();
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

ApplyLevelRequirement()

bool AMainPlayerState::ApplyLevelRequirement ( )

protected

{
    if (AttributeSet == nullptr)
    {
        return false;
    }
 
    UStageManifest* Manifest = UDataBundleRegistry::GetBundleAssetByTag<UStageManifest>(TAG_BUNDLE_INITIAL);
 
    // 표가 아직 안 채워졌으면 요구치 0 이 "최종 레벨"인지 "미로드"인지 구분할 수 없다.
    if (Manifest == nullptr || Manifest->HasLevelData() == false)
    {
        return false;
    }
 
    const float RequiredExp = Manifest->GetRequiredExp(GetPlayerLevel());
 
    AttributeSet->SetMaxExperience(RequiredExp);
 
    OnExpChanged.Broadcast(AttributeSet->GetExperience(), RequiredExp);
 
    return true;
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

BeginPlay()

void AMainPlayerState::BeginPlay ( )

overrideprotectedvirtual

{
    Super::BeginPlay();
 
    if (AttributeSet == nullptr)
    {
        LOG_ERROR(LogCKPlayer, "%s 가 없어 경험치를 초기화할 수 없습니다.", NAMEOF(UPlayerAttributeSet));
        return;
    }
 
    AttributeSet->OnExperienceThresholdReached.AddUObject(this, &AMainPlayerState::HandleExperienceThresholdReached);
 
    AttributeSet->InitExperienceStats(1.0f, 0.0f, 0.0f);
 
    // 데이터 번들이 비동기 로드라 이 시점엔 레벨 표가 없을 수 있다.
    if (ApplyLevelRequirement() == false)
    {
        GetWorldTimerManager().SetTimer(LevelRequirementRetryTimerHandle, this, &AMainPlayerState::RetryLevelRequirement, 0.5f, true);
    }
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

GetAbilitySystemComponent()

class UAbilitySystemComponent * AMainPlayerState::GetAbilitySystemComponent ( ) const

overridevirtual

{
    return ASC;
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetCurrentExp()

float AMainPlayerState::GetCurrentExp

(

)

const

{
    return AttributeSet ? AttributeSet->GetExperience() : 0.0f;
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetPlayerAttributeSet()

FORCEINLINE UPlayerAttributeSet * AMainPlayerState::GetPlayerAttributeSet ( ) const

inline

{ return AttributeSet; }

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetPlayerLevel()

int32 AMainPlayerState::GetPlayerLevel

(

)

const

{
    return AttributeSet ? FMath::RoundToInt(AttributeSet->GetLevel()) : 1;
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetRequiredExp()

float AMainPlayerState::GetRequiredExp

(

)

const

{
    return AttributeSet ? AttributeSet->GetMaxExperience() : 0.0f;
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

HandleExperienceThresholdReached()

void AMainPlayerState::HandleExperienceThresholdReached ( )

protected

{
    if (AttributeSet == nullptr)
    {
        return;
    }
 
    // 한 번에 여러 레벨이 오를 수 있으므로 요구치를 못 넘길 때까지 반복한다.
    // 요구치가 0 이하인 레벨은 최종 레벨이라 여기서 자연히 멈춘다.
    while (true)
    {
        const float RequiredExp = AttributeSet->GetMaxExperience();
 
        if (RequiredExp <= 0.0f || AttributeSet->GetExperience() < RequiredExp)
        {
            break;
        }
 
        AttributeSet->SetExperience(AttributeSet->GetExperience() - RequiredExp);
        AttributeSet->SetLevel(AttributeSet->GetLevel() + 1.0f);
 
        const int32 NewLevel = GetPlayerLevel();
 
        LOG_INFO(LogCKPlayer, "레벨 업: %d", NewLevel);
 
        // 다음 레벨 요구치를 먼저 채운 뒤 알려야 UI 가 올바른 분모를 본다.
        ApplyLevelRequirement();
 
        OnLevelUp.Broadcast(NewLevel);
    }
 
    OnExpChanged.Broadcast(AttributeSet->GetExperience(), AttributeSet->GetMaxExperience());
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

RetryLevelRequirement()

void AMainPlayerState::RetryLevelRequirement ( )

protected

{
    if (ApplyLevelRequirement())
    {
        GetWorldTimerManager().ClearTimer(LevelRequirementRetryTimerHandle);
    }
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

ASC

TObjectPtr<UAbilitySystemComponent> AMainPlayerState::ASC

protected

AttributeSet

TObjectPtr<UPlayerAttributeSet> AMainPlayerState::AttributeSet

protected

LevelRequirementRetryTimerHandle

FTimerHandle AMainPlayerState::LevelRequirementRetryTimerHandle

private

OnExpChanged

FOnExpChanged AMainPlayerState::OnExpChanged

OnLevelUp

FOnLevelUp AMainPlayerState::OnLevelUp

---

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

• Source/CK_UE/Character/Player/PlayerState/MainPlayerState.h
• Source/CK_UE/Character/Player/PlayerState/MainPlayerState.cpp