Skip to content

Настройка плейаута

Эта страница нужна, когда вы создаёте или настраиваете отдельный плейаут и его выходной стрим. Если нужен весь путь от VOD-файлов до просмотра абонентом, используйте пример Канал из VOD.

Плейаут проигрывает слоты по расписанию и отдаёт эфир в стрим playout_<id>. Расписание определяет содержимое, а настройки стрима — способ кодирования и раздачи.

Что подготовить

  • Доступ оператора к разделам Playout, VOD и Стримы.
  • Видео со звуком для расписания. Для заглушки подойдёт видео или JPEG-картинка.
  • Для общей заглушки — доступ к management API, curl и jq.

Создайте плейаут

  1. Откройте Playout.
  2. В поле Название нового playout введите имя и нажмите Создать playout. Откроется редактор с пустым расписанием.

Вместе с плейаутом Catena создаёт стрим playout_<id> и источник программы передач. Отдельно создавать стрим и привязывать EPG не нужно. Полный идентификатор <id> виден в адресе редактора после #/playouts/.

Новый плейаут получает исходный формат по умолчанию:

  • 25 fps — частота кадров, к которой приводится содержимое.
  • 1920×1080 — размер кадра на выходе плейаута.
  • Mono, 48 кГц — раскладка и частота звука.
  • 8 бит — глубина цвета.

Выберите выход для зрителей

Плейаут отдаёт несжатые видео YUV и звук PCM. Для обычного HLS-плеера настройте транскодер автоматического стрима:

  1. В блоке Эфир нажмите Открыть карточку стрима.
  2. Перейдите на вкладку Транскодер и выберите пресет Стандартная лестница 1080/720/360 + AAC.
  3. Проверьте в Предпросмотр: вход → выход, что настроены три видеокачества и звук AAC, затем нажмите Сохранить.

Этот пресет кодирует эфир в H.264 и AAC и создаёт три качества для HLS. Другие настройки раздачи и архива тоже находятся на странице стрима, а не в редакторе плейаута.

Как параметры источника влияют на эфир

Плейаут приводит все ассеты к одному исходному формату. Кадр масштабируется до заданного размера, звук — к заданной частоте и раскладке. Это не заменяет транскодер: после приведения плейаут по-прежнему выдаёт несжатые кадры и звук.

Проверьте частоту кадров ассетов

Если частота кадров ассета отличается от исходной, плейаут дублирует или пропускает кадры. Длительность слота не меняется, но движение может стать менее плавным. Такой слот получает предупреждение, сохранение расписания не блокируется. Для равномерного движения используйте ассеты с частотой кадров плейаута.

Где задан исходный формат

Свойства исходного формата находятся на вкладке Источники карточки стрима. Редактор плейаута предназначен для названия, заглушки и расписания. Для смены формата используйте процедуру Измените исходный формат: она требует выключить и снова включить стрим.

Настройте заглушки

Заглушка закрывает паузы в расписании и заменяет содержимое при ошибке ассета. Действует такая очередь:

  • Заглушка слота — относится только к выбранному слоту.
  • Заглушка канала — общая заглушка плейаута; играет, если у слота нет своей или в текущее время слота нет.
  • Аварийный синтез — цветные полосы с тишиной, если подходящая заглушка не задана или недоступна.

Для заглушек используются VOD-ассеты: видео или статичная JPEG-картинка. Картинка остаётся в эфире с тишиной. Live-стрим назначить заглушкой нельзя.

Задайте общую заглушку через API

В проверенной версии консоль не сохраняет поле Заглушка канала: общая кнопка Сохранить возвращает HTTP 422 с сообщением «missing field fps», а настройка не применяется. Не используйте этот путь. Сохранение расписания и заглушки слота работает отдельно.

