Versions Compared

Key

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

...

Section


Column
width35%


Panel
borderColor#CCCCCC
bgColor#FFFFFF
titleBGColor#F0F0F0
borderStylesolid
titleНа странице:
Table of Contents



Column



Note
titleВнимание!
  • Получение звука возможно только с 64-битного Сервера.
  • Передача звука в формате MJPEG невозможна.

Общие сведения

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 – h – значение высоты кадра. 

Infonote
Примечание
titleВнимание!

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

Если значения параметров 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
-
  •  − исходная частота кадров (по умолчанию).
authTokenНет

Начиная с версии Axxon Next 4.6.3

Подключение через AxxonNet.
Например, https://axxonnet.com/arpserver/25455_0/webclient/live/media/SERVER/DeviceIpint.1/SourceEndpoint.video:0:1?authToken=...

auth_tokenНет

Начиная с версии Axxon Next 4.6.3

Авторизация при подключении к Серверу напрямую и авторизация по токену.
Например, http://127.0.0.1:80/live/media/SERVER/DeviceIpint.1/SourceEndpoint.video:0:0?format=mp4&auth_token=...

Пример запроса:

GET http://127.0.0.1:80/live/media/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=640&h=480&enable_token_auth=1&valid_token_hours=1

...

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


Note
titleВнимание!

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

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

...

Пример ответа:

Code Block
{
    "http": {
        "description": "RTP/RTSP/HTTP/TCP",
        "path": "hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0",
        "port": "8554"
    },
    "rtsp": {
        "description": "RTP/UDP or RTP/RTSP/TCP",
        "path": "hosts/Server1/DeviceIpint.23/SourceEndpoint.video:0:0",
        "port": "554"
    }
}

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

...