Медиа.маги Документация
On this page

Last updated

mp4

Мультиплексор mp4 объединяет закодированные дорожки аудио и видео перед загрузкой.

1. Сводка

Упаковывает потоки в файл MP4 (ISO‑BMFF). Объединяет одну или несколько закодированных видеодорожек и одну или несколько закодированных аудиодорожек в единую поставку .mp4, готовую к записи шагом загрузки.

2. Когда использовать

  • Готовите финальную поставку для однобитрейтного актива VOD.
  • Оборачиваете выход видеокодера и аудиокодера в файл, который ваш клиент или платформа могут потреблять.
  • Готовите MP4 по рендериям для лестницы ABR, когда выбранная модель доставки использует отдельные файлы, а не упакованный поток.

3. Входы

  • Video — []core.VideoTrack. Одна или несколько закодированных видеодорожек для мультиплексирования. Обязателен.

    Совместимые узлы выше по потоку:

    • avcintra — кодирует видео в профилях AVC-Intra.
    • ccinject — вставляет скрытые субтитры/субтитры в выход.
    • copy — пропускает исходный видеопоток в мультиплексор без перекодирования.
    • ni264 — использует аппаратно-ускоренное кодирование H.264 на NetInt.
    • qsv264 — кодирует H.264 через Intel Quick Sync Video.
    • x264 — программно кодирует видео H.264/AVC.
    • x265 — программно кодирует видео H.265/HEVC.

  • Audio — []core.AudioTrack. Одна или несколько закодированных аудиодорожек для мультиплексирования. Обязателен.

    Совместимые узлы выше по потоку:

    • aac — кодирует аудиодорожки кодеком AAC.
    • ac3 — кодирует аудиодорожки как Dolby Digital (AC-3).
    • copy — пропускает исходный аудиопоток в мультиплексор без перекодирования.
    • eac3 — кодирует аудио через Dolby Digital Plus (E-AC-3).
    • pcm — записывает несжатое аудио PCM.

4. Выходы

  • Package — core.Package. Упакованный файл MP4, готовый к шагу загрузки или к упаковщику ниже по потоку.

    Совместимые узлы ниже по потоку:

    • analyze — зондирует источник для извлечения метаданных медиа.
    • concat — склеивает несколько клипов в один выход.
    • map/audio — выбирает, какие аудиопотоки идут на выход.
    • map/text — выбирает потоки субтитров для выхода.
    • map/timecode — сохраняет или задаёт начальный таймкод программы.
    • map/video — выбирает видеопоток для выхода.
    • upload — записывает пакет на целевой URL.

5. Параметры

Форма «Настройки» узла mp4.

Форма «Настройки» — один столбец с одним полем помимо общей подписи.

  • Node Label (string, по умолчанию пусто)

    Произвольное имя, отображаемое на плитке узла на холсте.

    • Что задаёт. Подпись над плиткой; на мультиплексированный файл не влияет.
    • Когда менять. Задавайте, когда в одном графе несколько узлов mp4 — обычно ступени лестницы ABR, где каждый рендерий пишется в свой файл, — чтобы каждый выход был узнаваем с одного взгляда.

  • Filename (string, оканчивающийся на .mp4, без значения по умолчанию)

    Имя выходного файла MP4.

    • Что задаёт. Имя, записываемое в итоговый пакет. Значение составляется с целью загрузки (URL на узле upload ниже по потоку) в итоговый путь объекта.
    • Когда менять. Задавайте фиксированное имя, когда цель ожидает детерминированный ключ объекта. Оставляйте пустым, чтобы шаг загрузки назвал файл по своему шаблону URL, или ссылайтесь на переменную процесса (например, суффикс по рендерию), когда в одном процессе создаётся несколько MP4.

Соответствие JSON-ключей и названий полей

JSON-ключ Название поля
name Filename

6. Пример

H.264 HD на холсте

Полный разбор — переменные, настройка каждого узла и ожидаемый результат — смотрите в H.264 HD.

7. Где используется

  • 5.1 surround AC-3 MP4 — оборачивает исходное (скопированное) видео вместе с дорожкой AC-3 5.1, собранной из шести монодорожек, в один MP4.
  • Three-tier MP4 ladder (LQ / MQ / HQ) — три параллельных мультиплекса MP4, чьи имена выходных файлов задаются переменными процесса ($LQ_Filename, $MQ_Filename, $HQ_Filename).
  • Cropped H.264 MP4 from interlaced source — оборачивает две пары H.264 + AAC параллельно: обрезанную, деинтерлейснутую поставку и опорное перекодирование «как есть» с идентичными настройками кодера.
  • Content-aware preview proxy ladder — оборачивает видео x264 по классам и общее аудио AAC в один MP4 на каждый совпавший класс источника (четыре ветви).
  • MP4 with branded logo overlay — оборачивает брендированные потоки x264 + AAC в первый мультиплекс MP4, а passthrough из concat — во второй.
  • Adaptive streaming with HLS, DASH and captions — оставляет неподключённый мультиплексор MP4 на холсте рядом с упаковщиками HLS/DASH как заготовку для поставки MP4.
  • HEVC archive — оборачивает видеодорожку HEVC и стереодорожку AAC в одну архивную копию MP4.
  • H.264 HD — оборачивает видеодорожку H.264 и стереодорожку AAC в одну поставку MP4.

8. Антипаттерны

  • Мультиплексирование несовместимых типов дорожек. MP4 хорошо поддерживает видео H.264 / H.265 и аудио AAC; сочетание с кодеками, которые контейнер формально допускает, но большинство плееров отвергает (например, редкие аудиокодеки), даёт файл, который номинально проходит проверку, но падает на реальных устройствах.
  • Open-GOP видео в MP4, производный от HLS. Когда тот же MP4 позже пересегментируется для HLS или DASH, источник с открытым GOP ломает выравнивание IDR сегментатором. Настройте x264 с выключенным Open GOP для стриминговых конвейеров.
  • Забытая аудиоцепочка. MP4 без аудиовхода молча даёт файл без звука даже когда у источника есть аудио; всегда подключайте аудиосторону графа к этому узлу, когда поставка должна нести звук.
Медиа.маги Документация