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.
Своя катсцена:
- Создать вариант префаба (
Prefab Variant). - Назначить
SkeletonDataAssetвSkeletonAnimation. - В состояниях фаз выбрать анимации вместо заглушки
[NONE]; новая фаза — новое состояние. - На
[AudioControl]заполнить таблицу звуков событий и клипы музыкального и звукового хэндлеров.
Ограничения основы:
- Пока скелет не назначен, свитчер в редакторе пишет ошибку проверки состояний.
- Слот звука с пустым списком клипов при включении пишет
Debug.LogError«Список клипов пуст». Ненужный хэндлер слота удаляется с[AudioControl]: все три компонента стоят на одном объекте, и убрать объект из списковGameObjectsSwitchзначит отключить их все. - Для катсцены под канвасом нужен
SkeletonGraphic: компонент скелета и ссылки на него в хэндлерах и состояниях меняются вручную.
Основа спрайтовой катсцены лежит в Sdk/CutsceneSystem.
Граничные случаи
| Ситуация | Поведение |
|---|---|
| Не задан ни один скелет | NullReferenceException при включении |
| У скелета нет данных | NullReferenceException при включении |
| Анимация трека сменилась до конца прохода | ждётся конец новой анимации |
| Событие встречается в таблице дважды | играет первая строка; если звук в ней пуст, не играет ничего |