WaveInfoWidget.h

이 파일의 문서화 페이지로 가기

// Fill out your copyright notice in the Description page of Project Settings.
 
#pragma once
 
#include "CoreMinimal.h"
#include "UI/UserWidgetBase.h"
#include "WaveInfoWidget.generated.h"
 
struct FWaveDataCollection;
class UTextBlock;
class AEnemyCharacterBase;
UCLASS()
class CK_UE_API UWaveInfoWidget : public UUserWidgetBase
{
    GENERATED_BODY()
 
protected:
    virtual void NativeConstruct() override;
    virtual void NativeDestruct() override;
 
protected:
    UFUNCTION(BlueprintImplementableEvent, Category = "UI|WaveInfo")
    void UpdateEnemyCount(const int32 Count);
 
    // 다음 웨이브까지 남은 시간(초). 카운트다운 시작 시 1회 + 매 카운트다운 tick 마다 호출.
    UFUNCTION(BlueprintImplementableEvent, Category = "UI|WaveInfo")
    void UpdateCountdownTime(const float SecondsRemaining);
 
private:
    // 남은 적 수 텍스트 + BP UpdateEnemyCount 이벤트를 함께 갱신.
    void ApplyRemainingEnemyCount(int32 Count);
    void UpdateCountdownText();
 
private:
    UFUNCTION()
    void StartCountdown(float Seconds);
 
    UFUNCTION()
    void StopCountdown();
 
    UFUNCTION()
    void TickCountdown();
 
    UFUNCTION()
    void OnEnemyRemainingCountChanged(int32 RemainingCount);
 
    UFUNCTION()
    void OnSpawnedEnemyKilled(const AEnemyCharacterBase* DiedEnemy, const int32 RemainingCount);
 
    UFUNCTION()
    void OnUpdateWave(const FWaveDataCollection& WaveDataCollection, const int32 CurrentWaveIdx);
 
protected:
    UPROPERTY(BlueprintReadWrite, meta = (BindWidget))
    TObjectPtr<UTextBlock> RemainingEnemyCount;
 
    UPROPERTY(BlueprintReadWrite, meta = (BindWidget))
    TObjectPtr<UTextBlock> CurrentWaveIndex;
 
    UPROPERTY(BlueprintReadWrite, meta = (BindWidget))
    TObjectPtr<UTextBlock> NextWaveCountdown;
 
private:
    // 카운트다운 갱신 주기(초). 표시 정밀도(0.1s)와 맞춰 매끄럽게 갱신.
    static constexpr float CountdownTickInterval = 0.1f;
 
    // 다음 웨이브까지 남은 시간(초). 0 이하면 카운트다운 종료.
    float NextWaveCountdownSeconds = 0.0f;
 
    // 위젯이 표시하고 있는 남은 몬스터 총합. 이전 웨이브 잔존과 새 웨이브 예정 스폰을 누적해 관리.
    int32 WidgetRemainingTotal = 0;
 
    // StageManagementSubsystem이 마지막으로 브로드캐스트한 OnEnemyRemainingCountChanged 값.
    // 새 웨이브 시작 시점에 새 웨이브의 예정 스폰 수로 사용된다.
    int32 LastEnemyCountBroadcast = 0;
 
    // 직전 OnEnemyRemainingCountChanged가 도착하기 직전의 WidgetRemainingTotal.
    // 새 웨이브 시작 시 이전 웨이브 잔존량(합산의 좌항)으로 사용된다.
    int32 WidgetTotalBeforeLastBroadcast = 0;
    
    FTimerHandle CountdownTimerHandle;
};