Настройки потока или группы

Эти настройки можно указывать внутри директив stream, ondemand, rewrite и live. Мы называем их опции.

auth

auth http://backend/; Включение авторизации для потока. Более подробно в разделе про авторизацию.

domains

domains host1.ru *.host1.ru; Указание доменов, на которых можно проигрывать это видео. Не работает для клиентов, которые не передают Referer. Для правильной работы в WEB в списке доменов должен присутствовать домен, с которого загружается embed плеер.

allowed_countries

allowed_countries RU UA KZ; Cписок стран (двухбуквенные коды как в БД maxmind) с которых разрешен доступ.

url

url tshttp://transcoder:port/; Адрес источника. Можно перечислить несколько директив url для выбора источника по кругу.

Caution

Если используется UDP-источник, то в файле конфигурации этот UDP-адрес должен использоваться только один раз. Если несколько потоков будут использовать один и тот же адрес, то, скорее всего, это просто не будет работать.

urls

urls source1 source2; Список адресов источников. Подробнее про механизм переключения источников.

url_prefix

url_prefix prefix При использовании протокола HLS, адреса отдельных сегментов и плейлистов в вариантном плейлисте будут начинаться с указанного префикса. Эта опция может быть использована не только как часть настроек конкретного потока, но и в глобальной части файла конфигурации. Прописанная глобально опция применяется ко всем потокам на этом сервере. Пример: url_prefix http://my.domain.address.com:80

dvr

dvr /storage 1d 50% schedule=8:00-16:00;

dvr @my_raid 1d 50% schedule=8:00-16:00;

Включение архива. Flussonic Media Server будет писать в каталог /storage/streamname или дисковый массив @my_raid. Очищать архив он будет либо через день, либо когда диск, на который пишут, заполнится на 50%. Вместо дней можно указывать часы: 20h. Параметр schedule позволяет задать расписание для записи архива в виде интервалов. Время указывается в UTC в часах и опционально минутах, интервал может перехлёстываться через полночь: 22-1:30. Расписание может содержать несколько интервалов, разделенных запятой: 8:00-16:00,22-1:30.

dvr_offline

dvr_offline /storage 1d 50%; При указании этой опции, поток не будет включать запись на старте. Её надо будет включать явно через API. Эта опция указывается вместо опции `dvr`.

push udp

`push udp://239.0.0.1:5001;`

Flussonic Media Server будет посылать поток по UDP MPEG-TS.

Чтобы задать UDP сокету параметр MULTICAST_TTL, используйте следующий синтаксис: push udp://239.0.0.1:5001?ttl=8;.

Чтобы задать постоянный битрейт (CBR), используйте следующий синтаксис: push udp://239.0.0.1:5001?cbr=2000;, где 2000 — битрейт в kbit/sec.

Опция multicast_loopпозволяет захватывать отправленный в UDP мультикаст поток на отправляющем хосте, например, захватывать обратно во Flussonic.

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

thumbnails

thumbnails; Включает генерацию JPEG-скриншотов потока..

retry_limit

retry_limit 10; Количество раз, которое Flussonic Media Server будет пытаться подключиться к источникам, прежде чем отключить не статический поток.

clients_timeout

clients_timeout 10; Количество секунд которое Flussonic Media Server будет держать нестатический стрим после последнего обращения клиента.

source_timeout

source_timeout 10; Количество секунд, которое Flussonic Media Server будет ожидать кадры от источника. По прошествии этого времени Flussonic Media Server переподключится к источнику. По умолчанию значение source_timeout равно 60 секундам.

frames_timeout

frames_timeout 3; Время в секундах, в течение которого Flussonic Media Server ожидает кадры от источника прежде чем генерировать событие frames_timed_out. Это время должно быть меньше, чем source_timeout. Событие frames_timed_out уведомляет вас о том, что источник, возможно, скоро отключится. Если от источника снова начали поступать кадры, до наступления source_timeout, Flussonic генерирует событие frames_restored.

password

password secret; Пароль, который должен передаваться в query string (http или rtmp) для публикации в поток или в группу.

push rtmp

push rtmp://DESTINATION_SERVER/STREAM_NAME; При указании этой опции Flussonic Media Server будет публиковать поток на другой сервер по протоколу RTMP. Если для этого потока был включен транскодер, Flussonic сначала транскодирует поток, а затем передает его.

