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

Last updated

map/text

map/text извлекает дорожку субтитров из исходного пакета в цепочку ccinject.

1. Сводка

Извлекает текстовую дорожку или дорожку субтитров из входящего пакета, чтобы её можно было мультиплексировать в стриминговый пакет или вжечь в видео ниже по потоку. Используйте этот узел, когда источник несёт встроенные субтитры или сайдкар-дорожки субтитров, которые должны попасть в поставку.

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

  • Извлекаете встроенные скрытые субтитры CEA-608 / CEA-708 для упаковки в стриминговый манифест ниже по потоку.
  • Вытаскиваете сайдкар субтитров (например, SRT, VTT, TTML) из пакета, чтобы его можно было мультиплексировать, перекодировать или вжечь в кадр видео.
  • Выбираете одну языковую дорожку из многоязычного источника и отбрасываете остальные перед упаковкой.

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. Выходы

  • Text — []core.TextTrack. Текстовая дорожка, готовая для инжектора субтитров или стримингового мультиплексора.

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

    Стриминговые мультиплексоры (dash, hls5) принимают вход Text и берут этот выход напрямую; ccinject мультиплексирует субтитры в контейнер. hls3 не принимает вход Text и не может потреблять map/text.

5. Параметры

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

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

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

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

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

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

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

    • Что задаёт. Нулевой индекс потока или список индексов через запятую, выбранный из таблицы текстовых дорожек источника. Оставленный пустым, узел передаёт каждую текстовую дорожку источника. Задайте 0, чтобы взять только первую текстовую дорожку, и т. д.
    • Когда менять. Когда поставка указывает, какой язык или какой тип субтитров (открытые / скрытые, форсированные / обычные) доставляется. Оставляйте пустым, когда мультиплексор должен нести каждую доступную дорожку.
    • Переменные. Не поддерживаются.

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

  • Маппинг не того канала субтитров CEA. Источники могут нести и каналы CEA-608, и CEA-708, или несколько сервисных каналов. Сверьте индекс канала с источником перед фиксацией Index — пустая дорожка субтитров доставляется без ошибок, но и без субтитров.
  • Ожидание, что hls3 примет выход. Мультиплексор hls3 не выставляет входной контакт Text. Направляйте на hls5 (поддерживает сайдкар-группы субтитров), dash или подавайте ccinject выше по потоку перед мультиплексором контейнера, поддерживающим встроенные субтитры.
  • Забытый языковой тег на стороне поставки. Мультиплексор ниже по потоку (hls5, dash) подписывает дорожки субтитров для плеера; map/text только извлекает поток. Если требования поставки нуждаются в конкретном коде языка BCP-47, задавайте его на мультиплексоре, а не здесь.

9. Заметки

  • Заголовок диалога — Map/Text Node Settings.
Медиа.маги Документация