Get Level
ActorЧто это
Pure-функция, возвращающая уровень (ULevel*), которому принадлежит данный актор. Используется для получения ссылки на уровень как на объект — например, чтобы узнать имя уровня, получить его ALevelScriptActor или проверить, является ли уровень персистентным. Не требует exec-пинов, может вызываться в любом месте графа как источник данных.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Actor Object Reference) — актор, для которого запрашивается уровень.
Выходы (данные):
- Return Value (Level Object Reference) — объект уровня, содержащего этот актор.
Когда используется
- Получение имени уровня (
GetNameилиGet Display Name). - Доступ к Level Blueprint через
Get Level Script Actor. - Проверка, находится ли актор в определённом уровне (например, в мире или в суб-уровне).
- Передача ссылки на уровень в функции, требующие
ULevel*(например, манипуляции с Level Streaming).
Типичные проблемы
- Null-ссылка на уровень. Если актор не привязан к миру (находится в процессе спауна или был удалён), возвращаемый
Return Valueможет бытьNone(null). Перед использованием ссылки на уровень рекомендуется проверкаIs Valid. - Путаница с
Get World.Get Levelвозвращает именно объект уровня (содержит только акторов данного Sub‑Level), а не мир. Для доступа к глобальным настройкам (Gravity, World Settings и т.д.) нуженGet World. - Работа с динамически загружаемыми суб-уровнями. Если актор принадлежит выгружаемому суб-уровню, ссылка на уровень может быть невалидной до его загрузки. Выполнять
Get Levelследует только после гарантированной загрузки этого суб-уровня (например, по событиюOn Level Loaded).