ULSE_PlayCutscene 클래스 참조

#include <LSE_PlayCutscene.h>

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

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

Public 멤버 함수
virtual void	OnLoadingStart (const FLevelStreamingContext Context) override
virtual ELevelStreamingEffectResult	OnLoadingUpdate (const FLevelStreamingContext Context) override
virtual void	OnLoadingEnd (const FLevelStreamingContext Context) override
ULevelStreamingEffect(으)로부터 상속된 Public 멤버 함수
virtual void	InitEffect ()
virtual void	OnCompletedEffectsByPhase (const ELevelStreamingPhase CompletedPhase)
virtual void	ExecuteUpdate (ELevelStreamingPhase Phase, const FLevelStreamingContext &Context)
virtual void	CallPrepareOrFinishEvent (ELevelStreamingPhase Phase, ELevelStreamingEffectCallType CallType, const FLevelStreamingContext &Context)
FORCEINLINE ELevelStreamingEffectResult	GetLastExecutionResult () const
FORCEINLINE bool	IsSkipThisEffect () const

Public 속성
FUIContext	CutsceneContext
int32	CutsceneID = 0
bool	bUseTypewriter = false
float	CharactersPerSecond = 40.0f

Protected 속성
TObjectPtr< UScenarioCutsceneWidget >	ScenarioCutsceneWidget
ULevelStreamingEffect(으)로부터 상속된 Protected 속성
bool	bSkipThisEffect = false
ELevelStreamingEffectResult	LastExecutionResult = ELevelStreamingEffectResult::None

Private 멤버 함수
TArray< FDT_ScenarioCutsceneTable >	BuildCutsceneRows () const
void	RestrictPlayerInput (const FLevelStreamingContext &Context)
void	RestorePlayerInput (const FLevelStreamingContext &Context)

Private 속성
TWeakObjectPtr< UAbilitySystemComponent >	RestrictedASC
TWeakObjectPtr< ACharacter >	RestrictedCharacter
bool	bCutsceneStarted = false

멤버 함수 문서화

BuildCutsceneRows()

TArray< FDT_ScenarioCutsceneTable > ULSE_PlayCutscene::BuildCutsceneRows ( ) const

private

{
    TArray<FDT_ScenarioCutsceneTable> Result;
 
    if (CutsceneID == 0)
    {
        LOG_WARNING(LogCKLevel, "재생할 CutsceneID가 설정되지 않았습니다.");
        return Result;
    }
 
    UStageManifest* StageManifest = UDataBundleRegistry::GetBundleAssetByTag<UStageManifest>(TAG_BUNDLE_INITIAL);
 
    if (StageManifest == nullptr)
    {
        LOG_WARNING(LogCKLevel, "%s를 찾을 수 없어 컷신 데이터를 만들 수 없습니다.", NAMEOF(UStageManifest));
        return Result;
    }
 
    const UDataTable* ScenarioCutsceneTable = StageManifest->ScenarioCutsceneDataMap.LoadSynchronous();
 
    if (ScenarioCutsceneTable == nullptr)
    {
        LOG_WARNING(LogCKLevel, "ScenarioCutsceneDataMap 로드 실패: DataTable이 nullptr입니다.");
        return Result;
    }
 
    TArray<FDT_ScenarioCutsceneTable*> CutsceneRows;
    ScenarioCutsceneTable->GetAllRows(TEXT("ULSE_PlayCutscene::BuildCutsceneRows"), CutsceneRows);
 
    for (const FDT_ScenarioCutsceneTable* Row : CutsceneRows)
    {
        if (Row && Row->Cutscene_ID == CutsceneID)
        {
            Result.Add(*Row);
        }
    }
 
    Result.Sort([](const FDT_ScenarioCutsceneTable& Left, const FDT_ScenarioCutsceneTable& Right)
    {
        return (Left.Dialog_ID == Right.Dialog_ID ? Left.Group_ID < Right.Group_ID : Left.Dialog_ID < Right.Dialog_ID); 
    });
 
    if (Result.IsEmpty())
    {
        LOG_WARNING(LogCKLevel, "Cutscene_ID '%d'에 해당하는 컷신 데이터가 없습니다.", CutsceneID);
    }
 
    return Result;
}

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

