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

Last updated

upload

Узел upload с входным ребром Package, приходящим от узла выше по потоку.

1. Сводка

Записывает готовый файл на целевой URL. Сток каждого процесса — как только пакет смультиплексирован, сегментирован или иначе финализирован, upload доставляет его в хранилище или точку распространения, названную целевым URL.

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

  • Публикуете готовую поставку MP4, MOV или MXF в облачное объектное хранилище (S3, GCS, Azure Blob) для последующего приёма в CMS или CDN.
  • Отправляете пакеты HLS или DASH в origin-бакет, чтобы манифест и сегменты легли по предсказуемым URL.
  • Доставляете на цель SMB или FTP в корпоративной сети либо на HTTP-точку, принимающую загрузки.

3. Входы

  • Package — core.Package. Файл или упакованный поток для записи. Обязателен; процесс должен сформировать его выше по потоку.

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

    • mp4 — поставка MP4 (ISO-BMFF).
    • mov — поставка QuickTime MOV.
    • mxf — вещательная поставка MXF.
    • ts — файл или поток MPEG-TS.
    • dash — манифест DASH плюс файлы сегментов.
    • hls3 — плейлист HLS v3 плюс TS-сегменты.
    • hls5 — плейлист HLS v5 плюс fMP4-сегменты.
    • dv — поток, упакованный в DV.
    • prores — поток, упакованный в ProRes.
    • xdcam — поток, упакованный в XDCAM HD.
    • download — сквозная доставка неизменённого источника.

4. Выходы

upload — это сток: у него нет перетаскиваемого выходного пина, и ничто в процессе не потребляет его результат. Целевой URL — это контракт с внешним миром; всё, что ниже процесса, читает напрямую оттуда.

Узел отдаёт внутренний канал URL с финальным местом записи для инструментов происхождения данных и уведомлений платформы, но он не выводится на холсте как подключаемый пин.

5. Параметры

Диалог «Upload Node Settings» с полями Node Label и URL.

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

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

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

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

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

    Целевой URL для записи.

    • Что задаёт. Протокол и цель, куда пишет upload. Допустимые протоколы: http, https, ftp, s3 и smb. URL объектного хранилища обычно несут подпись и параметры бакета в самом URL; цели SMB несут учётные данные в части хоста.
    • Когда менять. Почти всегда. Боевые процессы оставляют поле привязанным к переменной процесса — по умолчанию во всех опубликованных примерах это $Out, — чтобы каждая задача подставляла своё назначение без правки графа. Прописывайте URL жёстко только для разовой диагностики.
    • Переменные. Поддерживаются. Привяжите к переменной процесса типа url и подставляйте значение при создании задачи.

6. Пример

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

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

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

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

  • Перезапись без явного разрешения. Большинство назначений молча принимают PUT на существующий ключ. Если процесс перезапускается на той же задаче — вручную или повтором, — предыдущая поставка заменяется. Используйте уникальные целевые URL (обычно путь с суффиксом task-id), когда перезапись небезопасна.
  • Допущение о достижимости с воркера. Загрузка идёт на воркере, а не на машине пользователя. Подписанный URL S3, принятый дашбордом через корпоративный прокси, может упасть на флоте воркеров; SMB-шара, маршрутизируемая из офиса, не обязательно достижима из подсети воркеров.
  • Расчёт на идемпотентность загрузки. upload пишет то, что отдаёт узел выше. Два прогона процесса с одним источником всё равно могут дать слегка разный выход (детерминизм кодера, метки времени в сегментах). Не полагайтесь на побайтово равные выходы ради безопасности повторов.
  • Пропуск валидации. Ставьте шаг analyze или контроля качества перед загрузкой в цепочках, где плохая поставка распространится в систему ниже по потоку. Как только upload успешен, файл уже «живой».

9. Заметки

  • Узел рисует один видимый пин: вход Package слева. Поле URL справа на плитке — встроенная подсказка о настроенном назначении, а не подключаемый выход.
  • Заголовок диалога — Upload Node Settings.
Медиа.маги Документация