지정된 시간 후에 함수(콜백)를 실행하는 지연 작업 관리 서브시스템입니다. 더 자세히 ...

#include <UDelayTaskManager.h>

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

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

클래스
struct	FEntry

Public 멤버 함수
bool	Cancel (const FDelayHandle &Handle)

void	CancelAll (UObject *Owner)

	DEFINE_SUBSYSTEM_GETTER_INLINE (UDelayTaskManager)

virtual void	Deinitialize () override

FDelayHandle	Delay (UObject *Owner, float Seconds, TFunction< void()> Action)

FDelayHandle	DelayCallBack (UObject *Owner, float Seconds, FDelayCallback Callback)

virtual void	Initialize (FSubsystemCollectionBase &Collection) override

FDelayHandle	NextTick (UObject *Owner, TFunction< void()> Action)

Private 멤버 함수
void	ExecuteById (uint64 SeqIndex)

void	RemoveEntryById (uint64 SeqIndex)

Private 속성
TMap< uint64, FEntry >	Entries

uint64	NextSeqIndex = 1

TMultiMap< TWeakObjectPtr< UObject >, uint64 >	OwnerIndex

상세한 설명

지정된 시간 후에 함수(콜백)를 실행하는 지연 작업 관리 서브시스템입니다.

C++ 람다 및 블루프린트 델리게이트를 모두 지원하며, 생성된 작업을 핸들로 제어하거나 특정 오너와 관련된 모든 작업을 한 번에 취소할 수 있습니다.

UDelayTaskManager.h 파일의 39 번째 라인에서 정의되었습니다.

멤버 함수 문서화

◆ Cancel()

bool UDelayTaskManager::Cancel ( const FDelayHandle & Handle )

UDelayTaskManager.cpp 파일의 101 번째 라인에서 정의되었습니다.

{
    if (!GetWorld() || !Handle.IsValid())
        return false;
 
    FEntry Entry;
    if (Entries.RemoveAndCopyValue(Handle.SeqIndex, Entry))
    {
        // 엔진 타이머도 정리
        GetWorld()->GetTimerManager().ClearTimer(Entry.TimerHandle);
        OwnerIndex.RemoveSingle(Entry.Owner, Handle.SeqIndex);
        return true;
    }
 
    return false;
}

다음을 참조함 : Entries, FDelayHandle::IsValid(), UDelayTaskManager::FEntry::Owner, OwnerIndex, FDelayHandle::SeqIndex, UDelayTaskManager::FEntry::TimerHandle.

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

◆ CancelAll()

void UDelayTaskManager::CancelAll ( UObject * Owner )

UDelayTaskManager.cpp 파일의 118 번째 라인에서 정의되었습니다.

{
    if (!GetWorld() || !Owner)
        return;
 
    TArray<uint64> Ids;
    OwnerIndex.MultiFind(Owner, Ids);
    if (Ids.Num() == 0)
        return;
 
    FTimerManager& TM = GetWorld()->GetTimerManager();
 
    for (uint64 Seq : Ids)
    {
        FEntry Entry;
        if (Entries.RemoveAndCopyValue(Seq, Entry))
        {
            TM.ClearTimer(Entry.TimerHandle);
            OwnerIndex.RemoveSingle(Entry.Owner, Seq);
        }
    }
}

다음을 참조함 : Entries, UDelayTaskManager::FEntry::Owner, OwnerIndex, UDelayTaskManager::FEntry::TimerHandle.

◆ DEFINE_SUBSYSTEM_GETTER_INLINE()

UDelayTaskManager::DEFINE_SUBSYSTEM_GETTER_INLINE ( UDelayTaskManager )

◆ Deinitialize()

void UDelayTaskManager::Deinitialize ( )

overridevirtual

UDelayTaskManager.cpp 파일의 16 번째 라인에서 정의되었습니다.

{
    if (auto World = GetWorld())
    {
        FTimerManager& TM = World->GetTimerManager();
        
        for (const auto& KVP : Entries)
        {
            FTimerHandle TempHandle = KVP.Value.TimerHandle;
            World->GetTimerManager().ClearTimer(TempHandle);
        }
    }
    Entries.Empty();
    OwnerIndex.Empty();
    
    Super::Deinitialize();
}

다음을 참조함 : Entries, OwnerIndex.

◆ Delay()

FDelayHandle UDelayTaskManager::Delay	(	UObject *	Owner,
		float	Seconds,
		TFunction< void()>	Action
	)

UDelayTaskManager.cpp 파일의 42 번째 라인에서 정의되었습니다.

{
    FDelayHandle Out;
    if (!GetWorld() || Seconds < 0.f || !Action)
        return Out;
 
    const uint64 SeqIndex = NextSeqIndex++;
 
    FTimerHandle Handle;
    FTimerDelegate D;
    D.BindUObject(this, &UDelayTaskManager::ExecuteById, SeqIndex); // 핸들 대신 Seq 바인딩
 
    GetWorld()->GetTimerManager().SetTimer(Handle, D, Seconds, /*bLoop=*/false);
 
    FEntry& E  = Entries.Add(SeqIndex);
    E.Owner    = Owner;
    E.Action   = MoveTemp(Action);
    E.SeqIndex = SeqIndex;
    E.TimerHandle = Handle;
 
    if (Owner)
    {
        OwnerIndex.Add(Owner, SeqIndex);
    }
 
    Out.SeqIndex = SeqIndex;
    return Out;
}

