[Unreal][C++] 타이머

1. 타이머

타이머는 사용자가 정의한 시간마다 사용자가 지정한 동작이 실행되도록 한다. 이러한 기능은 Tick 함수에서 DeltaTime 값을 통해 구현할 수도 있다. 그러나 지정한 동작이 지속적으로 실행되지 않고, 특정한 시간에만 몇 번 실행되거나, 텀이 1초를 넘는 경우라면 Tick 함수보다 타이머를 이용하는 것이 좋다.

• 글로벌 TimerManager에서 관리하며 게임 인스턴스 오브젝트와 각 월드에 존재한다.
• TimerManager를 통해 타이머를 가져와 사용하거나 종료시킬 수 있다.

 

2. 사용

1) 사용

SetTimer 함수를 통해 딜레이 후 함수나 델리게이트를 호출하는 타이머를 설정하거나 그 함수 호출을 무한 반복하도록 설정할 수 있다.

GetWorldTimerManager().SetTimer(
	FTimerHandle & InOutHandle,
	UserClass * InObj,
	Function,
	float InRate,
	bool InbLoop = false,
	float InFirstDelay = -1.f);

• InOutHandle: 타이머를 관리하기 위한 것으로 일시정지, 재개, 취소 등에 사용된다
• Function: 타이머가 돌아가면서 호출될 함수이다.

 

2) 해제

SetTimer 함수에 전달한 타이머 핸들을 ClearTimer 함수에 전달하면 타이머를 해제시킬 수 있다. 이 시점에서 기존의 타이머 핸들은 유효하지 않은 상태가 되며 새로운 타이머 관리를 위해 재사용할 수 있다.

GetWorldTimerManager().ClearTimer(FTimerHandle& InHandle);

 

3. 활용

void AMyActor::BeginPlay()
{
    Super::BeginPlay();
    // RepeatingFunction 을 초당 1 회, 지금부터 2 초간 호출합니다.
    GetWorldTimerManager().SetTimer(MemberTimerHandle, this, &AMyActor::RepeatingFunction, 1.0f, true, 2.0f);
}

void AMyActor::RepeatingFunction()
{
    // 이 함수를 충분히 호출했으면, 타이머를 해제합니다.
    if (--RepeatingCallsRemaining <= 0)
    {
        GetWorldTimerManager().ClearTimer(MemberTimerHandle);
        // MemberTimerHandle 은 이제 다른 타이머에 재사용 가능합니다.
    }
    // 여기서 어떤 작업을 합니다...
}

 

참고

https://docs.unrealengine.com/4.27/ko/ProgrammingAndScripting/ProgrammingWithCPP/UnrealArchitecture/Timers/

게임플레이 타이머