Get Data Layer Instance From Asset
DataLayerManagerЧто это
Pure-функция, возвращающая экземпляр дата-леера (UDataLayerInstance) по его ассету в текущем мире. Позволяет получить ссылку на инстанс леера для дальнейшего управления (активация, деактивация, проверка состояния). Выполняется синхронно, не требует exec-соединений.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (UDataLayerSubsystem*) — подсистема дата-лееров текущего мира.
- DataLayerAsset (UDataLayerAsset*) — ассет дата-леера, для которого нужно получить инстанс.
Выходы (данные):
- ReturnValue (UDataLayerInstance*) — найденный экземпляр дата-леера, либо nullptr, если указанный леер отсутствует в текущем мире.
Когда используется
- Для получения активного инстанса дата-леера в рантайме по сохранённой ссылке на ассет.
- Перед вызовом методов активации/деактивации леера, когда нужна гарантия, что леер существует в текущем уровне.
Типичные проблемы
- Передача ассета леера, который не был добавлен в текущий мир, приводит к возврату
nullptr— результат обязательно проверять перед использованием. - Вызов функции до полной инициализации DataLayerSubsystem (например, слишком рано в
BeginPlay) может вернутьnullptr— рекомендуется вызывать после старта игры. - Путаница типов: функция ожидает именно
UDataLayerAsset*, а неFNameилиUDataLayerInstance*(последний — это уже результат, а не вход).