Проигрывание

Проигрывание потоков

Flussonic Media Server позволяет проигрывать потоки по разным протоколам. Чтобы посмотреть список ссылок для проигрывания, щелкните имя потока на вкладке Media — Streams и перейдите на вкладку Output. Вы можете скопировать тот или иной URL в буфер обмена, нажав кнопку копирования в конце строки соответствующего URL-адреса.

Output protocols

Ниже приведено подробное описание URL-адресов, которые следует использовать в плеерах для воспроизведения видео по различным протоколам, со ссылками на разделы о настройке воспроизведения через каждый протокол. Проиграть потоки по некоторым протоколам можно также в плеере предпросмотра прямо во Flussonic UI.

Кроме того, вы можете управлять проигрыванием потоков с помощью Streaming API.

embed.html

Адрес: http://FLUSSONIC-IP/STREAMNAME/embed.html

В Flussonic Media Server есть специальная страница — embed.html, которая предназначена для вставки видео на сайт или просмотра видео через браузер. Страница автоматически определяет браузер и выбирает поддерживаемый протокол. Для большинства устройств на сегодня — это HLS. Подробнее в статье Вставка видео на сайт (embed.html).

Полная OpenAPI спецификация: Streaming API.

HLS

Адрес для плеера: http://FLUSSONIC-IP/STREAMNAME/index.m3u8

Подробнее в статье Воспроизведение HLS. Для вставки на сайт используйте (embed.html) или любой сторонний плеер. Например, hls.js или clappr.

Полная OpenAPI спецификация: Streaming API.

DASH

Поток доступен по адресу http://FLUSSONIC-IP/STREAMNAME/index.mpd

Подробнее в статье Воспроизведение DASH.

Полная OpenAPI спецификация: Streaming API.

MSE-LD

Адрес для плеера: ws://FLUSSONIC-IP/STREAMNAME/mse_ld

HTML5 (MSE-LD)

Поток, проигрываемый по HTML5, доступен по адресу: http://FLUSSONIC-IP/STREAMNAME/embed.html?realtime=true

Подробнее в статье HTML5 (MSE-LD) воспроизведение с низкой задержкой.

MSS

Поток доступен по адресу: http://FLUSSONIC-IP/STREAMNAME.isml/manifest

Подробнее в статье Воспроизведение MSS.

Полная OpenAPI спецификация: Streaming API.

HTTP MPEG-TS

Поток доступен по адресу: http://FLUSSONIC-IP/STREAMNAME/mpegts

HTTP MPEG-TS с относительным таймшифтом

URL-адрес для проигрывания HTTP MPEG-TS с относительным таймшифтом:

http://FLUSSONIC-IP:PORT/STREAM_NAME/timeshift_rel-3600.ts

В этом примере записанный поток будет проигрываться с задержкой в 1 час (3600 секунд).

HTTP MPEG-TS с абсолютным таймшифтом

URL-адрес для проигрывания HTTP MPEG-TS с абсолютным таймшифтом:

http://FLUSSONIC-IP:PORT/STREAM_NAME/timeshift_abs-1643257722.ts.

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

RTMP

Поток доступен по адресу:

rtmp://FLUSSONIC-IP/static/STREAMNAME

Подробнее о настройке см. Воспроизведение RTMP

RTSP

Поток доступен по адресу:

rtsp://FLUSSONIC-IP/STREAMNAME

Если у потока есть несколько аудио- и видеодорожек или дорожек с субтитрами, то вы можете выбрать какие дорожки проигрывать с помощью параметра filter.tracks.

Примеры:

rtsp://FLUSSONIC-IP/STREAMNAME?filter.tracks=a2v1
rtsp://FLUSSONIC-IP/vod/file?filter.tracks=a2v1 — VOD.
rtsp://FLUSSONIC-IP/STREAMNAME2 = rtsp://FLUSSONIC-IP/STREAMNAME1?filter.tracks=v1a1

Можно выбрать одну дорожку:

rtsp://FLUSSONIC-IP/STREAMNAME?filter.tracks=a1 — выбрать только аудио.
rtsp://FLUSSONIC-IP/STREAMNAME?filter.tracks=v1 — выбрать только видео.

WebRTC

Поток по протоколу WebRTC WHEP доступен по адресу:

http://FLUSSONIC-IP/STREAM_NAME/whep

Подробнее о WebRTC плеере и организации проигрывания в статье WebRTC проигрывание.

Полная OpenAPI спецификация: Streaming API.

SHOUTcast

