Unreal Engine Actor Lifecycle | 虚幻引擎 5.1 文档

此文档是 Actor 生命周期的高级概述：Actor 如何被实例化（生成）到关卡中，以及如何被移除（销毁）。

以下流程图展示了 Actor 被实例的三种主要路径。无论 Actor 的创建方式如何，销毁路径均相同。

生命周期详解

已位于关卡中的 Actor 使用此路径，如 LoadMap 发生时、或 AddToWorld（从流关卡或子关卡）被调用时。

包/关卡中的 Actor 从磁盘中进行加载。
PostLoad - 在序列化 Actor 从磁盘加载完成后被调用。在此处可执行自定义版本化和修复操作。PostLoad 与 PostActorCreated 互斥。
InitializeActorsForPlay
为未初始化的 Actor 执行 RouteActorInitialize（包含无缝行程携带）
1. PreInitializeComponents - 在 Actor 的组件上调用 InitializeComponent 之前进行调用。
2. InitializeComponent - Actor 上定义的每个组件的创建辅助函数。
3. PostInitializeComponents - Actor 的组件初始化后调用。
BeginPlay - 关卡开始后调用。

Play in Editor 路径与 Load from Disk 十分相似，然而 Actor 却并非从磁盘中加载，而是从编辑器中复制而来。

编辑器中的 Actor 被复制到新场景中。
PostDuplicate 被调用。
InitializeActorsForPlay
为未初始化的 Actor 执行 RouteActorInitialize（包含无缝行程携带）。
1. PreInitializeComponents - 在 Actor 的组件上调用 InitializeComponent 之前进行调用。
2. InitializeComponent - Actor 上定义的每个组件的创建辅助函数。
3. PostInitializeComponents - Actor 的组件初始化后调用。
BeginPlay - 关卡开始后调用。

这是生成（实例）Actor 时的路径。

SpawnActor 被调用。
PostSpawnInitialize
PostActorCreated - 创建后即被生成的 Actor 调用，构建函数类行为在此发生。PostActorCreated 与 PostLoad 互斥。
ExecuteConstruction：
- OnConstruction - Actor 的构建。蓝图 Actor 的组件在此处创建，蓝图变量在此处初始化
PostActorConstruction：
1. PreInitializeComponents - 在 Actor 的组件上调用 InitializeComponent 之前进行调用。
2. InitializeComponent - Actor 上定义的每个组件的创建辅助函数。
3. PostInitializeComponents - Actor 的组件初始化后调用。
OnActorSpawned 在 UWorld 上播放。
BeginPlay 被调用。

将任意属性设为"Expose on Spawn"即可延迟 Actor 的生成。

SpawnActorDeferred - 生成程序化 Actor，在蓝图构建脚本之前进行额外设置。
SpawnActor 中的所有操作发生；PostActorCreated 之后发生以下操作：
1. 通过一个有效但不完整的 Actor 实例设置/调用多个"初始化函数"。
2. FinishSpawningActor -调用后对 Actor 进行最终化，在 Spawn Actor 行中选取 ExecuteConstruction。

销毁 Actor 的方式有许多种，但终结其存在的方式始终如一。

它们完全为任选，因为许多 Actor 在游戏进程中不会实际消亡。

Destroy - 游戏在 Actor 需要被移除时手动调用，但游戏进程仍在继续。Actor 被标记为等待销毁并从关卡的 Actor 阵列中移除。

EndPlay - 在数个地方调用，保证 Actor 的生命走向终点。在游戏过程中，如包含流关卡的 Actor 被卸载，Destroy 将发射此项和关卡过渡。调用 EndPlay 的全部情形：

无论这些情形出现的方式如何，Actor 都将被标记为 RF_PendingKill，因此在下个垃圾回收周期中它将被解除分配。此外，可以考虑使用更整洁的 FWeakObjectPtr<AActor> 代替手动检查"等待销毁"。

OnDestroy - 这是对 Destroy 的旧有反应。也许应该将这里的所有内容移到 EndPlay，因为它被关卡过渡和其他游戏清理函数调用。

一个对象被标记待销毁的一段时间后，垃圾回收会将其从内存中实际移除，释放其使用的资源。

在对象的销毁过程中，以下函数将被调用：

BeginDestroy - 对象可利用此机会释放内存并处理其他多线程资源（即为图像线程代理对象）。与销毁相关的大多数游戏性功能理应在 EndPlay 中更早地被处理。
IsReadyForFinishDestroy - 垃圾回收过程将调用此函数，以确定对象是否可被永久解除分配。返回 false，此函数即可延迟对象的实际销毁，直到下一个垃圾回收过程。
FinishDestroy - 最后对象将被销毁，这是释放内部数据结构的另一个机会。这是内存释放前的最后一次调用。

虚幻引擎 中的垃圾回收过程将构建共同被销毁对象的集群。较之于单个删除对象，集群可减少垃圾回收相关的总体时间和整体内存流失。可能随对象的加载创建子对象。将对象与其子对象组合到垃圾回收器的单个集群后，引擎可延迟释放集群使用的资源，直到整个对象可被释放时一次性释放全部资源。

多数项目中无需对垃圾回收进行配置或修改，但存在一些特定情况 - 可以如下方式对垃圾回收器的"集群"行为进行调整，以提高效率：

垃圾回收的集群合并选项位于项目设置菜单中。