CutsceneSystem — примеры контента

⚠️ Экспериментальный пакет — спутник CutsceneSystem, который не прошёл обкатку в продуктовой эксплуатации. Структура примера префаба может измениться вместе с ним без обратной совместимости.

Сборка: нет — в папке только ассеты


Назначение

Готовая основа префаба контента для CutsceneSystem: катсцена на смене спрайтов с плавным переходом и слотами звука.

Пример лежит в SDK, а не в пакете катсцен: звук в нём — хэндлеры AudioAdvancedControl, а пакет катсцен слоем ниже про них не знает.

Основа Spine-катсцены лежит в SpineExtensions/Cutscenes.


Состав

Example/
  baseSpriteCutscene.prefab   — основа спрайтовой катсцены
  CutsceneCrossFade.asset     — пресет твина перехода: линейная кривая, 0,4 с

baseSpriteCutscene

UI-префаб: корень — RectTransform, растянутый на родителя. target оркестратора должен быть под канвасом.

baseSpriteCutscene   DataStorage, CutsceneSpriteContentHandler, UIStateSwitcher, TweenerHub
├── Layers           выключен; включается состояниями фаз
│   ├── current      Image — картинка текущей фазы
│   └── old          Image поверх current — картинка прошлой фазы, гаснет на переходе
└── [AudioControl]   AdvancedMusicHandler, AdvancedSoundHandler; выключен

Состояния свитчера

Состояние Элементы
Empty пусто — катсцена ещё не показана
Phase 1 GameObjectsSwitch (Layers, [AudioControl]); SpritesSwitch → current
Phase 2, Phase 3 то же; SpritesSwitch → old (спрайт прошлой фазы); EventFire: TweenerHub.Forward(true), затем TweenerHub.Back(false)

Переход old → current

  • В покое old прозрачен и выключен.
  • На входе в фазу current получает спрайт фазы, old — спрайт прошлой.
  • Forward(true) мгновенно делает old непрозрачным: на экране остаётся прошлая картинка.
  • Back(false) плавно гасит old и в конце выключает его (в пресете стоит offOnStartPoint). Под ним открывается current.
  • Первая фаза появляется без перехода: гасить нечего.

Твин перезапускается через EventFire, а не TweenerHubSwitch: повторный Forward на уже отыгравшем хабе ничего не запускает. Перезапуск — это скачок в конец и обратный ход.

GameObjectsSwitch фаз стоит с отложенным выключением: между фазами объекты не выключаются, звук не перезапускается.

Задержка между переключениями

На корне стоит CutsceneSpriteContentHandler, а не базовый хэндлер контента: следующее состояние он выставляет не раньше, чем через switchDelay (0,5 с) после предыдущего. Без задержки «дальше» посреди перехода оборвало бы твин, и кадр дал бы скачок яркости.

Хэндлер про твины не знает. Переход должен уложиться в задержку: в примере твин 0,4 с при задержке 0,5 с. Меняя одно, нужно менять и другое.

Своя катсцена

  1. Создать вариант префаба (Prefab Variant).
  2. В состоянии каждой фазы задать спрайт для current; со второй фазы — для old спрайт предыдущей фазы.
  3. Новая фаза — новое состояние: свитчер дублирует последнее, остаётся сменить спрайты.
  4. На [AudioControl] добавить клипы музыкальному и звуковому хэндлерам; у звукового выбрать канал громкости.
  5. Длительность перехода меняется в пресете. Нужна своя — сделать копию пресета и назначить её в ColorLogic хаба. switchDelay хэндлера должен быть не меньше длительности перехода.

Число состояний — «число фаз + 1», порядок совпадает с порядком этапов цепочки.


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

Ситуация Поведение
У слота звука пустой список клипов при включении Debug.LogError «Список клипов пуст». Ненужный хэндлер слота удаляется с [AudioControl]: оба стоят на одном объекте, и убрать объект из списков GameObjectsSwitch значит отключить оба
Для old не задан спрайт прошлой фазы на переходе гаснет белый прямоугольник
«Дальше» пришло, пока идёт переход следующая фаза показывается, когда истечёт switchDelay; несколько фаз — по очереди
Твин перехода длиннее switchDelay следующее переключение обрывает переход: скачок яркости кадра
Катсцена завершена, пока фаза ждёт задержку контент выгружается, фаза не показывается
Пропорции картинки и экрана не совпадают картинка вписывается целиком (Preserve Aspect), по краям остаются поля