Flussonic Media Server documentation

Содержание

Вставка видео на сайт (embed.html)

У сервера Flussonic Media Server есть специальная страница — embed.html, которая предназначена для вставки видео на сайт и просмотра видео через браузер. Технически embed.html — тот же плеер, что используется в административном интерфейсе Flussonic Media Server.

Страница с плеером доступна по ссылке:

http://HOSTNAME/STREAMNAME/embed.html

Страница автоматически определяет браузер и выбирает поддерживаемый видео-протокол. Для большинства устройств на сегодня — HLS (используется плеером по умолчанию).

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

Вызывается плеер двумя способами:

  • При открытии embed.html напрямую (указав ссылку в адресной строке) видео развернется на размер окна браузера и автоматически начнет воспроизведение.

Вставка видео на сайт

  • Также embed.html удобен для вставки видео на сайт как части веб-страницы. HTML-код для вставки доступен на странице Overview в свойствах каждого потока в административном интерфейсе.

    Пример:

    html
<iframe style="width:640px; height:480px;" allowfullscreen src="http://hostname/streamname/embed.html"></iframe>

    Код вставляет на страницу окно с плеером фиксированного размера — 640x480 пикселей. Воспроизведение начинается автоматически.

Дополнительные параметры

Для большинства задач не требуется дополнительная настройка, но embed.html имеет параметры, которые можно задать с помощью URL. Дополнительные параметры задаются в адресной строке:

http://HOSTNAME/STREAMNAME/embed.html?autoplay=false&play_duration=600

  • autoplay — автозапуск воспроизведения при открытии страницы. По умолчанию значение true. Чтобы выключить автозапуск, установите false. Показывает скриншоты перед просмотром. Проигрывание со звуком определяется политикой браузера.
  • mute - управление звуком, доступные значения true или false.
  • play_duration — через сколько секунд остановить воспроизведение видео. По умолчанию выключен. Полезен для экономии трафика.

  • realtime (realtime=true) — включает вещание через протоколы с низкой задержкой. Протокол автоматически выбирается между MSE-LD, RTMP или WebRTC. По умолчанию выключен, установите значение true для воспроизведения видео с низкой задержкой.

    Внимание! Вещание с низкой задержкой сильнее загружает сеть и процессор, не используйте его без необходимости.

  • dvr — открывает архивный плеер. Для доступа к архиву укажите значение true. Подробности ниже.

  • ago — разрешает пользователям перематывать видео назад. Значение задается в секундах. По умолчанию выключен. Удобнее DVR плеера для просмотра видео за последние несколько минут или часов. Идеально подходит для организации паузы и перемотки живого видео на сайте. Например, час перемотки задается так: embed.html?ago=3600.

  • from — Unix timestamp начала записи. При указании этого параметра плеер перейдет к воспроизведению timeshift-abs плейлиста с указанного времени.

  • to — Unix timestamp окончания записи. Используется только в связке с from. Плеер откроет HLS VOD, и будет доступна перемотка в рамках указанного интервала.

  • liveSyncDurationCount — задает количество буферизованных сегментов для воспроизведения потоков HLS. Помогает предотвратить задержки из-за нестабильности сети передачи данных. Не используйте вместе с realtime=true. Пример: embed.html?liveSyncDurationCount=4

Пример доступа к видео из архива

Например, ссылка для доступа к записи телепередачи будет содержать параметры from и to:

http://HOSTNAME/STREAMNAME/embed.html?from=1511300552&to=1511300852

Такие ссылки лучше формировать с помощью серверных скриптов на основе программы передач (EPG) для организации CatchUp сервиса.

DVR плеер

Чтобы просмотреть архив записи для потока, откройте DVR плеер при помощи ссылки:

http://HOSTNAME/STREAMNAME/embed.html?dvr=true

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

DVR плеер

Для DVR плеера доступны все дополнительные параметры адреса, кроме ago.

Интерфейс плеера позволяет автоматически генерировать ссылки формата embed.html?dvr=true&from=1511300552 без использования дополнительных утилит. Просто откройте нужный момент в архиве и нажмите на часы, чтобы открыть ссылку с параметром from.