Load Stream Level (by Object Reference)
GameplayStatics
0
Что это
Асинхронная загрузка потокового уровня по Soft Object Reference. Не латентная (exec‑функция) — управление возвращается сразу, загрузка идёт в фоне. Позволяет задать, делать ли уровень видимым сразу после загрузки и блокировать ли основной поток до завершения загрузки.
Пины
Exec-входы:
- execute (exec) — запуск операции
Exec-выходы:
- then (exec) — продолжение выполнения сразу после вызова (не дожидаясь загрузки)
Входы (данные):
- World Context (Object Reference) — объект, принадлежащий миру, в котором загружается уровень (обычно self)
- Level (Soft Object Reference) — ссылка на загружаемый уровень (TSoftObjectPtr<UWorld>)
- b Make Visible After Load (bool) — true: сделать уровень видимым сразу после завершения загрузки
- b Should Block On Load (bool) — true: блокировать основной поток до полной загрузки уровня (может вызвать задержку)
Выходы (данные):
- нет (void)
Когда используется
- Загрузка стриминговых подуровней открытого мира по мере приближения игрока.
- Управление загрузкой/выгрузкой уровней для оптимизации производительности.
- Активация дополнительных локаций (например, интерьеров) по триггеру.
Типичные проблемы
- bShouldBlockOnLoad = true — вызовет замирание игры на время загрузки уровня; используйте только для маленьких уровней или экранов загрузки.
- bMakeVisibleAfterLoad = false — уровень загрузится, но не отобразится; его придётся делать видимым отдельно через «Set Level Visibility».
- Пустой Level — Soft Object Reference не установлена или указывает на несуществующий ассет; операция завершится без ошибки, но загрузка не начнётся.
- Неверный World Context — объект не привязан к нужному миру (например, взят из другого уровня); загрузка может произойти в неправильном контексте.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.