游戏引擎 / 系统课时
处理Actor生命周期
处理Actor生命周期
Actor 从进入游戏世界到离开世界会经历一组明确的生命周期回调。掌握这些时机后,你可以把初始化、逐帧更新、清理和重生放到正确位置,避免重复初始化、无意义 Tick 或对象销毁后仍被访问等常见问题。
学习目标
- 区分
BeginPlay、Tick、EndPlay与Destroy的职责 - 能为只在存活期工作的逻辑选择正确回调
- 理解“销毁后重生”本质上是创建新的 Actor 实例
从进入世界到离开世界
对 Gameplay 代码最常用的主线可以简化为:Actor 完成创建与初始化后进入 BeginPlay,存活期间按需执行 Tick,离开当前世界时进入 EndPlay。主动调用 Destroy() 或寿命到期只是触发离场的原因之一。

BeginPlay() 适合依赖“世界已经开始运行”的初始化,例如查找运行时对象、启动计时器或初始化 Gameplay 状态。构造函数更适合创建默认组件和设置默认值,不应把依赖关卡运行状态的逻辑塞进构造函数。
Tick(float DeltaSeconds) 每帧调用,但默认并不会自动启用。只有确实需要连续更新时才设置 PrimaryActorTick.bCanEverTick = true。如果逻辑只需定时执行、响应事件或等待碰撞,优先使用 Timer、Delegate 或事件,能减少大量空 Tick。
EndPlay() 用于 Actor 即将离开当前世界时的收尾,例如解绑委托、停止外部任务或释放由本对象持有的运行时关系。它不仅对应手动销毁,也可能由关卡切换、PIE 结束等原因触发,因此比只在某个销毁路径里清理更稳妥。
用代码观察生命周期顺序
下面创建一个 ALifecycleProbe。它开启 Tick,每秒打印一次存活时间,并通过 SetLifeSpan(3.2f) 让自己自动销毁。把类放入关卡后运行 PIE,就能观察 BeginPlay、Tick 和 EndPlay 的实际顺序。
// LifecycleProbe.h
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "LifecycleProbe.generated.h"
UCLASS()
class ALifecycleProbe : public AActor
{
GENERATED_BODY()
public:
ALifecycleProbe();
virtual void Tick(float DeltaSeconds) override;
protected:
virtual void BeginPlay() override;
virtual void EndPlay(const EEndPlayReason::Type EndPlayReason) override;
private:
float ElapsedSeconds = 0.0f;
float NextLogSecond = 1.0f;
};
// LifecycleProbe.cpp
#include "LifecycleProbe.h"
ALifecycleProbe::ALifecycleProbe()
{
PrimaryActorTick.bCanEverTick = true;
}
void ALifecycleProbe::BeginPlay()
{
Super::BeginPlay();
UE_LOG(LogTemp, Display, TEXT("LifecycleProbe BeginPlay"));
SetLifeSpan(3.2f);
}
void ALifecycleProbe::Tick(float DeltaSeconds)
{
Super::Tick(DeltaSeconds);
ElapsedSeconds += DeltaSeconds;
if (ElapsedSeconds >= NextLogSecond)
{
UE_LOG(
LogTemp,
Display,
TEXT("LifecycleProbe Tick second %.0f"),
NextLogSecond
);
NextLogSecond += 1.0f;
}
}
void ALifecycleProbe::EndPlay(const EEndPlayReason::Type EndPlayReason)
{
UE_LOG(LogTemp, Display, TEXT("LifecycleProbe EndPlay"));
Super::EndPlay(EndPlayReason);
}预期输出
LifecycleProbe BeginPlay
LifecycleProbe Tick second 1
LifecycleProbe Tick second 2
LifecycleProbe Tick second 3
LifecycleProbe EndPlay实际日志还会带 Unreal 的时间、线程和日志分类前缀;这里仅保留示例主动打印的正文。SetLifeSpan 到期后 Actor 会被销毁,因此不会继续收到后续 Tick。
销毁不是立即复用对象
调用 Destroy() 后,不要再把该 Actor 引用当成可继续使用的 Gameplay 对象。销毁流程会让 Actor 离开世界;其他对象若长期保存引用,应在使用前检查有效性,并尽量通过事件或拥有关系及时清掉引用。
如果玩法要求“死亡后 3 秒重生”,正确思路不是让已经销毁的实例重新进入 BeginPlay,而是由仍然存活的管理者创建新实例。角色通常由 GameMode、Controller 或专门的 Spawn Manager 负责重生;普通 Actor 也可以由其他长期对象调用 SpawnActor 创建新的实例。
什么时候需要Tick
判断一个功能是否应该放进 Tick,可以先问“它是否真的需要每帧检查”。持续移动、每帧插值或需要逐帧采样的逻辑适合 Tick;冷却结束、延时销毁、属性变化、碰撞进入和网络事件通常更适合事件或 Timer。
如果确实使用 Tick,还应让单帧工作保持短小,并在不需要时调用 SetActorTickEnabled(false)。生命周期代码越明确,Actor 的初始化、运行和清理边界就越容易测试,也更不容易产生隐蔽的状态残留。