Get Level Script Actor
LevelStreamingЧто это
Pure-функция, возвращающая актёра скрипта уровня (Level Script Actor) для указанного объекта LevelStreaming. Позволяет получить доступ к пользовательским событиям и функциям, определённым в Blueprint этого уровня. Тип — pure (не требует exec-пинов, выполняется мгновенно).
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (Level Streaming Object Reference) — объект потокового уровня, для которого нужно получить скрипт уровня.
Выходы (данные):
- Return Value (Actor Object Reference) — актёр скрипта уровня (Level Script Actor). Если уровень не загружен или объект недействителен —
null.
Когда используется
Когда нужно вызвать пользовательскую функцию (например, OnLevelStart, OpenDoor) из другого Blueprint или передать данные в скрипт загруженного потокового уровня. Также применяется для проверки состояния уровня через его скрипт.
Типичные проблемы
- Вызов функции до полной загрузки уровня —
Return Valueбудетnull. Перед использованием стоит проверять, загружен ли уровень (например, черезIsLevelLoaded). - Передача невалидного/удалённого объекта
LevelStreaming— возвращаетnull. - Попытка приведения
Return Valueк кастомному типу без проверки наnull— краш редактора/игры.