Захват источника¶

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

Что настраивается на странице захвата¶

Страница захвата источника

На странице захвата оператор может:

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

Если у потока настроено несколько входов, их порядок имеет значение, поэтому интерфейс позволяет поднимать и опускать входы в списке.

Стратегия кластеризации¶

При настройке захвата оператор должен самостоятельно решить, какую стратегию кластеризации выбрать:

cluster ingest;
double publish;
twincast.

Выбор этой стратегии определяет, как именно платформа будет принимать сигнал и как будет вести себя система при отказе одного из трактов приема.

По умолчанию используется cluster ingest. Это стандартный механизм, который обещает, что внешний стрим будет принят на одном из origin-узлов или связанных с ними трактов захвата.

Однако в задачах корпоративного телевидения cluster ingest встречается не так часто, как в классическом телевещании или видеонаблюдении. Причина в том, что cluster ingest подразумевает наличие источника, к которому система может сама обратиться за потоком. В корпоративном ТВ такой сценарий используется реже, поскольку там чаще встречается не самостоятельный захват, а публикация сигнала в сторону Agora.

Подробное описание этих режимов приведено на отдельных страницах архитектуры:

Поддерживаемые типы входов¶

В текущем интерфейсе Agora для потока можно настроить следующие типы входов:

publish;
multicast;
SRT;
RTSP;
HDMI.

Каждый тип входа имеет свой набор параметров.

Multicast¶

Для multicast указываются:

IP-адрес;
порт;
номер программы, если он используется.

Такой вход подходит для приема потока по локальной IP-сети предприятия

SRT¶

Для SRT в режиме caller (т.е. когда соединение открывается со стороны Agora) настраиваются:

host;
порт;
passphrase, если используется защита соединения.

Этот режим используется для надежного приема потока по IP-сети.

SRT в Agora может использоваться в двух основных сценариях:

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

В случае, если источник сам публикует по SRT, нужно указать режим publish и настроить порт для приема SRT

RTSP¶

Для RTSP задается URL источника.

Такой вход используется приема для камер, аудио кодеров и других IP-источников, работающих по RTSP.

HDMI¶

Для HDMI оператор выбирает устройство из списка доступных IO-устройств.

В списке показываются:

hostname стримера;
имя устройства.

Если свободных HDMI-устройств нет, интерфейс сообщает об этом отдельно.

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

Работа со списком входов¶

Для каждого входа в списке отображаются:

тип входа;
краткая сводка параметров;
действия редактирования;
действия удаления;
кнопки изменения порядка.

Это позволяет оператору быстро проверить конфигурацию приема и перестроить приоритет входов без ручного редактирования служебных данных.

Автоматическое переключение между источниками¶

Автоматическое переключение между источниками является одним из самых важных механизмов работы с входами в Agora.

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

Если на текущем активном источнике в течение времени, указанного как source_timeout, не появляются кадры, система переключается на следующий доступный источник по приоритету.

Это позволяет заранее подготовить резервные сценарии показа без ручного вмешательства оператора.

Пример приоритетов источников¶

Один из типичных сценариев для корпоративного ТВ:

первым приоритетом задается публикация потока;
вторым приоритетом задается захват внешнего источника.

В такой конфигурации:

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

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

Режим ожидания публикации¶

Для части сценариев в корпоративном ТВ источник заранее не задается как фиксированный вход. Вместо этого поток создается в режиме ожидания публикации.

В таком режиме:

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

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