Begin Deferred Actor Spawn From Class
GameplayStaticsЧто это
Exec-функция из класса GameplayStatics. Начинает отложенный спавн актора (deferred spawning) — создаёт экземпляр класса, но не завершает его инициализацию. Позволяет изменить свойства актора (переменные, компоненты) до вызова FinishSpawningActor. Не является pure или latent — обычный exec-узел.
Пины
Exec-входы:
- execute (exec) — запуск спавна.
Exec-выходы:
- then (exec) — продолжение после успешного создания экземпляра.
Входы (данные):
- World Context Object (Object) — контекст (обычно
selfилиGameMode). - Actor Class (TSubclassOf<AActor>) — класс спавнимого актора.
- Location (Vector) — позиция спавна.
- Rotation (Rotator) — поворот.
- Owner (AActor) — владелец (опционально, по умолчанию
None). - Instigator (APawn) — инициирующий актор (опционально, по умолчанию
None). - Collision Handling Method (ESpawnActorCollisionHandlingMethod / byte) — способ обработки коллизий при спавне (по умолчанию
Undefined).
Выходы (данные):
- ReturnValue (AActor) — созданный актор (ещё не завершённый). Его нужно сохранить, изменить при необходимости и передать в
FinishSpawningActor.
Когда используется
- Когда нужно спавнить актор и сразу подстроить его переменные (например, задать цвет, размер, параметры поведения) до того, как он будет полностью инициализирован.
- Для кастомных процедурных систем спавна (подбор оружия, генерация врагов с разными характеристиками).
Типичные проблемы
- Забыть вызвать
FinishSpawningActor— актор останется «висящим» в отложенном состоянии и никогда не завершит инициализацию, что приведёт к утечке или крашу. - Неправильно указать
Collision Handling Method— актор может застрять внутри других объектов или игнорировать коллизию, если выбран не тот метод. - Передать неверный
Actor Class(например, классBlueprintс неправильным родителем) — спавн не сработает и вернётNone. Всегда проверяйтеReturnValueчерезIs Valid.