TweenerSystem

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

Назначение

Система анимаций на базе UniTask. Два режима: сценарный (TweenerHub + TweenLogic) и standalone (AsyncTween fluent API). Поверх сценарного — StateView<TEnum>: переключатель состояний, где каждое значение enum — свой TweenerHub.

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

• Сценарные анимации: Forward / Back / Pulse с поддержкой offset и switch-точек
• StateView<TEnum> — состояния на твинерах: выбранное — Forward, остальные — Back; в инспекторе — таблица состояний и автосоздание хабов (Sync)
• Горячие клавиши Alt+T / Ctrl+Alt+T — добавить TweenerHub на объект или отдельным слоем
• 5 готовых TweenLogic: цвет, прозрачность CanvasGroup, масштаб, fillAmount, pivot
• Standalone fluent API для одноразовых анимаций из кода
• 16 типов easing + поддержка AnimationCurve
• Шорткаты для типовых операций (Move, Scale, Fade, Color, Slider)

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

• Skeletal/sprite-анимации (Animator, DOTween)
• Анимации физики

Зависимости

---

Архитектура

TweenerSystem/
├── TweenerHub.cs               # Сценарный контроллер (MonoBehaviour)
├── TweenLogic.cs               # Абстрактная база анимации
├── TweenPreset.cs              # ScriptableObject: curve, duration, switch-флаги
├── StateView.cs                # StateView<TEnum> + StateViewBase: TweenerHub на каждое состояние enum
├── TweenLogics/
│   ├── ColorLogic.cs           # Цвет: Image, Text, TMP, SpriteRenderer
│   ├── CanvasOpacityLogic.cs   # Прозрачность CanvasGroup + blocksRaycasts
│   ├── RectScaleLogic.cs       # Масштаб RectTransform (Both/X/Y)
│   ├── FillImageLogic.cs       # fillAmount Image
│   └── PivotLogic.cs           # pivot RectTransform
├── UniTaskTweener/
│   ├── AsyncTween.cs           # Standalone fluent API
│   ├── AsyncTweenExtensions.cs # Шорткаты (Move, Scale, Fade...)
│   └── Easing.cs               # 16 типов easing
├── Editor/
│   ├── StateViewDrawer.cs      # Шапка состояний StateView, кнопка Sync (Odin)
│   └── TweenerHubDrawer.cs     # Кнопки Back / Forward под полем TweenerHub (Odin)
└── Debug/
    ├── Model/SettingsModelExtAsyncTweener.cs
    └── Presets/DebugSettingsExtAsyncTweener.cs

---

Сценарный режим

TweenerHub (MonoBehaviour)

Управляет массивом TweenLogic. Привязывается к GameObject на сцене.

tweenerHub.Forward();       // воспроизведение вперёд
tweenerHub.Back();          // воспроизведение назад
tweenerHub.Pulse();         // переключение направления
tweenerHub.Forward(true);   // мгновенный переход (skip)

Жизненный цикл:

• Awake — инициализация всех TweenLogic (Init())
• OnEnable — возобновление отложенных анимаций
• OnDisable — снятие из очереди TimeController
• OnDestroy — DeInit() всех TweenLogic

В инспекторе под любым полем TweenerHub — кнопки Back и Forward (Editor/TweenerHubDrawer.cs): проверить анимацию, не заходя на сам хаб. Вне Play Mode переключение мгновенное, в Play Mode — с анимацией; пока поле пустое, кнопки недоступны. Кнопки есть и у элементов массива хабов в StateView.

TweenLogic (abstract, Serializable)

Базовый класс анимации. Наследники реализуют SetValue(float value) для интерполяции 0→1.

Абстрактные методы:

Состояние: _isForward, _progress (0..1), _cts (CancellationTokenSource). Поддерживает смену направления во время воспроизведения с пересчётом elapsed time.

TweenPreset (ScriptableObject)

Реализации TweenLogic

StateView<TEnum> (поле-класс)

Переключатель состояний на твинерах: на каждое значение enum — свой TweenerHub. У выбранного состояния хаб в Forward, у остальных — в Back. Альтернатива UIStateSwitcher, когда состояния — это анимации.

