Set Data Layer Instance Runtime State
DataLayerManagerЧто это
Exec-функция, устанавливающая состояние выполнения (Unloaded / Loaded / Activated) для указанного экземпляра Data Layer. Позволяет динамически управлять загрузкой и активацией уровней, связанных с Data Layer. Не возвращает значение.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (DataLayerManager) — ссылка на менеджер Data Layers (обычно self)
- Data Layer (DataLayerInstance) — экземпляр Data Layer, состояние которого нужно изменить
- State (EDataLayerRuntimeState) — новое состояние: Unloaded, Loaded или Activated
Выходы (данные):
- нет (void)
Когда используется
При динамическом управлении загрузкой уровней: например, активация Data Layer при входе игрока в зону, выгрузка неиспользуемых слоёв для оптимизации памяти.
Типичные проблемы
- Передача нулевого (null) Data Layer — вызовет краш или предупреждение.
- Неправильный порядок состояний: переход из Unloaded сразу в Activated (минуя Loaded) может быть проигнорирован движком или вызвать ошибку.
- Отсутствие проверки текущего состояния перед изменением — повторная установка того же состояния неэффективна, но безопасна.