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 с. Меняя одно, нужно менять и другое.
Своя катсцена
- Создать вариант префаба (
Prefab Variant). - В состоянии каждой фазы задать спрайт для
current; со второй фазы — дляoldспрайт предыдущей фазы. - Новая фаза — новое состояние: свитчер дублирует последнее, остаётся сменить спрайты.
- На
[AudioControl]добавить клипы музыкальному и звуковому хэндлерам; у звукового выбрать канал громкости. - Длительность перехода меняется в пресете. Нужна своя — сделать копию пресета и назначить её в
ColorLogicхаба.switchDelayхэндлера должен быть не меньше длительности перехода.
Число состояний — «число фаз + 1», порядок совпадает с порядком этапов цепочки.
Граничные случаи
| Ситуация | Поведение |
|---|---|
| У слота звука пустой список клипов | при включении Debug.LogError «Список клипов пуст». Ненужный хэндлер слота удаляется с [AudioControl]: оба стоят на одном объекте, и убрать объект из списков GameObjectsSwitch значит отключить оба |
Для old не задан спрайт прошлой фазы |
на переходе гаснет белый прямоугольник |
| «Дальше» пришло, пока идёт переход | следующая фаза показывается, когда истечёт switchDelay; несколько фаз — по очереди |
Твин перехода длиннее switchDelay |
следующее переключение обрывает переход: скачок яркости кадра |
| Катсцена завершена, пока фаза ждёт задержку | контент выгружается, фаза не показывается |
| Пропорции картинки и экрана не совпадают | картинка вписывается целиком (Preserve Aspect), по краям остаются поля |