backup

backup vod/blank.mp4; Указание этой опции в потоке будет запускать указанный файл vod/blank.mp4 пока нет видео от источника. Управлять файлом-заглушкой можно с помощью дополнительных опций.

url publish://

url publish://; Указание этой опции в потоке позволяет публиковать в него видео. Не используется для группы потоков.

on_publish

on_publish http://host/publish.php;

on_publish /etc/flussonic/publish.lua; При публикации в этот поток или группу потоков будет вызывать скрипт или делаться HTTP запрос с параметрами в виде названия потока, IP адреса публикующего и т.п. В ответ можно либо отказать в публикации, либо разрешить:
— HTTP бэкенд должен вернуть либо 200 OK, либо 403 Forbidden;
— .lua скрипт должен вернуть либо {true, {}}, либо {false, {}}.

max_sessions

max_sessions 1000; Лимит по количеству сессий на поток.

settings_rtp

rtp udp; Включает принудительное использование UDP для работы с RTSP камерами.

add_audio_only

add_audio_only; Добавляет в HLS плейлист ссылку на поток только с аудио. Требуется для прохождения валидации приложения в Apple.

prepush 0

prepush 0; Отключается prepush, т.е. более быстрый старт потока. Может быть нужно для сохранения риалтайма в потоке.

prepush

prepush 10; Включает буфер заданной продолжительности. Если соединение клиента с сервером прерывается или замедляется, то он проигрывает видео из буфера, что позволяет плееру стартовать быстрее, но с отставанием.

max_bitrate

max_bitrate 1000; Лимит битрейта публикуемого потока.

logo

logo path=flu/embed-logo.png height=100 width=100 left=0 top=0; Добавить логотип при воспроизведении потока. Такой логотип не будет отображаться на мобильных устройствах и в DVR плеере. Чтобы добавить логотип к видео используйте транскодер.
path (Обязательный параметр) — путь относительно директории wwwroot.
height, width — размер изображения логотипа в пикселях. Если задан только один из этих параметров, то второй будет изменен пропорционально. Не указывайте эти параметры, чтобы отобразить логотип в исходном размере.
left, top, right, bottom — положение логотипа заданное в виде смещения в пикселях от левого, верхнего, правого и нижнего края видео. Например, чтобы отобразить логотип в правом нижнем углу: `right=0, bottom=0`. Не используйте одновременно параметры left, top, right и bottom.

mpegts_pids

mpegts_pids pmt=4095 sdt=0x12 v1=211 v2=212 a0=220 t0=16#fb;

С помощью этого параметра задаются значения PID исходящему MPEG-TS потоку (push udp://). Можно задать PID для PMT, SDT, дорожек с видео, аудио и субтитрами. Дорожки нумеруются начиная с 1: `a1=123` установит PID для первой аудио дорожки. Можно задать базовый PID для дорожек определённого типа с помощью индекса 0. Например, `t0=100` установит первой дорожке субтитров PID равный 101, второй - 102 и т.д. Числа могут быть заданы в десятичном виде (по умолчанию) или с префиксом `16#` для шестнадцатеричных чисел.

PIDы можно указать и ещё одним способом.

program_id

meta program_id "10"; Этот параметр задает идентификатор программы в выходном MPEG-TS потоке.

provider

provider Flussonic; Этот параметр задает название провайдера программы в выходном MPEG-TS потоке.

segment_duration

segment_duration 4; Регулирует длительность сегмента в HLS и HDS потоках (в секундах). Не для всех получаемых потоков Flussonic сможет применить указанную длительность сегмента. Всё зависит от длины GOP у потока. Нужно, чтобы сегмент был кратен GOP, потому что GOP нельзя порезать на части. Например, для потока с GOP в 4 секунды допустима длина сегмента 4 секунды, 8 секунд, 12 секунд и т.д. Если это не так, то Flussonic создаёт сегменты равные GOP.

segment_count

segment_count 4; Регулирует количество сегментов в HLS и HDS плейлистах.

group

group sport; Используется только на сервере-источнике, чтобы отнести поток к одной или нескольким группам ТВ-каналов. Подробнее

disabled

disabled; Отключить поток.