SpineExtensions — Cutscenes

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

Namespace: Vortex.SpineExtensions.Cutscenes Сборка: ru.vortex.spine.cutscene (defineConstraints: USING_SPINE)


Назначение

Всё, что относится к Spine-реализации катсцен для CutsceneSystem. Сам пакет катсцен про Spine не знает; здесь лежат хэндлеры, которые ставятся в префаб контента.

  • SpineCutsceneAutoNext — автопереход фазы по концу анимации.
  • SpineCutsceneEventSounds — звуки на события анимации.

Оба хэндлера принимают SkeletonGraphic либо SkeletonAnimation: задаётся одно поле из двух. Если заданы оба, берётся SkeletonGraphic.

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

  • Запуск анимации фазы — это SpineAnimationSwitch в состоянии свитчера контента.
  • Заморозка скелета на паузе — SpinePauseHandler.

У подпакета своя сборка, а не общая ru.vortex.spine: ему нужны ссылки на пакет катсцен, звук и базу, которые остальным Spine-расширениям не требуются.


Зависимости

Зависимость Назначение
spine-unity, spine-csharp скелет, AnimationState, события
Vortex.Unity.CutsceneSystem CutsceneContentHandler.Next — сигнал автоперехода
Vortex.Unity.UI.Misc базовый тип хэндлера контента
Vortex.Core.AudioSystem, Vortex.Unity.AudioSystem AudioController.PlaySound, тип записи Sound
Vortex.Core.DatabaseSystem, Vortex.Unity.DatabaseSystem [DbRecord] — выбор записи звука

SpineCutsceneAutoNext

Когда текущая анимация трека отыграла проход, шине уходит сигнал «дальше». Сигнал идёт через хэндлер контента (CutsceneContentHandler.Next()): тот называет шине показанную фазу, и сигнал от фазы, с которой цепочка уже ушла, отбрасывается.

Поле Назначение
content хэндлер контента катсцены, через него уходит сигнал
skeletonGraphic / skeletonAnimation скелет катсцены
track трек, конец анимации которого ждём
  • Работает, пока включён, и срабатывает один раз за включение.
  • Ставится на объект, который включает состояние фазы с автопереходом (GameObjectsSwitch). В фазах, ждущих команды, его быть не должно.
  • Учитывается только текущая анимация трека: уходящая в миксе анимация сигнал не даёт.
  • На паузе скелет заморожен, поэтому сигнала нет.

SpineCutsceneEventSounds

На событие скелета играет запись звука из базы.

Поле Назначение
skeletonGraphic / skeletonAnimation скелет катсцены
sounds таблица: имя события → запись Sound
  • Имя события выбирается из списка событий скелета.
  • Звуки событий лёгкие и повторяются между катсценами, поэтому берутся из общей базы и вместе с контентом не выгружаются.
  • Событие без строки в таблице или с пустым звуком пропускается.
  • Уже звучащий звук события на паузе доигрывает; новых на паузе не появляется.

Пример

Example/baseSpineCutscene.prefab — основа префаба контента Spine-катсцены. Мировой объект: корень — Transform, скелет — SkeletonAnimation.

baseSpineCutscene       DataStorage, CutsceneContentHandler, UIStateSwitcher
├── spine               SkeletonAnimation, SpinePauseHandler; выключен
├── [AutoNextControl]   SpineCutsceneAutoNext; выключен
└── [AudioControl]      AdvancedMusicHandler, AdvancedSoundHandler, SpineCutsceneEventSounds; выключен
Состояние Элементы
Empty пусто — катсцена ещё не показана
Phase 1 (auto next) GameObjectsSwitch (spine, [AudioControl]); SpineAnimationSwitch без loop; GameObjectsSwitch ([AutoNextControl]) — фаза уходит дальше сама по концу анимации
Phase 2 (loop) GameObjectsSwitch (spine, [AudioControl]); SpineAnimationSwitch с loop — фаза ждёт команды «дальше»
  • Порядок элементов состояния важен: сначала включение spine, потом SpineAnimationSwitch. Скелет создаёт AnimationState при включении объекта.
  • [AutoNextControl] выключается без задержки, остальные объекты — с отложенным выключением. Поэтому автопереход взводится заново в каждой фазе, а скелет и звук между фазами не перезапускаются.
  • Слоты звука — хэндлеры AudioAdvancedControl из SDK.

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

  1. Создать вариант префаба (Prefab Variant).
  2. Назначить SkeletonDataAsset в SkeletonAnimation.
  3. В состояниях фаз выбрать анимации вместо заглушки [NONE]; новая фаза — новое состояние.
  4. На [AudioControl] заполнить таблицу звуков событий и клипы музыкального и звукового хэндлеров.

Ограничения основы:

  • Пока скелет не назначен, свитчер в редакторе пишет ошибку проверки состояний.
  • Слот звука с пустым списком клипов при включении пишет Debug.LogError «Список клипов пуст». Ненужный хэндлер слота удаляется с [AudioControl]: все три компонента стоят на одном объекте, и убрать объект из списков GameObjectsSwitch значит отключить их все.
  • Для катсцены под канвасом нужен SkeletonGraphic: компонент скелета и ссылки на него в хэндлерах и состояниях меняются вручную.

Основа спрайтовой катсцены лежит в Sdk/CutsceneSystem.


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

Ситуация Поведение
Не задан ни один скелет NullReferenceException при включении
У скелета нет данных NullReferenceException при включении
Анимация трека сменилась до конца прохода ждётся конец новой анимации
Событие встречается в таблице дважды играет первая строка; если звук в ней пуст, не играет ничего