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}

...

ПараметрОбязательныйОписание
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 − включить авторизацию по токену = 1.
  • valid_token_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

...

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

...