StateSwitcher

Namespace: Vortex.Unity.UI.StateSwitcher Сборка: ru.vortex.unity.ui.misc

Назначение

Машина состояний для визуальных и поведенческих переключений. UIStateSwitcher управляет массивом именованных состояний, каждое из которых содержит набор StateItem.

Возможности:

• Переключение по индексу, имени или enum
• 7 готовых StateItem: GameObjects, Animator (bool/int), Colors (с анимацией), Sprites, Events, TweenerHub
• StateSwitcherAttribute для привязки к enum с визуализацией в Inspector
• Событие OnStateSwitch при смене состояния
• Защита от реентрантности

Вне ответственности:

• Анимации переходов между состояниями (используйте TweenerHubSwitch или ColorsSwitch)
• Логика выбора состояния (уровень 3/4)

Зависимости

---

Архитектура

StateSwitcher/
├── UIStateSwitcher.cs          # Машина состояний (MonoBehaviour)
├── StateItem.cs                # Абстрактная база поведения
├── Items/
│   ├── GameObjectsSwitch.cs    # SetActive на массив GameObject
│   ├── AnimatorBoolSwitch.cs   # SetBool на Animator
│   ├── AnimatorStateSwitch.cs  # SetInteger на Animator
│   ├── ColorsSwitch.cs         # Цвет (мгновенный или анимированный)
│   ├── SpritesSwitch.cs        # Спрайт на SpriteRenderer/Image
│   ├── EventFire.cs            # UnityEvent при активации
│   └── TweenerHubSwitch.cs     # Forward/Back на TweenerHub
└── Handlers/
    └── OnEnableStateRunner.cs  # Переключение при OnEnable

UIStateSwitcher

MonoBehaviour с массивом StateData. Каждый StateData — именованное состояние с массивом StateItem[].

При переключении:

1. Вызывает DefaultState() на всех item'ах предыдущего состояния (узкое место!)
2. Вызывает Set() на всех item'ах нового состояния
3. Запускает событие OnStateSwitch

---

API

switcher.Set(0);                        // по индексу
switcher.Set("Active");                 // по имени
switcher.Set(MyEnum.Active);            // по enum
switcher.Set((byte)2);                  // по byte
switcher.Set(myExtensibleEnum);         // по ExtensibleEnum (через Order, null → no-op)
switcher.ResetStates();                 // сброс всех item'ов + начальное состояние

int current = switcher.State;           // текущее состояние (-1 = нет)
StateData[] all = switcher.States;      // массив всех состояний
switcher.OnStateSwitch += OnSwitch;     // событие (StateData или null)
int index = switcher.GetState("name");  // индекс по имени (-1 = не найден)

---

StateItem

Абстрактный класс поведения. При активации состояния — Set(), при деактивации — DefaultState().

ColorsSwitch

Поддерживает SpriteRenderer, Graphic (Image, Text), Outline. Режимы:

• Мгновенная смена цвета
• Анимированная через AsyncTween с настраиваемой длительностью и кривой
• Опциональный стартовый цвет: _useOwnStartColor = true — берёт текущий цвет с объекта, false — использует поле _startColor

Inspector-кнопка Get from... — захватывает текущий цвет с первого объекта.

---

StateSwitcherAttribute

Атрибут для привязки UIStateSwitcher к enum. Используется вместе с StateSwitcherDrawer.

[SerializeField, StateSwitcher(typeof(MyStatesEnum))]
private UIStateSwitcher switcher;

В Inspector отображает таблицу состояний:

• Индекс, описание (из [Tooltip] / [LabelText]), имя из switcher
• Подсветка активного состояния
• Клик для переключения
• Кнопка Sync — синхронизирует имена состояний с описаниями enum

---

OnEnableStateRunner

MonoBehaviour — переключает UIStateSwitcher в заданное состояние при OnEnable.

---

Граничные случаи