Unreal Engine のアクタのライフサイクル | Unreal Engine 5.4 ドキュメンテーション

このドキュメントでは、アクタのライフサイクルの概要について説明しています。これには、以下の内容が含まれます。

アクタがレベル内にインスタンス化またはスポーンされる方法 (アクタの初期化方法を含む)。
アクタが PendingKill としてマークされてから、ガーベジコレクションによって削除または破棄される方法。
以下のフローチャートは、アクタのインスタンス化方法の主要なパスを示しています。アクタの作成方法に関係なく、破棄は同じパスをたどります。

ライフサイクルの詳細

ディスクからロードする

このディスクからロードするパスは、レベルに配置済みのすべてのアクタがたどります。たとえば、UEngine::LoadMap が発生したときや、レベルストリーミングによって UWorld::AddToWorld が呼び出されたときなどです。

パッケージ/レベルに配置するアクタはディスクからロードします。
シリアル化されたアクタが、ディスクからのロード完了後に PostLoad を呼び出します。カスタム仕様のバージョン管理や修正の動作はここで実装する必要があります。PostLoad は AActor::PostActorCreated に対して相互排他的です。
ワールドが UAISystemBase::InitializeActorsForPlay を呼び出し、アクタのゲームプレイ開始を準備します。
初期化されていないアクタを対象とし、シームレスな移行の引き継ぎのため、レベルが ULevel::RouteActorInitialize を呼び出します。

1.AActor::PreInitializeComponents は、アクタのコンポーネントに InitializeComponent が呼び出される前に呼び出されます。 1.UActorComponent::InitializeComponent は、アクタに定義した各コンポーネントを作成するヘルパー関数です。 1.AActor::PostInitializeComponents は、アクタのコンポーネントが初期化された後に呼び出されます。
AActor::BeginPlay は、レベルが開始すると呼び出されます。

Play in Editor

Play in Editor パスでは、アクタはディスクからロードされるのではなく、エディタからコピーされます。続いて、ディスクからロードするパスで説明したのと同様のフローでコピーされたアクタが初期化されます。

エディタのアクタは新しいワールドで複製されます。
UObject::PostDuplicate が呼び出されます。
UAISystemBase::InitializeActorsForPlay
ULevel::RouteActorInitialize は初期化されていないアクタを対象とし、シームレスな移行の引き継ぎに対応します。

1.AActor::PreInitializeComponents は、アクタのコンポーネントに InitializeComponent が呼び出される前に呼び出されます。 1.UActorComponent::InitializeComponent は、アクタに定義した各コンポーネントを作成するヘルパー関数です。 1.AActor::PostInitializeComponents は、アクタのコンポーネントが初期化された後に呼び出されます。
AActor::BeginPlay は、レベルが開始すると呼び出されます。

スポーン中

アクタのインスタンスをスポーンする場合、次のパスをたどります。

UWorld::SpawnActor が呼び出されます。
アクタがワールド内にスポーンされた後で AActor::PostSpawnInitialize が呼び出されます。
AActor::PostActorCreated が、スポーン済みのアクタに対し、その作成後に呼び出されます。コンストラクタの実装動作はここで行います。PostActorCreated は、PostLoad に対して相互排他的です。
AActor::ExecuteConstruction：
AActor::OnConstruction - アクタの構築です。ここでブループリントのアクタのコンポーネントが作成されて、ブループリントの変数が初期化されます。
AActor::PostActorConstruction：

1.AActor::PreInitializeComponents は、アクタのコンポーネントに InitializeComponent が呼び出される前に呼び出されます。 1.UActorComponent::InitializeComponent は、アクタに定義した各コンポーネントを作成するヘルパー関数です。 1.AActor::PostInitializeComponents は、アクタのコンポーネントが初期化された後に呼び出されます。
UWorld::OnActorSpawned は、UWorld でのブロードキャストです。
AActor::BeginPlay が呼び出されます。

ディファードスポーン

アクタは、いずれかのプロパティが "Expose on Spawn" に設定されていると、ディファードスポーン (スポーンを先送り) することができます。

UWorld::SpawnActorDeferred は、プロシージャルなアクタをスポーンすることを目的としており、ブループリントコンストラクションスクリプトの前の追加設定を許可します。
SpawnActor のすべてが発生しますが、AActor::PostActorCreated の後に以下が発生します。

1.有効だが不完全なアクタのインスタンスを使って、さまざまな初期化関数の設定および呼び出しを行います。 1.AActor::FinishSpawning がアクタを確定するために呼び出されます。スポーンアクタの並びにある AActor::ExecuteConstruction でピックアップします。