다음을 참조함 : UDelayTaskManager::FEntry::Action, Entries, ExecuteById(), NextSeqIndex, UDelayTaskManager::FEntry::Owner, OwnerIndex, FDelayHandle::SeqIndex, UDelayTaskManager::FEntry::SeqIndex, UDelayTaskManager::FEntry::TimerHandle.

다음에 의해서 참조됨 : DelayCallBack().

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

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

◆ DelayCallBack()

FDelayHandle UDelayTaskManager::DelayCallBack	(	UObject *	Owner,
		float	Seconds,
		FDelayCallback	Callback
	)

UDelayTaskManager.cpp 파일의 34 번째 라인에서 정의되었습니다.

{
    return Delay(Owner, Seconds, [Callback]() {
        if (Callback.IsBound())
            Callback.Execute();
    });
}

다음을 참조함 : Delay().

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

◆ ExecuteById()

void UDelayTaskManager::ExecuteById ( uint64 SeqIndex )

private

UDelayTaskManager.cpp 파일의 141 번째 라인에서 정의되었습니다.

{
    FEntry Entry;
    if (!Entries.RemoveAndCopyValue(SeqIndex, Entry))
    {
        return;
    }
 
    const bool bOwnerValid = Entry.Owner.IsValid();
    if (bOwnerValid  && Entry.Action )
    {
        Entry.Action();
    }
 
    OwnerIndex.RemoveSingle(Entry.Owner, SeqIndex);
}

다음을 참조함 : UDelayTaskManager::FEntry::Action, Entries, UDelayTaskManager::FEntry::Owner, OwnerIndex.

다음에 의해서 참조됨 : Delay(), NextTick().

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

◆ Initialize()

void UDelayTaskManager::Initialize ( FSubsystemCollectionBase & Collection )

overridevirtual

UDelayTaskManager.cpp 파일의 11 번째 라인에서 정의되었습니다.

{
    Super::Initialize(Collection);
}

◆ NextTick()

FDelayHandle UDelayTaskManager::NextTick	(	UObject *	Owner,
		TFunction< void()>	Action
	)

UDelayTaskManager.cpp 파일의 71 번째 라인에서 정의되었습니다.

{
    FDelayHandle Out;
    if (!GetWorld() || !Action)
        return Out;
 
    const uint64 SeqIndex = NextSeqIndex++;
 
    // 다음 틱 보장 & 취소 가능성을 위해 0초 타이머 사용(엔진은 다음 프레임에 실행)
    FTimerHandle Handle;
    FTimerDelegate D;
    D.BindUObject(this, &UDelayTaskManager::ExecuteById, SeqIndex);
 
    GetWorld()->GetTimerManager().SetTimer(Handle, D, /*Rate=*/0.0f, /*bLoop=*/false);
    
    FEntry& E  = Entries.Add(SeqIndex);
    E.Owner    = Owner;
    E.Action   = MoveTemp(Action);
    E.SeqIndex = SeqIndex;
    E.TimerHandle = Handle;
 
    if (Owner)
    {
        OwnerIndex.Add(Owner, SeqIndex);
    }
    
    Out.SeqIndex = SeqIndex;
    return Out;
}

다음을 참조함 : UDelayTaskManager::FEntry::Action, Entries, ExecuteById(), NextSeqIndex, UDelayTaskManager::FEntry::Owner, OwnerIndex, FDelayHandle::SeqIndex, UDelayTaskManager::FEntry::SeqIndex, UDelayTaskManager::FEntry::TimerHandle.

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

◆ RemoveEntryById()

void UDelayTaskManager::RemoveEntryById ( uint64 SeqIndex )

private

UDelayTaskManager.cpp 파일의 158 번째 라인에서 정의되었습니다.

{
    if (FEntry* Found = Entries.Find(SeqIndex))
    {
        OwnerIndex.RemoveSingle(Found->Owner, SeqIndex);
        Entries.Remove(SeqIndex);
    }
}

다음을 참조함 : Entries, OwnerIndex.

멤버 데이터 문서화

◆ Entries

TMap<uint64, FEntry> UDelayTaskManager::Entries

private

UDelayTaskManager.h 파일의 81 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Cancel(), CancelAll(), Deinitialize(), Delay(), ExecuteById(), NextTick(), RemoveEntryById().

◆ NextSeqIndex

uint64 UDelayTaskManager::NextSeqIndex = 1

private

UDelayTaskManager.h 파일의 87 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Delay(), NextTick().

◆ OwnerIndex

TMultiMap<TWeakObjectPtr<UObject>, uint64> UDelayTaskManager::OwnerIndex

private

UDelayTaskManager.h 파일의 84 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Cancel(), CancelAll(), Deinitialize(), Delay(), ExecuteById(), NextTick(), RemoveEntryById().

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

Source/LatteLibrary/Manager/Public/UDelayTaskManager.h
Source/LatteLibrary/Manager/Private/UDelayTaskManager.cpp

클래스

Public 멤버 함수

Private 멤버 함수

Private 속성

상세한 설명

멤버 함수 문서화

◆ Cancel()

◆ CancelAll()

◆ DEFINE_SUBSYSTEM_GETTER_INLINE()

◆ Deinitialize()

◆ Delay()

◆ DelayCallBack()

◆ ExecuteById()

◆ Initialize()

◆ NextTick()

◆ RemoveEntryById()

멤버 데이터 문서화

◆ Entries

◆ NextSeqIndex

◆ OwnerIndex