Last updated 2026-06-29 15:18

download

1. Сводка

Забирает исходный файл по URL внутрь процесса. Каждый процесс начинается с download (или со статического входа) — это узел-источник, который вводит внешние медиа в конвейер прежде, чем к ним сможет прикоснуться любой фильтр или кодер.

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

• Забираете медиа из облачного объектного хранилища (S3, GCS, Azure Blob) по подписанным URL, переданным как переменная процесса.
• Подтягиваете ассеты от агрегатора доставки по HTTP или FTP, который планирует перекодирование, как только файл опубликован.
• Интеграции с watch-папкой или вебхуком, где каждое новое поступление запускает один прогон процесса, а входной URL передаётся для каждой задачи.

3. Входы

Нет — download является узлом-источником. Что попадает в граф, задаёт URL; выше по потоку в узел ничего не подключается.

4. Выходы

• Package — core.Package. Скачанный файл как внутренний пакет процесса. Подключите его к остальной части графа.

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

  • analyze — инспектирует пакет и выводит его технические свойства как метаданные-пины.
  • concat — склеивает несколько пакетов встык в один непрерывный пакет.
  • delete — удаляет скачанный файл из его исходного URL после того, как он передан дальше.
  • move — перемещает скачанный файл с одного URL на другой.
  • delay — удерживает пакет на заданное время ожидания.
  • eval — вычисляет производное значение из пакета выражением Jinja.
  • map/audio, map/text, map/timecode, map/video — выбирают потоки, которые нужно оставить перед кодированием или мультиплексированием.
  • upload — записывает пакет на целевой URL, когда преобразование не нужно.

5. Параметры

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

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

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

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

• Input URL (string, обязателен, переменные допускаются)

  Исходный URL для забора.

  • Что задаёт. Протокол и расположение, откуда читает download. Допустимые протоколы: http, https, ftp, rtmp и rtsp. Аутентификация, подпись и любые параметры объекта несёт сам URL (строка запроса для предподписанного облачного хранилища, user:password@host для FTP и т. п.).
  • Когда менять. Почти всегда. Боевые процессы оставляют поле привязанным к переменной процесса — по умолчанию во всех опубликованных примерах это $In, — чтобы каждая задача подставляла свой исходный URL без правки графа. Прописывайте URL жёстко только для разовой диагностики.
  • Переменные. Поддерживаются. Привяжите к переменной процесса типа url и подставляйте значение при создании задачи.

6. Пример

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

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

• H.264 HD — забирает исходный ассет, который последующая цепочка H.264 + AAC кодирует и мультиплексирует в поставку MP4.
• HEVC — подтягивает источник в цепочку деинтерлейсинга, масштабирования и x265.
• Adaptive streaming with HLS, DASH and captions — однократно забирает источник для много-битрейтной доставки HLS + DASH с сайдкар-субтитрами.
• AVC-Intra MXF broadcast mezzanine — забирает источник для кодирования мезонина AVC-Intra MXF.
• MP4 with branded logo overlay — забирает и основное видео, и изображение логотипа двумя параллельными загрузками.
• QTRLE animation master (MOV) — забирает источник для кодирования мастера QTRLE.
• Content-aware preview proxy ladder — однократно забирает источник для лестницы «анализ-и-ветвление», выбирающей класс прокси.
• MPEG-TS broadcast pre-encode — забирает источник для цепочки предкодирования вещания MPEG-TS.
• Cropped H.264 MP4 from interlaced source — забирает чересстрочный источник, потребляемый и обрезанной, и исходной ветвями кодирования.
• XDCAM HD broadcast mezzanine — забирает источник для кодирования вещательного мезонина XDCAM HD.
• Three-tier MP4 ladder (LQ / MQ / HQ) — однократно забирает источник для трёх параллельных копий MP4 на уровнях LQ, MQ и HQ.
• 5.1 surround AC-3 MP4 — забирает источник, шесть моноаудиодорожек которого объединяются в микс 5.1 AC-3.
• DVCPRO 576i SD master — забирает источник для кодирования SD-мастера DVCPRO 576i.

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

• Жёсткое прописывание URL в теле процесса. Оставляйте Input URL привязанным к переменной (соглашение — $In). Боевые прогоны подставляют URL для каждой задачи; жёстко вписанный URL означает правку процесса под каждый новый ассет.
• Допущение о достижимости. Загрузка идёт на воркере, а не на машине пользователя. Предподписанный URL из корпоративного бакета, требующего VPN, HTTP-сервер, доступный только из интранета дашборда, или FTP-хост за фаерволом упадут с сетевой ошибкой. Убедитесь, что флот воркеров достигает URL, прежде чем планировать прогон.
• Слепое доверие целостности входа. download забирает и не валидирует. Сочетайте с шагом analyze перед кодированием, когда пул источников разнородный (разные кодеки, частоты кадров или битые файлы) — ранний отказ в процессе экономит потраченное время кодирования.

9. Заметки

• Узел рисует на холсте один выходной пин Package. Второй канал Meta формируется внутренне и потребляется инструментами аналитики и происхождения данных платформы; его не нужно подключать, и он не выводится как перетаскиваемый пин.
• Заголовок диалога — Download Node Settings; плитка на холсте показывает иконку и подпись, заданную в Node Label, либо идентификатор узла (download), когда подпись не задана.