UStageEventProcessor 클래스 참조

#include <StageEventProcessor.h>

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

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

Public 멤버 함수
void	Process (UStageManagementSubsystem *StageManagement, const FName EventID, const AActor *Caller, const AActor *InteractableActor, const FStageEventContext &Context)
EStageEvent	GetStageEvent () const

Public 속성
FName	ProcessorID = NAME_None
int32	MaxTriggerCount = 1

Protected 멤버 함수
void	OnProcessEvent (const FName EventID, const AActor *Caller, const AActor *InteractableActor, const FStageEventContext &Context)

Protected 속성
TSet< EListenerSlot >	IgnoredSlots

Private 멤버 함수
int32	ProcessProcessorTrigger (UStageManagementSubsystem *StageManagement, FName EventID, const AActor *Caller)
	Processor 발동 횟수 증가와 발동 알림을 처리한다.
int32	ProcessProcessorTriggerWithoutRecord (UStageManagementSubsystem *StageManagement, FName EventID, const AActor *Caller)
	Command 기록 없이 Processor 발동을 즉시 반영한다.

멤버 함수 문서화

GetStageEvent()

EStageEvent UStageEventProcessor::GetStageEvent

(

)

const

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

OnProcessEvent()

void UStageEventProcessor::OnProcessEvent ( const FName  EventID, const AActor *  Caller, const AActor *  InteractableActor, const FStageEventContext &  Context  )

protected

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

Process()

void UStageEventProcessor::Process	(	UStageManagementSubsystem *	StageManagement,
		const FName	EventID,
		const AActor *	Caller,
		const AActor *	InteractableActor,
		const FStageEventContext &	Context
	)

{
    checkf(StageManagement, TEXT("%s 가 nullptr 입니다. "), NAMEOF(UStageManagementSubsystem));
    const int32 CurrentCount = StageManagement->GetProcessorTriggerCount(this);
 
    if (CurrentCount >= MaxTriggerCount)
    {
        LOG_SCREEN_C
        (
            FColor::Orange,
            "[StageEvent] Skipped (limit) EventID = %s ProcessorID = %s (%d/%d)",
            *EventID.ToString(),
            *(ProcessorID.IsNone() ? TEXT("None") : ProcessorID.ToString()),
            CurrentCount,
            MaxTriggerCount
        );
 
        return;
    }
 
    const int32 NewCount = ProcessProcessorTrigger(StageManagement, EventID, Caller);
    FStageEventContext FilteredContext;
 
    for (AActor* Actor : Context.ValidListeners)
    {
        IStageEventListenerInterface* Listener = Cast<IStageEventListenerInterface>(Actor);
 
        if (Listener == nullptr)
        {
            continue;
        }
 
        if (Listener->GetStageEvent() != GetStageEvent())
        {
            continue;
        }
 
        const EListenerSlot Slot = Listener->GetSlotForEvent(EventID);
 
        if (Slot == EListenerSlot::None)
        {
            FilteredContext.ValidListeners.Add(Actor);
            continue;
        }
 
        if (IgnoredSlots.Contains(Slot))
        {
            continue;
        }
 
        FilteredContext.ValidListeners.Add(Actor);
 
        const TObjectPtr<AActor>* FoundActor = Context.ValidListenersBySlot.Find(Slot);
 
        if (FoundActor == nullptr || FoundActor->Get() != Actor)
        {
            continue;
        }
 
        FilteredContext.ValidListenersBySlot.Add(Slot, Actor);
    }
 
    LOG_SCREEN_C
    (
        FColor::Cyan,
        "[StageEvent] %-9s EventID = %-16s ProcessorID = %-20s ListenerCount = %d (%d/%d)",
        TEXT("Deliver"),
        *EventID.ToString(),
        *(ProcessorID.IsNone() ? TEXT("None") : ProcessorID.ToString()),
        FilteredContext.ValidListeners.Num(),
        NewCount,
        MaxTriggerCount
    );
 
    OnProcessEvent(EventID, Caller, InteractableActor, FilteredContext);
}

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

ProcessProcessorTrigger()

int32 UStageEventProcessor::ProcessProcessorTrigger ( UStageManagementSubsystem *  StageManagement, FName  EventID, const AActor *  Caller  )

private

Processor 발동 횟수 증가와 발동 알림을 처리한다.

SnapshotSubsystem을 사용할 수 있으면 UProcessorTriggerCommand로 실행해 롤백 가능 상태로 기록한다. Subsystem 접근 실패 또는 Command 실행 실패 시에는 이벤트 진행이 누락되지 않도록 직접 처리 경로로 fallback한다.

매개변수

StageManagement	발동 횟수와 Processor 알림을 관리하는 월드 서브시스템.
EventID	현재 처리 중인 Storyboard Event ID.
Caller	이벤트를 발생시킨 액터.

반환값

실제 처리 후 Processor 발동 횟수.

{
    checkf(StageManagement, TEXT("%s 가 nullptr 입니다. "), NAMEOF(UStageManagementSubsystem));
 
    UProcessorTriggerCommand* Command = USnapshotSubsystem::ProcessNewCommand<UProcessorTriggerCommand>(StageManagement, [StageManagement, this, EventID, Caller](UProcessorTriggerCommand* NewCommand)
    {
        NewCommand->Initialize(StageManagement, this, EventID, Caller);
    });
 
    if (Command)
    {
        return Command->GetTriggerCountAfterProcess();
    }
    
    // SnapshotSubsystem 사용 불가 또는 커맨드 실행 실패 시 이벤트 진행이 누락되지 않도록 직접 처리한다.
    return ProcessProcessorTriggerWithoutRecord(StageManagement, EventID, Caller);
}

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

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

ProcessProcessorTriggerWithoutRecord()

int32 UStageEventProcessor::ProcessProcessorTriggerWithoutRecord ( UStageManagementSubsystem *  StageManagement, FName  EventID, const AActor *  Caller  )

private

Command 기록 없이 Processor 발동을 즉시 반영한다.

SnapshotSubsystem을 사용할 수 없는 구간에서도 StageEvent 진행이 멈추지 않도록 사용하는 fallback 경로다.

매개변수

StageManagement	발동 횟수와 Processor 알림을 관리하는 월드 서브시스템.
EventID	현재 처리 중인 Storyboard Event ID.
Caller	이벤트를 발생시킨 액터.

반환값

증가 후 Processor 발동 횟수.

{
    checkf(StageManagement, TEXT("%s 가 nullptr 입니다. "), NAMEOF(UStageManagementSubsystem));
    const int32 NewCount = StageManagement->IncrementProcessorTriggerCount(this);
    StageManagement->NotifyProcessorTriggered(EventID, Caller, this);
    return NewCount;
}

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

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

멤버 데이터 문서화

IgnoredSlots

TSet<EListenerSlot> UStageEventProcessor::IgnoredSlots

protected

MaxTriggerCount

int32 UStageEventProcessor::MaxTriggerCount = 1

ProcessorID

FName UStageEventProcessor::ProcessorID = NAME_None

---

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

• Source/CK_UE/Level/Event/Processor/StageEventProcessor.h
• Source/CK_UE/Level/Event/Processor/StageEventProcessor.cpp