Unload Stream Level (by Name)
GameplayStaticsЧто это
Latent-функция из GameplayStatics. Выгружает стриминг-уровень по его имени. Не блокирует выполнение, если Should Block On Unload = false; тогда завершение отслеживается по exec-выходу Completed.
Пины
Exec-входы:
- execute (exec) — запуск выгрузки.
Exec-выходы:
- Completed (exec) — срабатывает после завершения выгрузки уровня.
Входы (данные):
- World Context Object (Object) — контекст мира (обычно self или GameInstance).
- Level Name (Name) — имя выгружаемого уровня (без пути и суффикса
_C, просто имя ассета). - Should Block On Unload (bool) — если
true, поток блокируется до полной выгрузки; еслиfalse— функция асинхронная.
Выходы (данные):
- нет (void).
Когда используется
При необходимости выгрузить стриминг-уровень, например для освобождения памяти при удалении от локации или для замены уровней в открытом мире. Используется в паре с LoadStream Level.
Типичные проблемы
- Указано неверное имя уровня (с суффиксом
_Cили с путём). Должно быть просто имя ассета уровня (например,MyLevel, а не/Game/Maps/MyLevelилиMyLevel_C). - Забыли подключить
Completedк следующему действию (допустим, загрузка другого уровня на то же место) приShould Block = false. Код выполнится до фактической выгрузки, что приведёт к конфликтам. - Невалидный
World Context Object(например, разрушенный actor) — функция проигнорирует вызов.