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

Last updated

Сторонние каналы

Обзор

Используйте Сторонние каналы, чтобы вводить внешне закодированный HLS-поток в слой дистрибуции платформы, не перекодируя его. Каждая запись регистрирует один партнёрский, аффилированный или синдицированный URL манифеста, чтобы дистрибуция могла ссылаться на него наряду с собственными каналами платформы и раздавать его с той же граничной точки.

Эта страница одновременно и каталог, и редактор: отдельного детального вида нет, потому что осматривать тут нечего, кроме самого URL манифеста. Добавление, редактирование и удаление выполняются прямо в этом списке.

Боковое меню, шапку страницы и меню учётной записи, которые появляются на каждом экране после входа, см. на странице Интерфейс приложения.

Как сюда попасть

Боковое меню → Сторонние каналы. Это единственная запись в группе Дистрибуция на данной поверхности, у которой нет вложенных страниц.

Что здесь можно делать

Читать таблицу сторонних каналов

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

Каждая строка — один внешний канал. Столбцы:

  • # — порядковый номер строки. Он позиционный, а не устойчивый идентификатор: меняется при удалении строк выше. Чтобы сослаться на канал в разговоре или в привязке дистрибуции, используйте Название.
  • Название — метка для оператора, заданная при регистрации канала. Именно она появляется в разделе Дистрибуция при привязке стороннего потока к аудитории, поэтому выбирайте понятное следующему оператору имя (название партнёра или потока, исходного источника).
  • HLS — построчная кнопка Воспроизвести, которая прямо на месте показывает настроенный HLS-манифест. Используйте её, чтобы убедиться, что источник доступен и плейлист разбирается, не покидая страницу.
  • Действия — построчные элементы управления — см. Отредактировать канал и Удалить канал.

Используйте это, когда:

  • проверяете, что партнёрский поток ещё зарегистрирован, прежде чем добавлять его в новую дистрибуцию;
  • выборочно проверяете источник, воспроизводя его манифест из списка, прежде чем поднимать на нём дистрибуцию для аудитории;
  • ищете название канала, на который оператор сослался по имени партнёра.

Найти канал

Назначение. Найти канал по названию, когда список настолько длинный, что прокрутка медленнее поиска.

  1. Нажмите поле Поиск в левой части панели инструментов.
  2. Введите любую часть названия — таблица фильтруется по мере ввода.
  3. Очистите поле, чтобы вернуть полный список.

Используйте это, когда:

  • список занимает несколько экранов, а имя партнёра вы помните;
  • проверяете, не зарегистрирован ли уже канал с таким именем, прежде чем создавать дубликат.

Зарегистрировать сторонний канал

Назначение. Зарегистрировать внешне закодированный HLS-поток, чтобы дистрибуция могла раздавать его через граничную точку платформы без перекодирования.

  1. Нажмите + Добавить канал в правой части панели инструментов. Откроется диалог Новый канал.
  2. Введите Название — минимум три символа. Это метка, которую канал несёт по всей платформе; именно она появляется при привязке канала к дистрибуции. Называйте его по партнёру или потоку (бренд партнёра, синдицированный источник), чтобы журнал действий был читаем.
  3. Введите URL HLS-потока — внешний мастер-манифест, который платформа забирает. Поле ожидает адрес вида https://…, оканчивающийся на .m3u8; подсказка под полем напоминает требуемый вид. Вставьте URL, опубликованный партнёром; платформа не переприёмывает и не ремультиплексирует поток, поэтому зарегистрированный манифест — ровно тот, что получат потребители.
  4. Нажмите Сохранить. Кнопка неактивна, пока название короче трёх символов или URL не разбирается как точка .m3u8.

Используйте это, когда:

  • подключаете партнёрский поток, который уже закодирован на стороне источника и должен лишь проходить через граничную точку платформы;
  • добавляете аффилированный или синдицированный HLS-источник в каталог, чтобы он стоял рядом с каналами платформы в одной дистрибуции;
  • поднимаете конвейер пере-раздачи для события, чьё прямое кодирование выполняет партнёр.

Результат: новая строка в списке. Канал становится доступен для выбора в форме Дистрибуция, где его можно привязать к аудитории.

Отредактировать канал

Назначение. Изменить название канала или его исходный URL манифеста, когда партнёр меняет одно из них.

  1. Нажмите значок карандаша в ячейке Действия строки. Откроется диалог Редактировать канал, предзаполненный текущими значениями; он повторяет форму и проверку диалога Новый канал.
  2. Измените Название и/или URL HLS-потока. Действуют те же правила: минимум три символа и формат .m3u8.
  3. Нажмите Сохранить, чтобы применить, или Отмена, чтобы выйти.

Используйте это, когда:

  • партнёр перенёс свою HLS-точку на новый источник и текущий URL больше не разрешается;
  • партнёр переименовал поток, и метка в каталоге должна совпасть;
  • исправляете опечатку в названии, допущенную при подключении.

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

Удалить канал

Назначение. Убрать канал из каталога, когда партнёрские отношения заканчиваются или поток больше не нужен.

  1. Нажмите значок корзины в ячейке Действия строки. Браузер запросит подтверждение удаления и назовёт канал по названию.
  2. Подтвердите удаление либо отмените, чтобы оставить канал.

Удаление канала не отвязывает его от дистрибуции, к которой он уже привязан. Сначала наведите порядок в дистрибуции, убрав канал из её списка Origin или Live (см. Дистрибуция), иначе дистрибуция сохранит ссылку на несуществующий канал.

Используйте это, когда:

  • завершаете партнёрский контракт и исходный поток уходит;
  • исправляете ошибку подключения до того, как канал привязан к какой-либо дистрибуции.

Сторонние каналы и каналы прямого эфира

Обе поверхности питают одну и ту же привязку в дистрибуции, но описывают две разные эксплуатационные формы:

  • Каналы — кодирование владеет платформа. Она принимает контрибуционный поток (RTMP, SRT или другой протокол), пропускает его через лестницу прямого кодировщика и выдаёт HLS-варианты со своей инфраструктуры. Платформа управляет битрейтами, кодеком, длиной сегмента и жизненным циклом.
  • Сторонние каналы — кодирование владеет партнёр. Платформа хранит лишь URL манифеста партнёра и без изменений пробрасывает его через граничную точку. Здесь нет кодировщика, лестницы и обработки на уровне сегментов — только зарегистрированная точка забора.

Выбирайте подходящее под задачу:

  • используйте Каналы, когда кодировщиком записи является платформа (по контракту результат производит платформа либо источник — это сырой контрибуционный поток, который нужно кодировать);
  • используйте Сторонние каналы, когда кодировщиком записи является партнёр (по контракту платформа выступает точкой дистрибуции либо источник уже является готовым HLS-плейлистом).

Одна дистрибуция может привязывать смесь и тех, и других; аудитория видит единый каталог и не должна знать, какая сторона выполнила кодирование.

Связанные страницы

  • Дистрибуция — где сторонние каналы привязываются к аудитории.
  • Каналы — кодируемые платформой прямые потоки, которые делят с этим списком поверхность дистрибуции.
  • Интерфейс приложения — боковое меню, шапка и меню учётной записи.
Медиа.маги Документация