Общую заглушку можно назначить через management API. В PATCH нужно передать целый config, изменив только filler: если отправить одно поле config.filler, сервер отклонит запрос. Команды ниже читают текущий документ и сохраняют все его параметры, включая расписание и исходный формат.

  1. Загрузите видео или JPEG как отдельный VOD-ассет и дождитесь сведений о файле. Возьмите идентификатор плейаута из адреса редактора.
  2. Задайте адрес установки, учётную запись оператора, идентификатор плейаута и ключ ассета. Пароль передавайте только по HTTPS:

    set -euo pipefail
    BASE='https://catena.example.com'
    API_USER='operator'
    read -rsp 'Operator password: ' API_PASSWORD; echo
    PLAYOUT_ID='<playout id>'
    ASSET_KEY='slates/technical'
    
  3. Найдите идентификатор ассета по ключу:

    ASSET_ID=$(curl -fsS -u "$API_USER:$API_PASSWORD" --get \
      --data-urlencode "name_prefix=$ASSET_KEY" \
      --data-urlencode 'limit=1000' \
      "$BASE/central/api-v4/vod/assets" |
      jq -er --arg key "$ASSET_KEY" '.assets[] | select(.key == $key) | .id')
    
  4. Проверьте, что ассет размещён на доступном хранилище с читаемым журналом. Команда связывает storage_id из placement ассета с записью хранилища и завершится с ошибкой, если подходящего хранилища нет. В этом случае дождитесь готовности VOD и повторите проверку, не переходя к PATCH:

    curl -fsS -u "$API_USER:$API_PASSWORD" \
      -o filler-asset.json "$BASE/central/api-v4/vod/assets/$ASSET_ID"
    curl -fsS -u "$API_USER:$API_PASSWORD" \
      -o vod-storages.json "$BASE/central/api-v4/vod/storages"
    jq -e --slurpfile storages vod-storages.json \
      '.placements[]? as $placement |
       $storages[0].storages[]? |
       select(.id == $placement.storage_id and .status == "available" and .journal == "readable")' \
      filler-asset.json >/dev/null
    
  5. Прочитайте плейаут, сохраните ETag и подготовьте запрос с полным config:

    curl -fsS -u "$API_USER:$API_PASSWORD" \
      -D playout.headers -o playout.json \
      "$BASE/central/api-v4/playouts/$PLAYOUT_ID"
    
    ETAG=$(sed -n 's/^[Ee][Tt][Aa][Gg]:[[:space:]]*//p' playout.headers | tr -d '\r')
    if [[ -z "$ETAG" ]]; then
      echo 'ETag is missing; refusing to PATCH' >&2
      exit 1
    fi
    
    jq --arg filler "vod://$ASSET_ID" \
      '{config: (.config + {filler: $filler})}' playout.json > playout-filler.json
    
  6. Отправьте изменение с ETag из прочитанного документа:

    curl -fsS -u "$API_USER:$API_PASSWORD" \
      -X PATCH "$BASE/central/api-v4/playouts/$PLAYOUT_ID" \
      -H "If-Match: $ETAG" \
      -H 'Content-Type: application/merge-patch+json' \
      --data-binary @playout-filler.json |
      jq '.playout.config'
    

В ответе filler должен содержать vod://<asset id>, а fps, size, sample_rate, audio и bit_depth — прежние значения. Если сервер ответил HTTP 412, документ изменился в другой сессии: повторите чтение, проверьте новую конфигурацию и только затем подготовьте запрос заново. Не отправляйте старый ETag повторно.

У нового плейаута без слотов общая заглушка уже должна быть в эфире — проверьте её по HLS, как описано ниже. В существующем плейауте с текущим слотом сохранённый ответ подтверждает настройку, а картинку заглушки можно увидеть в ближайшей паузе расписания. Не удаляйте текущий слот ради проверки.

Назначьте заглушку слота в консоли

  1. Создайте или откройте слот в редакторе.
  2. В поле Заглушка слота (необязательно) выберите VOD-ассет. Значение — как у канала — оставляет слоту общую заглушку плейаута.
  3. Нажмите Создать слот или Сохранить в окне слота, затем общую кнопку Сохранить над сеткой. Не меняйте при этом поле Заглушка канала.

Откройте слот повторно и проверьте выбранный ассет. В блоке Эфир название текущего слота должно соответствовать сохранённому расписанию.

Проверьте стрим

  1. В блоке Эфир нажмите Открыть карточку стрима и перейдите на вкладку Источники.
  2. Проверьте протокол playout и идентификатор плейаута. Ссылка под идентификатором ведёт обратно в редактор.

Вход стрима playout и обратная ссылка в редактор

  1. Откройте вкладку Исходящий поток. В блоке Как забрать поток нажмите Выписать рядом с Выписать Билет на просмотр.
  2. Скопируйте адрес HLS / LL-HLS в HLS-плеер. Для проверки манифеста откройте адрес в новой вкладке браузера.

Мастер-манифест должен содержать качества, а манифест качества — медиасегменты. Плеер должен показать текущий слот со звуком; у пустого расписания — общую заглушку или цветные полосы. Если есть только заголовок плейлиста, проверьте настройку транскодера. При ошибке доступа выпустите новый билет.

Не используйте JPEG-превью редактора как обязательную проверку: при включённой защите воспроизведения /playback/live-preview-jpeg/playout_<id> может отвечать HTTP 403 даже при работающем HLS.

Программа передач (EPG)

Источник EPG создаётся вместе с плейаутом и уже привязан к стриму. Какие данные слота попадают в программу, как обновить её после правки и где проверить результат, читайте на странице Программа передач плейаута.

Удаление

Удаление необратимо. Последствия для стрима и EPG, порядок действий и проверка приведены в разделе Удалите плейаут.

Что дальше