Кальтер / Блог

Remotion и React для серии видео: данные, рендер и проверка выпусков

Схема данных, композиции, манифест рендера, QA крайних случаев и проверка лицензий для серии видео на Remotion.

Материал подготовлен с помощью ИИ; источники и технические формулировки проверены редакцией ZASLON.

Одна система. Разные выпуски.: DATA, COMPOSITION, OUTPUT.
Оригинальная редакционная схема ZASLON, созданная программно. Условная структура процесса, не скриншот продукта.

Короткий ответ: для серии однотипных видео раздели проверяемые входные данные, 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 из пакета вручную.