Load Level Instance
ILevelInstanceInterfaceЧто это
Функция синхронно загружает Level Instance (под-уровень) в текущий мир. Возвращает ссылку на Actor, представляющий загруженный Level Instance. Тип: exec (не pure, не async).
Пины
Exec-входы:
- execute (exec) — запуск загрузки
Exec-выходы:
- then (exec) — продолжение выполнения после завершения загрузки
Входы (данные):
- Target (ILevelInstanceInterface) — ссылка на Level Instance Actor, в который загружается под-уровень (обычно self)
- Level (Soft Object Reference) — ассет Level Instance (UWorld), который нужно загрузить
- Location (Vector) — местоположение загружаемого Level Instance в мире
- Rotation (Rotator) — поворот загружаемого Level Instance
Выходы (данные):
- ReturnValue (Actor) — ссылка на загруженный Level Instance Actor (или nullptr при неудаче)
Когда используется
Для динамической подгрузки под-уровней во время игры: процедурная генерация миров, открытие зон/комнат, загрузка больших уровней по частям.
Типичные проблемы
- Указан неверный путь к Level Instance ассету (Soft Object Reference не ссылается на корректный UWorld).
- Попытка загрузить уже загруженный Level Instance без предварительной выгрузки — может привести к дублированию или ошибке.
- Неправильно заданы Location/Rotation — Level Instance может появиться в неожиданном месте или перекрыть другие объекты.