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

Last updated

map/audio

map/audio извлекает аудиодорожку из исходного пакета в цепочку copy + mp4.

1. Сводка

Извлекает аудиодорожку из входящего пакета, чтобы её можно было обработать цепочкой аудиофильтров или аудиокодером. Каждый процесс, затрагивающий аудио, начинается с map/audio сразу после источника, потому что остальная аудиоцепочка не может подключиться к Package — ей нужен аудиопоток.

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

  • Отделяете аудио от одного источника для обработки фильтрами и кодером перед повторным мультиплексированием в поставку.
  • Выбираете конкретную дорожку из многодорожечного источника (например, берёте основной стереомикс и оставляете M&E).
  • Делите многоканальный источник на потоки по языкам или по стемам, которые фильтры ниже по потоку могут маршрутизировать независимо.

3. Входы

  • Package — core.Package. Исходный пакет, из которого извлекается аудио. Обязателен.

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

    • concat — сшивает несколько пакетов встык в один непрерывный пакет.

    • download — конечная точка источника, забирающая пакет по URL.

    • mp4 — мультиплексированный пакет MP4, поданный обратно в цепочку повторного маппинга.

    • analyze — передаёт прозондированный пакет дальше, чтобы одна цепочка и зондировала, и продолжала вниз по потоку.

    • decide — передаёт пакет, когда срабатывает его условие.

    • mdecide — передаёт пакет по той ветви, которая совпала.

    • delay — повторно выдаёт пакет после заданного ожидания.

    • mov — упаковывает потоки в контейнер QuickTime MOV.

    • mxf — упаковывает потоки в контейнер MXF.

    • ts — упаковывает потоки в транспортный поток MPEG-2 (.ts).

    • dv — записывает файл Digital Video (DV) в один шаг — кодек и контейнер в одном узле.

    • prores — записывает мезонинный файл Apple ProRes.

    • xdcam — записывает XDCAM-совместимый файл MXF OP1a.

    • dash — упаковывает закодированные аудио, видео и необязательные дорожки субтитров в манифест MPEG-DASH с сопутствующими файлами сегментов.

    • hls3 — упаковывает закодированные дорожки аудио и видео в плейлист HLS v3 с сегментами транспортного потока MPEG-2.

    • hls5 — упаковывает закодированные аудио, видео и необязательные дорожки субтитров в плейлист HLS v5 на основе фрагментированного MP4 (fMP4).

4. Выходы

  • Audio — []filtergraph.AudioTransform. Аудиопоток, готовый для фильтра или кодера.

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

    • aac — кодирует аудио через AAC.

    Аудиофильтры (af/aformat, af/aresample, af/join, af/stereo), дополнительные аудиокодеры (ac3, eac3, pcm), а также passthrough copy и ccinject принимают тот же тип []filtergraph.AudioTransform. Они появятся здесь по мере публикации.

5. Параметры

Диалог настроек узла Map/Audio с полями Node Label и Index.

Диалог «Настройки» — один столбец с двумя полями.

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

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

    • Что задаёт. Подпись над плиткой; на то, какая аудиодорожка выбрана, не влияет.
    • Когда менять. Задавайте, когда в одном графе несколько узлов map/audio — например, по одному на моноканал источника 5.1 или по одному на языковую дорожку, — чтобы каждый выбор был узнаваем с одного взгляда.

  • Index (string, необязательно)

    Выбирает, какую аудиодорожку внутри пакета извлечь.

    • Что задаёт. Нулевой индекс потока или список индексов через запятую, выбранный из таблицы аудиодорожек источника. Оставленный пустым, узел передаёт каждую аудиодорожку источника. Задайте 0, чтобы взять только первую аудиодорожку, 1 — для второй и т. д.; задайте 0,2, чтобы взять первую и третью дорожки, пропустив вторую.
    • Когда менять. Большинство источников несут больше аудио, чем нужно поставке, — стереомикс программы плюс пара M&E плюс описательная дорожка закадра. Фиксируйте индекс, когда процесс должен выбирать детерминированно, или оставляйте пустым, когда цепочка кодера потребляет любое имеющееся аудио.
    • Переменные. Не поддерживаются.

6. Пример

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

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

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

  • H.264 HD — извлекает аудиодорожку из исходного пакета, прогоняет её через цепочку aresample + aac и передаёт закодированное аудио мультиплексору MP4.

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

  • Маппинг несуществующего индекса дорожки. У источника с одной стереодорожкой нет Index = 2; воркер проваливает задачу с ошибкой выхода за диапазон. Проверяйте число дорожек шагом analyze раньше в процессе, когда пул источников разнороден.
  • Выбор одного моноканала там, где у источника стереопара. map/audio выбирает целые дорожки. Чтобы извлечь один канал из стереопары, дайте map/audio взять стереодорожку и поставьте за ним узел af/pan или af/join, который направит нужный канал в кодер.
  • Забытый маппинг языка, который ожидает поставка. Когда источник несёт несколько языковых дорожек, пустой Index передаёт их все; мультиплексор затем выдаёт многодорожечную поставку, даже когда нужен только основной язык. Задавайте Index на ту самую дорожку, которая должна доставляться.

9. Заметки

  • Заголовок диалога — Map/Audio Node Settings. Плитка на холсте показывает иконку и подпись, заданную в Node Label, или идентификатор узла (map/audio), когда подпись не задана.
Медиа.маги Документация