Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

GET http://IP-адрес:порт/префикс/live/media/{VIDEOSOURCEID}

Tip

{VIDEOSOURCEID} - трехкомпонентный идентификатор endpoint-а источника (см. Получение списка видеокамер и информации о них). Например, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".

...

ПараметрОбязательныйОписание
formatНет

Возможные значения: "hls", "mp4".

По протоколу HLS видео можно получать в исходном формате без рекомпрессии. При этом протокол HLS поддерживает только формат H.264

Плеер "mp4" позволяет получить исходное видеоизображение в форматах H.264 и H.265. Во всех других случаях сервер производит рекомпрессию в формат MJPEG.

Note
titleВнимание!

Если запрашивается видео в формате, отличном от исходного, то будет произведена рекомпрессия, что приведет к увеличению загрузки Сервера.


w, hНет

w – значение ширины кадра; h – значение высоты кадра. 

Info
titleПримечание

Если значения параметров h и w больше размеров оригинального видео, видео будет получено с оригинальными размерами.

Уменьшение ширины и высоты возможно только дискретно - в 2, 4, 8 и т. д. раз. Если указаны размеры, не соответствующие 1/2, 1/4 и т. д. размеров оригинального видео, то видео будет получено с размерами, кратными размерам оригинального видео, наиболее близкими к указанным.


Note
titleВнимание!

Передача видео в формате mp4 осуществляется без масштабирования.


frНет

Значение частоты кадров.

Note
titleВнимание!

Данный параметр актуален только для видео в формате MJPEG.


enable_token_auth Нет

Получение авторизованных и подписанных ссылок на видеопотоки.

enable_token_auth - auth − включить авторизацию по токену токену =1.

valid_token_hours - время hours − время действительности подписи в часах. Максимальное значение - неделя  неделя. Значение по умолчанию 12 часов.

valid_token_hoursНет

key_frames

Нет

1 - воспроизведение только по ключевым кадрам;

0 -  − исходная частота кадров (по умолчанию).

...

ПараметрОписание параметра
keep_alive_secondsВремя в секундах, через которое будет продлеваться поток. 
keep_alive_url Cсылка для продления жизни потока.
stop_urlCсылка для остановки видеопотока.
stream_urlCсылка по - которой будет доступен список сегментов.


Note
titleВнимание!

Видео по протоколу HLS будет доступно через несколько секунд после ответас некоторой задержкой (около 20 секунд). Задержка связана с обобенностью протокола HLS, который формирует буфер из нескольких частей видео, передавая информацию по ссылке.

Для проигрывания видео по протоколу HLS необходимо использовать параметр stream_url из ответа следующим образом:

...

Запрос на получение видео:   GET rtsp://логин:пароль@IP-адрес:554/hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0

...