Проигрывание
Проигрывание потоков
Flussonic Media Server позволяет проигрывать потоки по разным протоколам. Чтобы посмотреть список ссылок для проигрывания, щелкните имя потока на вкладке Media — Streams и перейдите на вкладку Output. Вы можете скопировать тот или иной URL в буфер обмена, нажав кнопку копирования в конце строки соответствующего URL-адреса.
Ниже приведено подробное описание URL-адресов, которые следует использовать в плеерах для воспроизведения видео по различным протоколам, со ссылками на разделы о настройке воспроизведения через каждый протокол. Проиграть потоки по некоторым протоколам можно также в плеере предпросмотра прямо во Flussonic UI.
Кроме того, вы можете управлять проигрыванием потоков с помощью Streaming API.
Запрет использования протоколов
По умолчанию разрешено проигрывание по всем протоколам, но вы можете запретить определенные протоколы (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;
}
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
RTSP
Поток доступен по адресу:
rtsp://FLUSSONIC-IP/STREAMNAME
Если у потока есть несколько аудио- и видеодорожек, то по умолчанию Flussonic выбирает первую дорожку (a1v1).
Можно указать, какие именно дорожки следует отдавать. Для этого укажите номера дорожек, добавив параметр filter.tracks
к URL потока.
Примеры:
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
— выбрать только видео.
Если указать больше двух дорожек или указать дорожку в неверном формате, то будет использоваться параметр по умолчанию (a1v1).
WebRTC
Поток по протоколу WebRTC WHEP доступен по адресу:
http://FLUSSONIC-IP/STREAM_NAME/whap
Подробнее о 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 имеет несколько режимов работы: Caller (Инициатор), Listener (Слушатель) и Rendezvous. В парадигме Flussonic проигрывание можно соотнести с режимом Listener, поскольку Flussonic находится в ожидании соединения и при удачном его установлении, начинает взаимодействие с Инициатором (Caller).
Настройка SRT-порта обычно производится для одного потока, т. е. один SRT-поток на один порт. Кроме того, Flussonic предоставляет Вам способ настроить один SRT-порт для нескольких потоков. Например, если вы используете протокол SRT для ретрансляции.
Подробнее о воспроизведении в SRT см. в главе Воспроизведение SRT.
Получение данных о проигрываемом потоке
Вы можете отправлять запросы 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.