Is Effective Visible
DataLayerInstanceЧто это
Pure-функция, возвращающая true, если экземпляр слоя данных (Data Layer) эффективно видим в текущем состоянии runtime. «Эффективная видимость» учитывает не только собственный флаг видимости слоя, но и состояния родительских слоёв в иерархии. Используется для проверки, должен ли контент, привязанный к слою, быть загружен/активен.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (DataLayerInstance) — экземпляр слоя данных, для которого выполняется проверка.
Выходы (данные):
- Return Value (Boolean) — истина, если слой эффективно видим, ложь — в противном случае.
Когда используется
- Принятие решений о загрузке/выгрузке ассетов, привязанных к Data Layer.
- Проверка в runtime, активен ли слой с учётом всей иерархии (например, после переключения родительского слоя).
- Условные ветвления в логике управления уровнями или потоковой загрузкой.
Типичные проблемы
- Путаница с IsVisible:
IsEffectiveVisibleотличается от простогоIsVisibleтем, что учитывает состояния родительских слоёв. Использование не той функции может привести к неверной логике активации контента. - Вызов до полной инициализации слоя: если слой ещё не завершил инициализацию (например, на
BeginPlayсразу после загрузки), результат может быть неопределённым или всегдаfalse. - Непонимание цепочки видимости: слой может быть
trueпо собственному состоянию, ноfalseпоEffectiveVisible, если один из родителей скрыт. Разработчики часто ожидают, что видимость слоя настраивается изолированно.