Set Data Layer Runtime State
DataLayerSubsystemЧто это
Функция изменяет состояние выполнения (runtime state) указанного Data Layer. Позволяет программно активировать, загружать или выгружать слои данных. Exec-функция.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- DataLayerName (String) — имя целевого Data Layer
- NewState (DataLayerRuntimeState) — новое состояние (Unloaded, Loaded, Active)
Выходы (данные):
- Return Value (Boolean) — true, если состояние успешно изменено; false, если слой не найден или изменение недопустимо
Когда используется
Для управления загрузкой и активацией Data Layers в рантайме, например, при переключении между зонами уровня или стриминге контента.
Типичные проблемы
- Опечатка в имени слоя — функция вернёт false, состояние не изменится.
- Попытка установить состояние, несовместимое с текущим (например, Active без Loaded) — поведение зависит от реализации, но возвращаемое значение может быть false.
- Игнорирование возвращаемого значения — можно пропустить ошибку, если слой не существует.