Сцена

Сцена — це окремий часовий фрагмент фільму зі своїми властивостями та власним набором елементів. Якщо фільм — це весь ролик цілком, то сцена — це одна його частина, яка триває певний час і містить конкретний візуальний та звуковий вміст.

На рівні сцени описують не глобальні налаштування всього відео, а те, що відбувається всередині конкретного фрагмента: скільки він триває, який має фон, які в ньому елементи, за яких умов він показується та як переходить у наступну сцену. Для глобальних параметрів дивіться сторінку Фільм, а для правильної постановки задач — гайд із формулювання запитів.

Властивості сцени

Нижче наведено основні властивості сцени. Саме їх потрібно називати у запиті до ШІ, якщо ви змінюєте не весь фільм, а конкретну сцену. Найважливіша властивість — duration, тому що вона визначає довжину сцени у часі.

Властивість	Опис	Як правильно запитувати у ШІ
`duration`	Тривалість сцени. Це головна властивість сцени, тому що саме вона задає, скільки часу сцена існує у фільмі. Від неї залежить ритм ролика та розташування наступних сцен.	«У сцені 2 збільш `duration` до 6 секунд» або «У першій сцені зменш `duration` на 2 секунди».
`background-color`	Колір фону сцени. Використовується, коли сцена повинна мати суцільний фон без окремого фонового зображення чи відео.	«У сцені 1 встанови `background-color` = `#000000`» або «Зроби фон другої сцени білим».
`transition`	Ефект переходу до наступної сцени. Він визначає, як одна сцена змінює іншу: плавно, різко, зі зсувом, розчиненням тощо. Перелік переходів дивіться на сторінці Переходи сцен.	«У сцені 3 встанови `transition` = `fade`» або «Для другої сцени зміни перехід на slide left».
`elements`	Список усіх елементів усередині сцени: текст, зображення, відео, звук, HTML, компоненти та інші локальні об'єкти.	«У сцені 2 в `elements` додай новий `text`» або «Видали зайве `image` зі списку `elements` у третій сцені».
`condition`	Умова показу сцени. Дає змогу вказати, коли сцена повинна відображатися, а коли ні.	«Для сцени 4 додай `condition` для показу лише в акційній версії ролика».
`variables`	Локальні змінні сцени. Використовуються, коли саме в цій сцені потрібні окремі значення, що відрізняються від глобальних змінних фільму.	«У сцені 1 додай у `variables` локальний заголовок і ціну» або «Онови `variables` другої сцени».
`iterate`	Керує повторенням або ітерацією сцени за набором даних. Корисно для шаблонів, де одна сцена генерується кілька разів із різними значеннями.	«У сцені 5 налаштуй `iterate` для списку товарів» або «Додай ітерацію сцени за масивом карток».
`cache`	Кешування конкретної сцени. Дає змогу перевикористати вже згенерований результат або примусово перерахувати сцену.	«Для сцени 2 вимкни `cache` і згенеруй її заново» або «Увімкни `cache` для повторюваної сцени».
`comment`	Службовий коментар до сцени. Не показується у кадрі, а використовується для пояснень, приміток чи технічних позначок.	«У сцені 3 додай `comment` з поясненням для редактора».
`id`	Унікальний ідентифікатор сцени. Допомагає точно посилатися на сцену в шаблонах, інтеграціях або при технічному супроводі.	«Признач сцені `id` = `intro-offer`» або «Онови `id` третьої сцени».

Головне: якщо ви змінюєте duration, transition, background-color або elements, у запиті треба прямо сказати, що це зміна сцени, а не фільму загалом.

Елементи сцени

Усередині сцени знаходяться її локальні елементи. Вони живуть тільки в межах часу цієї сцени й не є глобальними для всього ролика.

Елемент	Короткий опис
`video`	Відеофрагмент, який показується тільки в цій сцені.
`image`	Зображення або графіка, що належить лише цій сцені.
`text`	Текстовий елемент: заголовок, підпис, коротке повідомлення, CTA.
`component`	Готовий складений блок, який використовується всередині сцени.
`html`	HTML-розмітка або кастомний вміст, потрібний лише в межах сцени.
`audio`	Локальний звук або музика, що звучить тільки в цій сцені.
`voice`	Озвучення, яке стосується саме цієї сцени.
`audiogram`	Візуалізація аудіо для конкретної сцени.

Якщо той самий елемент має бути видимим упродовж усього ролика, тоді це вже об'єкт рівня фільму, а не сцени.

Як правильно запитувати зміни сцени

Для запиту змін сцени найкраще працює формула: номер або ID сцени → властивість чи елемент → конкретна дія.

Спочатку вкажіть, яку саме сцену ви змінюєте.
Потім назвіть її властивість або конкретний елемент.
Після цього чітко опишіть, що саме треба зробити.

Нечітко	Правильно
«Зроби довше»	«У сцені 2 збільш `duration` до 6 секунд»
«Поміняй фон»	«У сцені 1 встанови `background-color` = `#FFFFFF`»
«Зроби інший перехід»	«Для сцени 3 зміни `transition` на `fade`»
«Додай текст»	«У сцені 2 в `elements` додай новий елемент `text` із заголовком “Весняна акція”»
«Прибери картинку»	«У сцені 4 видали елемент `image` зі списку `elements`»
«Перероби сцену»	«У сцені 5 онови `variables`, зміни `duration` на 4 секунди й встанови `transition` = `fade`»

Якщо ви змінюєте не всю сцену, а лише один її елемент, формулюйте ще точніше: «У сцені 2 елемент text заміни на новий заголовок» або «У сцені 3 елемент audio зроби тихішим на 30%».

Пов'язані сторінки: Фільм, Переходи сцен, Гайд із постановки задач.