OnLoadingEnd()

void ULSE_PlayCutscene::OnLoadingEnd ( const FLevelStreamingContext  Context )

overridevirtual

ILevelLoadingInterface를 구현.

{
    RestorePlayerInput(Context);
 
    if (ScenarioCutsceneWidget == nullptr)
    {
        return;
    }
 
    if (Context.OriginalWorld == nullptr)
    {
        ScenarioCutsceneWidget = nullptr;
        return;
    }
 
    UGameInstance* GI = Context.OriginalWorld->GetGameInstance();
 
    if (GI == nullptr)
    {
        ScenarioCutsceneWidget = nullptr;
        return;
    }
 
    if (UUIManagementSubsystem* UISubsystem = GI->GetSubsystem<UUIManagementSubsystem>())
    {
        UISubsystem->PopWidget(ScenarioCutsceneWidget);
    }
 
    ScenarioCutsceneWidget = nullptr;
    bCutsceneStarted = false;
}

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

OnLoadingStart()

void ULSE_PlayCutscene::OnLoadingStart ( const FLevelStreamingContext  Context )

overridevirtual

ILevelLoadingInterface를 구현.

{
    if (Context.OriginalWorld == nullptr)
    {
        LOG_WARNING(LogCKLevel, "OriginalWorld가 없어 컷신을 시작할 수 없습니다.");
        return;
    }
 
    ScenarioCutsceneWidget = nullptr;
    bCutsceneStarted = false;
 
    UUIManagementSubsystem* UISubsystem = UCK_BPFunctionLibrary::GetUIManagementSubsystem(Context.OriginalWorld);
 
    if (UISubsystem == nullptr)
    {
        LOG_WARNING(LogCKLevel, "%s를 찾을 수 없어 컷신을 시작할 수 없습니다.", NAMEOF(UUIManagementSubsystem));
        return;
    }
 
    UUILayer* OutLayer = nullptr;
    FUIContext ScenarioCutsceneContext = CutsceneContext;
    ScenarioCutsceneContext.Primary = true;
 
    UUserWidgetBase* Widget = UISubsystem->PushPlayerWidget(ScenarioCutsceneContext, OutLayer);
    ScenarioCutsceneWidget = Cast<UScenarioCutsceneWidget>(Widget);
 
    if (ScenarioCutsceneWidget)
    {
        RestrictPlayerInput(Context);
        ScenarioCutsceneWidget->ConfigureTypewriter(bUseTypewriter, CharactersPerSecond);
        ScenarioCutsceneWidget->StartCutscene(BuildCutsceneRows());
        bCutsceneStarted = true;
        return;
    }
 
    LOG_WARNING(LogCKLevel, "%s를 생성하지 못했습니다.", NAMEOF(UScenarioCutsceneWidget));
 
    if (Widget)
    {
        UISubsystem->PopWidget(Widget);
    }
    else
    {
        LOG_ERROR(LogCK, "%s이 Nullptr 입니다. ", NAMEOF_VAR(Widget));
    }
}

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

OnLoadingUpdate()

ELevelStreamingEffectResult ULSE_PlayCutscene::OnLoadingUpdate ( const FLevelStreamingContext  Context )

overridevirtual

ILevelLoadingInterface를 구현.

{
    if (bCutsceneStarted == false)
    {
        LOG_ERROR(LogCK, "%s 컷신이 시작되지 않았습니다. ", NAMEOF_VAR(bCutsceneStarted));
        return ELevelStreamingEffectResult::Completed;
    }
 
    if (ScenarioCutsceneWidget == nullptr)
    {
        LOG_ERROR(LogCK, "%s 이 Nullptr 입니다. ", NAMEOF_VAR(ScenarioCutsceneWidget));
        return ELevelStreamingEffectResult::Completed;
    }
 
    if (ScenarioCutsceneWidget->IsCutsceneFinished())
    {
        LOG_INFO(LogCK, "컷씬이 완료되었습니다. ");
        return ELevelStreamingEffectResult::Completed;
    }
    else
    {
        return ELevelStreamingEffectResult::InProgress;
    }
}

