游戏引擎 / 系统课时

处理Actor生命周期

处理Actor生命周期

Actor 从进入游戏世界到离开世界会经历一组明确的生命周期回调。掌握这些时机后,你可以把初始化、逐帧更新、清理和重生放到正确位置,避免重复初始化、无意义 Tick 或对象销毁后仍被访问等常见问题。

学习目标

  • 区分 BeginPlay、Tick、EndPlay 与 Destroy 的职责
  • 能为只在存活期工作的逻辑选择正确回调
  • 理解“销毁后重生”本质上是创建新的 Actor 实例

从进入世界到离开世界

对 Gameplay 代码最常用的主线可以简化为:Actor 完成创建与初始化后进入 BeginPlay,存活期间按需执行 Tick,离开当前世界时进入 EndPlay。主动调用 Destroy() 或寿命到期只是触发离场的原因之一。

Actor从开始游戏到结束播放的生命周期

BeginPlay() 适合依赖“世界已经开始运行”的初始化,例如查找运行时对象、启动计时器或初始化 Gameplay 状态。构造函数更适合创建默认组件和设置默认值,不应把依赖关卡运行状态的逻辑塞进构造函数。

Tick(float DeltaSeconds) 每帧调用,但默认并不会自动启用。只有确实需要连续更新时才设置 PrimaryActorTick.bCanEverTick = true。如果逻辑只需定时执行、响应事件或等待碰撞,优先使用 Timer、Delegate 或事件,能减少大量空 Tick。

EndPlay() 用于 Actor 即将离开当前世界时的收尾,例如解绑委托、停止外部任务或释放由本对象持有的运行时关系。它不仅对应手动销毁,也可能由关卡切换、PIE 结束等原因触发,因此比只在某个销毁路径里清理更稳妥。

用代码观察生命周期顺序

下面创建一个 ALifecycleProbe。它开启 Tick,每秒打印一次存活时间,并通过 SetLifeSpan(3.2f) 让自己自动销毁。把类放入关卡后运行 PIE,就能观察 BeginPlay、Tick 和 EndPlay 的实际顺序。

cpp
// 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);
}

预期输出

text
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 的初始化、运行和清理边界就越容易测试,也更不容易产生隐蔽的状态残留。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理Actor生命周期

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通