Flussonic Media Server умеет отдавать SHOUTcast или ICEcast радиопоток.

Поток доступен по адресу: http://FLUSSONIC-IP/STREAMNAME/shoutcast

The complete OpenAPI specification: Streaming API.

SRT

Flussonic поддерживает проигрывание SRT-потоков.

В общем случае адрес для проигрывания SRT-потока выглядит так:

srt://FLUSSONIC-IP:SRT_PORT?streamid=#!::r=STREAM_NAME,m=request

Подробнее о протоколе SRT, streamid и других поддерживаемых параметрах см. Использование протокола SRT.

Варианты URL для проигрывания SRT описаны на странице Воспроизведение SRT.

Выбор дорожек для проигрывания

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

Для этого укажите номера дорожек, добавив параметр ?filter.tracks=[aN|vN|tN|lN]+, за которым следует один или несколько номеров дорожек без пробела, в конце URL потока. Ниже указаны возможные значения:

aN — N-ая аудиодорожка,
vN — N-ая видеоодорожка,
tN — N-ая дорожка с WebVTT субтитрами,
lN — N-ая дорожка с DVB-субтитрами или телетекстом.

По умолчанию Flussonic выбирает первую аудио- и видеодорожку (a1v1). Если указать больше двух дорожек или указать дорожку в неверном формате, то используется значение по умолчанию (a1v1).

Примеры:

rtsp://FLUSSONIC-IP/STREAMNAME?filter.tracks=a2v1 — вторая аудиодорожка и первая видеодорожка для RTSP-потока.
http://FLUSSONIC-IP/STREAM_NAME/index.m3u8?filter.tracks=v2 — вторая видеодорожка для HLS-плейлиста.
http://FLUSSONIC-IP/STREAMNAME.isml/manifest?filter.tracks=v1t1t2t3 — первая видеодорожка и три дорожки с субтитрами для MSS-манифеста.

Запрет использования протоколов

По умолчанию разрешено проигрывание по всем протоколам, но вы можете запретить определенные протоколы (Except) или разрешить только определенные протоколы (Only) с помощью переключателя рядом со ссылками для проигрывания на вкладке Output. Эта функция полезна не только для обеспечения безопасности, но и для снижения нагрузки на сервер, т.к. упаковка во все доступные протоколы может потреблять много ресурсов.

Эти настройки можно задать и через файл конфигурации. Например, для потока channel_01 можно разрешить проигрывание по всем протоколам, кроме MPEG-TS и HLS (соответствует переключателю в положении Except).

stream channel_01 {
  protocols -mpegts -hls;
}

Для потока channel_02 разрешить только проигрывание по DASH и запросы API, при этом запретив проигрывание по всем остальным протоколам (соответствует переключателю в положении Only):

stream channel_02 {
  protocols dash api;
}

Получение данных о проигрываемом потоке

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

Адрес для получения технической информации о проигрываемом потоке:

http://FLUSSONIC-IP/STREAM_NAME/media_info.json

Адрес для получения информации о статусе записи архива DVR потока:

http://FLUSSONIC-IP/STREAM_NAME/recording_status.json

Плеер предпросмотра во Flussonic UI

Вы можете проиграть поток прямо во Flussonic UI с помощью плеера предпросмотра. Этот плеер позволяет проигрывать потоки по протоколу HLS, MSE-LD или DASH. Кроме того, в нем можно проиграть архив DVR, если DVR включен для потока. Плеер предпросмотра использует специальную страницу embed.html (подробнее см. Вставка видео на сайт) с соответствующими параметрами.

Чтобы открыть плеер предпросмотра, перейдите в раздел Media > Streams и нажмите кнопку Play рядом с нужным потоком.

Кнопка плеера предпросмотра

В открывшемся окне выберите нужную вкладку и начните проигрывание. Доступны следующие вкладки:

HLS — для проигрывания по HLS. Плеер будет использовать страницу embed.html.
MSE — для проигрывания по HTML (MSE-LD) с низкой задержкой. Плеер будет использовать страницу embed.html?realtime=true.
DASH — для проигрывания по DASH. Плеер будет использовать страницу embed.html?proto=dash.
DVR — для проигрывания архива DVR (если DVR включен для потока). Плеер будет использовать страницу embed.html?dvr=true. Подробнее о настройках DVR плеера читайте в главе Просмотр записей архива из административного веб-интерфейса.

Внизу страницы плеера предпросмотра отображается HTML код для вставки соответствующего плеера на веб-страницу.

Чтобы закрыть окно плеера предпросмотра, нажмите Esc.