Spawn Object
GameplayStaticsЧто это
Статическая функция из библиотеки GameplayStatics, которая создаёт экземпляр произвольного класса UObject (не актора) во время выполнения. Тип — exec (требует подключения по потоку выполнения). Позволяет динамически порождать объекты, не привязанные к уровню (например, объекты данных, менеджеры, компоненты без владельца-актора).
Пины
Exec-входы:
- execute (exec) — запуск спавна
Exec-выходы:
- then (exec) — продолжение после создания объекта
Входы (данные):
- Class (Class Reference) — класс создаваемого объекта (должен быть потомком
UObject, не абстрактным) - Outer (Object Reference) — внешний объект-владелец (обычно
GameInstance,Worldили другой долгоживущий объект;nullptrдопустим, но может привести к утечкам или преждевременной сборке мусора)
Выходы (данные):
- ReturnValue (Object Reference) — ссылка на созданный объект (если не сохранить, объект может быть уничтожен сборщиком мусора)
Когда используется
- Создание временных или постоянных объектов данных (например,
UDataAsset,UObject-наследников с логикой) во время игры. - Генерация объектов, которые не являются акторами (например, менеджеры, пулы объектов, настраиваемые структуры).
Типичные проблемы
- Потеря ссылки на созданный объект — если не присвоить
ReturnValueпеременной (или не добавить объект в корневой набор), сборщик мусора может уничтожить его сразу после выполнения ноды. - Некорректный Outer — передача объекта, который будет уничтожен раньше созданного (например, временный
Actor), приведёт к потере объекта или крашу. Рекомендуется использоватьGameInstanceилиWorldкак владельца. - Класс не поддерживает создание через
NewObject— если класс имеет нетривиальный конструктор с параметрами или помечен какNotBlueprintType, спавн завершится ошибкой (возвратитnull). В таких случаях используйте фабричные методы илиSpawnActorдля акторов.