public enum GalleryState { Off, NaniCutscene, Image }

[SerializeField] private StateView<GalleryState> playView;

playView.Set(GalleryState.Image);       // Image — Forward, Off и NaniCutscene — Back
playView.Set(GalleryState.Off, true);   // без анимации
var current = playView.State;
playView.Apply();                       // привести хабы к текущему состоянию

Устройство:

• [Serializable]-класс — поле любого MonoBehaviour; сериализуются state (текущее состояние) и hubs (хабы).
• Хабы идут по порядку значений enum (Enum.GetValues), а не по их числам: enum с пропусками (A = 0, B = 5) работает.
• Общая часть — неgeneric-основа StateViewBase: один drawer обслуживает поле с любым enum.
• Жизненного цикла у поля нет. При включении хабы сами возвращаются в последнее положение (изначально Back); чтобы привести их к сохранённому state, владелец вызывает Apply().
• Пустой элемент массива пропускается.

Инспектор (StateViewDrawer, Odin):

• над полем — таблица состояний, как у [StateSwitcher]: номер, подпись (из Tooltip / LabelText значения enum, иначе имя), назначенный хаб или [None]; активное состояние подсвечено;
• клик по строке — переключение с Undo; вне Play Mode хабы переключаются мгновенно;
• Sync — подгоняет длину массива под число состояний и каждому пустому состоянию создаёт дочерний слой владельца [{поле}_{состояние}_Tween] с TweenerHub, как Ctrl+Alt+T. Слои выстраиваются в порядке enum, всё отменяется одним шагом Undo. Ассет префаба в Project не синхронизируется — префаб нужно открыть.

Горячие клавиши

Для выделенных объектов сцены или открытого префаба (UI/UIBuilder/Shortcuts/TweenerHubShortcut.cs):

Отмена — одним шагом Undo. Пункты меню живут в пакете UIBuilder вместе с остальными горячими клавишами вёрстки; добавление компонента и создание слоя — общий код EditorTools/HierarchyTools/HierarchyLayers.cs, им же пользуется Sync у StateView.

---

Standalone режим (AsyncTween)

Namespace: Vortex.Unity.UI.TweenerSystem.UniTaskTweener

Fluent API для одноразовых анимаций без привязки к сцене:

new AsyncTween()
    .Set(() => transform.localScale, v => transform.localScale = v, Vector3.one, 0.3f)
    .SetEase(EaseType.OutBack)
    .OnComplete(() => Debug.Log("Done"))
    .OnUpdate(progress => { })
    .Run();

Свойства: Progress (float 0..1), IsPlaying (bool), IsPaused (bool).

Пауза твинера ничего не знает о паузе игры: её ставит владелец твина (например, хэндлер паузы игры уровня Sdk).

Шорткаты (AsyncTweenExtensions)

new AsyncTween().SetLocalMove(transform, targetPos, 0.5f).Run();
new AsyncTween().SetMove(transform, worldPos, 0.5f).Run();
new AsyncTween().SetScale(transform, Vector3.zero, 0.2f).SetEase(EaseType.InBack).Run();
new AsyncTween().SetFade(canvasGroup, 0f, 0.3f).Run();
new AsyncTween().SetColor(graphic, Color.red, 0.4f).Run();
new AsyncTween().SetSlider(slider, 0.75f, 0.5f).Run();
new AsyncTween().SetSize(rectTransform, newSize, 0.3f).Run();
new AsyncTween().SetAnchoredMove(rectTransform, anchoredPos, 0.4f).Run();
new AsyncTween().SetPivot(rectTransform, newPivot, 0.3f).Run();

Easing

16 типов: Linear, InQuad, OutQuad, InOutQuad, InCubic, OutCubic, InOutCubic, InBack, OutBack, InOutBack, InElastic, OutElastic, InOutElastic, InBounce, OutBounce, InOutBounce.

---

Debug

Settings.Data().AsyncTweenerDebugMode — включается в ассете DebugSettings (toggle asyncTweenerLogs).

---

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