RestorePlayerInput()

void ULSE_PlayCutscene::RestorePlayerInput ( const FLevelStreamingContext &  Context )

private

{
    if (RestrictedASC.IsValid())
    {
        RestrictedASC->RemoveLooseGameplayTag(TAG_CHARACTER_STATE_ISBLOCKMOVEMENT);
        RestrictedASC->RemoveLooseGameplayTag(TAG_CHARACTER_STATE_ISBLOCKINPUT);
        RestrictedASC.Reset();
    }
 
    if (!RestrictedCharacter.IsValid())
    {
        return;
    }
 
    if (UCharacterMovementComponent* MovementComponent = RestrictedCharacter->GetCharacterMovement())
    {
        MovementComponent->SetMovementMode(MOVE_Walking);
    }
 
    RestrictedCharacter.Reset();
}

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

RestrictPlayerInput()

void ULSE_PlayCutscene::RestrictPlayerInput ( const FLevelStreamingContext &  Context )

private

{
    if (Context.PlayerController == nullptr)
    {
        LOG_WARNING(LogCKLevel, "PlayerController가 없어 컷신 중 입력 제한을 적용할 수 없습니다.");
        return;
    }
 
    ACharacter* Character = Cast<ACharacter>(Context.PlayerController->GetPawn());
 
    if (Character == nullptr)
    {
        LOG_WARNING(LogCKLevel, "플레이어 캐릭터를 얻어올 수 없어 컷신 중 입력 제한을 적용할 수 없습니다.");
        return;
    }
 
    RestrictedCharacter = Character;
 
    if (UCharacterMovementComponent* MovementComponent = Character->GetCharacterMovement())
    {
        MovementComponent->DisableMovement();
    }
 
    IAbilitySystemInterface* ASI = Cast<IAbilitySystemInterface>(Character);
 
    if (ASI == nullptr)
    {
        LOG_WARNING(LogCKLevel, "%s을 얻어올 수 없어 컷신 중 GAS 입력 제한을 적용할 수 없습니다.", NAMEOF(IAbilitySystemInterface));
        return;
    }
 
    UAbilitySystemComponent* ASC = ASI->GetAbilitySystemComponent();
 
    if (ASC == nullptr)
    {
        LOG_WARNING(LogCKLevel, "%s을 얻어올 수 없어 컷신 중 GAS 입력 제한을 적용할 수 없습니다.", NAMEOF(UAbilitySystemComponent));
        return;
    }
 
    RestrictedASC = ASC;
    ASC->AddLooseGameplayTag(TAG_CHARACTER_STATE_ISBLOCKMOVEMENT);
    ASC->AddLooseGameplayTag(TAG_CHARACTER_STATE_ISBLOCKINPUT);
    ASC->CancelAllAbilities();
}

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

멤버 데이터 문서화

bCutsceneStarted

bool ULSE_PlayCutscene::bCutsceneStarted = false

private

bUseTypewriter

bool ULSE_PlayCutscene::bUseTypewriter = false

CharactersPerSecond

float ULSE_PlayCutscene::CharactersPerSecond = 40.0f

CutsceneContext

FUIContext ULSE_PlayCutscene::CutsceneContext

CutsceneID

int32 ULSE_PlayCutscene::CutsceneID = 0

RestrictedASC

TWeakObjectPtr<UAbilitySystemComponent> ULSE_PlayCutscene::RestrictedASC

private

RestrictedCharacter

TWeakObjectPtr<ACharacter> ULSE_PlayCutscene::RestrictedCharacter

private

ScenarioCutsceneWidget

TObjectPtr<UScenarioCutsceneWidget> ULSE_PlayCutscene::ScenarioCutsceneWidget

protected

---

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

• Source/CK_UE/Level/Effect/LSE_PlayCutscene.h
• Source/CK_UE/Level/Effect/LSE_PlayCutscene.cpp