アクタのライフサイクルの終了

アクタは複数の方法で破棄できますが、ワールドから削除される方法は同じ方法に従います。ゲームプレイ中に、以下の関数を呼び出すことができます。ただし、多くのアクタは実際にはプレイ中に破棄されないため、これらは完全に任意です (「ガーベジコレクション」を参照)。

AActor::Destroy アクタを削除しようとするたびにゲームによって手動で呼び出されますが、ゲームプレイはまだ続いています。アクタにはキル保留とマーク付けされ、レベルの一連のアクタから取り除かれます。
AActor::EndPlayアクタの存続期間が終了することを保証するために複数の場所で呼び出されます。プレイ中に Destroy がこのメソッドを呼び出し、アクタを含むストリーミングレベルがアンロード済みの場合はレベルが移行します。
EndPlay は、次によって呼び出されます。
- Destroy への明示的な呼び出し。
- Play in Editor の終了時。
- レベルの移行 (シームレスな移行またはマップのロード)。
- アクタを含むストリーミングレベルがアンロードされている。
- アクタの存続期間が終了した。
- アプリケーションのシャットダウン (すべてのアクタが破棄された)。

どのように発生するかには関係なく、次のガーベジコレクションサイクルでメモリを解放するために、アクタは RF_PendingKill とマークされます。また手動で保留中のキルをチェックせずに、よりクリーンな FWeakObjectPtr<AActor> を使用することを検討してください。

アクタは、EndPlay の呼び出し時に必ずしも破棄しなければならないわけではありません。たとえば、s.ForceGCAfterLevelStreamedOut が false の場合に、サブレベルがすぐにリロードされてからアクタの EndPlay が呼び出されても、アクタは「復活」し、デフォルトに再初期化されていないローカル変数とともに、以前に存在していたのとまったく同じものになる場合があります

AActor::OnDestroyed - Destroy に対するレガシー応答です。レベル移行や別のゲームクリーンアップ関数によって呼び出されるため、ここにあるものすべてを EndPlay へ移動することをお勧めします。

ガーベジコレクション

オブジェクトが破棄の対象としてマークされてからしばらくすると、ガーベジコレクションによってそのオブジェクトはメモリから削除され、オブジェクトが使用していた全リソースが解放されます。

以下の関数はオブジェクトの破棄中に呼び出されます。

UObject::BeginDestroy - オブジェクトがメモリを解放して別のマルチスレッドリソースを処理する機会です (グラフィックスレッドプロキシオブジェクトなど)。破棄されているものに関連するほとんどのゲームプレイ機能は、EndPlay で以前に処理されているはずです。
UObject::IsReadyForFinishDestroy - ガーベジコレクションプロセスでは、この関数を呼び出して、オブジェクトがメモリを永続的に解放する準備が整っているかを判断します。false を返すことで、この関数は実際のオブジェクトの破棄を次のガーベジコレクションパスまで遅らせます。
UObject::FinishDestroy - 最後にオブジェクトは実際に破棄されます。また、これは内部データ構造を解放する別の機会となります。これはメモリが解放される前の最後の呼び出しになります。

高度なガーベジコレクション

Unreal Engine のガーベジコレクションプロセスでは、まとめて破棄されるオブジェクトのクラスタを構築します。クラスタ化 することでオブジェクトを個別に削除するのに比べて、ガーベジコレクションに関連する合計時間と全体的なメモリチャーン (確保開放の繰り返し) を減らします。オブジェクトがロードすると、サブオブジェクトを作成することがあります。オブジェクトがロードすると、サブオブジェクトを作成することがあります。オブジェクトとそのサブオブジェクトをガーベジコレクタのためにひとつのクラスタにまとめることでクラスタが使うリソースの解放を遅延させて、すべてのリソースを一度に解放することができます。

ガーベジコレクションはほとんどのオブジェクトに対して設定したり、修正する必要はありません。しかし、ガーベジコレクターのクラスタリングの挙動を以下のように変更して効率を高めるように変更できる特殊なケースがあります。

Clustering - クラスタリングをオフにします。[Project Settings] の [Garbage Collection] セクションで、[Create Garbage Collector UObject Clusters] オプションを false に設定することができます。ほとんどのプロジェクトでは、これは効率性が低いガーベジコレクションになります。そのため、これは性能テストの結果、確実に成果があるとわかった場合に限り行うことをお勧めします。

[Project Settings (プロジェクト設定)] メニュー内のガーベジコレクションのクラスタオプション。