官方文档:虚幻引擎中的Gameplay定时器 | 虚幻引擎 5.5 文档 | Epic Developer Community | Epic Developer Community
定时器
安排在经过一定延迟或一段时间结束后要执行的操作。例如,您可能希望玩家在获取某个能力提升道具后变得无懈可击,然后10秒钟后恢复可受伤害状态。又或者,您可能希望玩家在穿过一间充满毒气的房间时,每秒受到一次伤害。这些操作都可以使用定时器来实现。
注意:定时器消耗比较大,可用虚幻自带的GAS框架进行大消耗的更新等操作。
基础写法
先创建一个继承于Actor的类命名为TimerActor。
在头文件添加代码:
public:
//此函数具有重复调用作用
void RepeatingFunction();
protected:
//定义一个定时器
FTimerHandle MyTimerHandle;
//定时3秒
int32 RepeatingCallsRemaining = 3;
在源文件添加代码:
void ATimerActor::BeginPlay()
{
Super::BeginPlay();
//拿到时间管理器
FTimerManager& ThisTimerManager = GetWorldTimerManager();
ThisTimerManager.SetTimer(MyTimerHandle, this, &ATimerActor::RepeatingFunction, 1.0f, true, 2.0f);
}
void ATimerActor::RepeatingFunction()
{
// 调用该函数达到足够次数后,清空定时器。
if (--RepeatingCallsRemaining <= 0)//此写法为先减在判断
{
GetWorldTimerManager().ClearTimer(MyTimerHandle);
//在输出日志去查看效果
UE_LOG(LogTemp, Warning, TEXT("Timer End!"));
}
// 在此进行一些操作...
}
在Output Log中经过3秒显示自定义日志。
引擎源码片段:
SetTimer()
ClearTimer()
进阶写法
先创建一个继承于Actor的类命名为TimerActor。
在头文件添加代码:
public:
//渲染组件,将定时器显示在场景中
class UTextRenderComponent* CountdownText;
protected:
void AdvanceTimer();
void UpdataTimerDisplay();
//此宏可将其在蓝图进行调用
UFUNCTION(BlueprintNativeEvent)
void CountdownHasFinshed();
protected:
//可在编辑器进行修改
UPROPERTY(EditAnywhere)
int32 CountdownTime;
FTimerHandle CountdownTimerHandle;
在基于此类创建的蓝图子类中:
在源文件添加代码:
//先添加头文件,以调用组件
#include"Components/TextRenderComponent.h"
先在默认构造函数中进行初始定义:
ALearnCountDownActor::ALearnCountDownActor()
{
// Set this actor to call Tick() every frame. You can turn this off to improve performance if you don't need it.
PrimaryActorTick.bCanEverTick = false;
CountdownText = CreateDefaultSubobject<UTextRenderComponent>(TEXT("CountdownNumber"));//可在蓝图组件处查看到名称
CountdownText->SetHorizontalAlignment(EHTA_Center);//设置水平对齐
CountdownText->SetWorldSize(150.0f);
RootComponent = CountdownText;
CountdownTime = 3;
}
void ALearnCountDownActor::UpdataTimerDisplay()
{
CountdownText->SetText(FText::FromString(FString::FromInt(FMath::Max(CountdownTime,0))));//此处类型转换
}
//_Implementation表明原生实现
void ALearnCountDownActor::CountdownHasFinshed_Implementation()
{
//改为特殊读出
CountdownText->SetText(FText::FromString(TEXT("Finsh!")));
}
void ALearnCountDownActor::AdvanceTimer()
{
--CountdownTime;
//此处类似递归
UpdataTimerDisplay();
if (CountdownTime < 1)
{
//倒数完成,停止运行定时器
GetWorldTimerManager().ClearTimer(CountdownTimerHandle);
CountdownHasFinshed();//出口
}
}
void ALearnCountDownActor::BeginPlay()
{
Super::BeginPlay();
//先更新
UpdataTimerDisplay();
GetWorldTimerManager().SetTimer(CountdownTimerHandle, this, &ALearnCountDownActor::AdvanceTimer, 1.0f, true);
}
思路: 先进行初始化,用FMath::Max取最大值返回数值从而更新,在AdvanceTimer函数中运用类似递归思想进行循环并结束,上述做法单独为一个函数,将其返回的参数在BeginPlay()中用GetWorldTimerManager().SetTimer进行处理。