Короткий ответ: для серии однотипных видео раздели проверяемые входные данные, React-композицию, манифест отдельных выпусков, рендер и контроль результата. В Remotion useCurrentFrame() даёт номер текущего кадра композиции, а Composition описывает конкретное видео; параметры можно преобразовать в props, но каждый выпуск всё равно требует собственных проверок текста, медиа и прав. Шаблон не заменяет фактчек, редакционную приёмку или лицензионную проверку.
Строй серию, когда у роликов есть действительно общая визуальная структура и меняются ограниченные поля: например, заголовок, дата, язык, изображение и короткая подпись. Если структура каждого выпуска разная, единый шаблон может скрыть различия и создать дополнительную работу. Эта статья — схема архитектуры, не отчёт о тестовом рендере.
Раздели неизменное и переменное
Сначала составь таблицу полей и установи для каждого правило проверки: обязательность, тип, единицы, допустимая длина, источник и видимый fallback. Ниже — условные демонстрационные данные, они не относятся к продуктам ZASLON.
type Episode = {
id: string; // уникальный идентификатор вывода
title: string; // обязательный заголовок
publishedAt: string; // дата ISO, валидируется до рендера
language: "ru" | "en";
metric?: { value: number; unit: string; asOf: string };
image?: { path: string; alt: string; rightsRef: string };
};
Пример выше задаёт TypeScript-форму, но сам по себе не проверяет JSON во время выполнения. До передачи props в Remotion проверь данные runtime-схемой (например, Zod или собственным валидатором), и отдельно проверь уникальность id: тип string этого не гарантирует. Дата должна распознаваться, metric.value быть конечным числом, а у изображения должна быть ссылка на запись прав, если оно задано. Реши, что делать с пустым заголовком, отсутствующей метрикой, длинной строкой и неизвестным языком: отклонить запись, показать предусмотренную пустую версию или отправить редактору. Не превращай null в строку undefined и не заполняй пробелы придуманным значением.
В Composition размести компоненты и передай им только прошедшие проверку props. Внутри сцены производные значения времени вычисляй от кадра, а не от таймера: так один input может описывать состояние на любой позиции. Remotion core idea показывает рендер React по кадру; документация отдельно предупреждает о мерцании, когда кадры зависят от несогласованных независимых состояний (flickering). Параметризованные composition и расчёт метаданных/размера проверь в актуальных разделах Parameterized videos и calculateMetadata; API может измениться относительно зафиксированной версии skills package 4.0.541.
Манифест помогает понять, что именно ушло в рендер
Храни не только массив входных строк, но и manifest, который связывает каждый результат с данными и версиями сцены. Это авторская схема учёта, а не встроенная гарантия Remotion.
| Поле манифеста | Пример назначения | Почему оно нужно |
|---|---|---|
outputId |
demo-ru-2026-11-a |
Понятное уникальное имя файла и записи |
inputHash |
SHA входного JSON | Отличить исправленные данные от прошлой версии |
compositionVersion |
commit/tag исходников | Понять, какая разметка и анимация были использованы |
assetRefs |
пути и идентификаторы шрифта/изображения/аудио | Сверить, что подставлены разрешённые версии |
status |
queued / rendering / reviewed / failed | Не перезапускать выпуск вслепую и видеть ручную приёмку |
outputFile |
путь к MP4 и его технические метаданные | Проверить фактический экспорт после рендера |
Перед повторным запуском выясни, не существует ли уже валидный выходной файл для тех же inputHash и compositionVersion. Для больших наборов Remotion поддерживает render данных/композиций, а CLI и renderer предоставляют разные пути запуска (render dataset, render video). Настрой retries и параллельность под свою среду и стоимость: сама таблица статусов не предотвращает дубликаты, если задания выдаются без идемпотентного ключа.
Проверь крайние записи и каждый MP4
Небольшой набор QA лучше выбирать по рискам, а не случайным первым трём строкам. Включи самую длинную строку, пустое необязательное поле, редкий Unicode/RTL, границы даты и валюты, локализацию, отсутствующее изображение, аудио иной длины и самый плотный экран с субтитрами. Это не статистическая гарантия качества: после проверки представительных вариантов всё равно просмотри каждый выпуск по тексту/фактам и открой фактический экспорт.
| Риск | Проверка до render | Проверка после render |
|---|---|---|
| Переполнение заголовка | Максимальная длина + fallback | Стоп-кадр на старте, переносы и safe area |
| Ошибка даты/единицы | Парсер, timezone и источник значения | Воспроизвести отображённую дату/единицу против исходной строки |
| Отсутствующий asset | Валидация пути и предусмотренная заглушка | Открыть кадры, где asset должен появиться |
| Unicode, RTL, субтитры | Нужные глифы/шрифт и direction | Проверить титры в целевом языке на реальном видео |
| Тишина/длинный звук | Длительность и лицензия аудио | Проверить дорожку, стыки и синхронизацию |
| Ошибочное повторение | Уникальные ID и input hash | Сопоставить число файлов с manifest и пройти каждый статус |
Не используй результат render как автоматическое доказательство, что текст достоверен: он подтверждает только то, что композиция отобразила поданные значения. Источник каждого фактического утверждения и метрика/период должны оставаться в исходной записи серии.
Раздельно учитывай программную лицензию и медиа
В зафиксированном снимке remotion-dev/skills в записи GitHub нет license metadata; это не даёт права копировать его тексты или код. Лицензия skills package, лицензия программного обеспечения Remotion и права на содержимое готового видео — разные вопросы.
На 5 ноября 2026 года страница Remotion Terms v5 помечена Upcoming document: она говорит, что вступит в силу с выходом Remotion 5.0, и указывает на условия v4.0. Поэтому не применяй v5 задним числом к проекту на v4. И сама страница v4 помечена как заменяемая будущими условиями (Terms v4, License FAQ). Не делай вывод «MIT» или «бесплатно для всех» по открытой видимости исходников, skills-репозиторию или одному примеру. Перед производственным запуском сверь конкретную версию, действующие для неё условия, статус организации/команды и характер использования. Это не юридическое заключение; при коммерческой неопределённости получи подтверждение правообладателя или юриста.
Отдельно веди реестр прав на видео: код шаблона, шрифт, музыка, SFX, изображение, footage, голос, логотип, иконки и codec/способ дистрибуции. В NOTICE репозитория product-launch-motion примерные фильмы и сторонние материалы отдельно исключены из лицензии навыков; это конкретное уведомление, не универсальное правило для всех репозиториев. Для общей схемы рамок/кадров смотри статью HTML + Playwright + FFmpeg или Remotion; здесь речь о данных, выпусках и проверке серии, не о выборе renderer. Для технической глубины изучения React и проектов смотри MK Ultra.
Как передать эту статью своему ИИ
В ZASLON Motion Kit есть навык zaslon-remotion-series. Отправь ИИ URL этой статьи вместе с заданием:
Прочитай статью и https://github.com/mrakBH/zaslon-motion-kit/blob/main/INSTALL.md
Спроектируй серию видео из моих данных: валидацию входов, композиции, манифест и проверку крайних случаев. Не рендери всю серию до проверки превью.
Используй навык zaslon-remotion-series и мой бренд.
Если нужна установка, сначала объясни действия и получи моё согласие.
Мой проект и материалы: ...
Открыть навык на GitHub · Русская документация · English README. Ссылка передаёт инструкции, но сама не устанавливает файлы и не предоставляет доступ к проекту. Если у ИИ нет веба, передай SKILL.md из пакета вручную.
