Get World Asset Package FName
LevelStreamingЧто это
Pure-функция, возвращающая имя пакета ассета мира (уровня), связанного с объектом Level Streaming. Возвращаемое значение — FName — содержит полный путь к файлу подуровня в формате, используемом движком для ссылок на пакеты. Не изменяет состояние, может вызываться в любом месте графа без привязки к выполнению.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Level Streaming Object Reference) — ссылка на объект стриминга уровня, для которого запрашивается имя пакета (обычно подключается автоматически как
self).
Выходы (данные):
- Return Value (FName) — имя пакета ассета мира (например,
/Game/Maps/MySublevel).
Когда используется
- Для программной идентификации подуровня по его пакету (например, при проверке, какой уровень загружен в данный момент).
- Для построения логики стриминга уровней: сравнение
Return Valueс известными именами пакетов, чтобы решить, выгружать или загружать подуровень. - Для отладки и логирования: если нужно вывести в консоль или HUD имя текущего стриминг-уровня.
Типичные проблемы
- Путаница с похожими функциями.
GetWorldAssetPackageFNameвозвращаетFName, аGetWorldAssetPackage—FString. Если ожидается строковое сравнение без учёта регистра (FName сравнивается как FName), можно получить неожиданный результат при прямом сравнении со строковым литералом. - Использование на неправильном объекте. Функция вызывается на экземпляре
Level Streaming(обычно полученном изGet Streaming Levels). Если вызвать её наWorldилиGame Instance, произойдёт ошибка приведения типа. - FName не всегда содержит полный путь. В некоторых контекстах (например, при загрузке уровня из asset registry) имя может быть коротким (только название). Для надёжного сравнения рекомендуется использовать
GetWorldAssetPackage(FString) или проверять черезIsValid()сам объект стриминга.