Versions Compared

Key

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


Section


Column
width35%50%


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



Column


...

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

Tip

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


Tip

{STARTTIME} - время в формате ISO.  Время Время задается в часовом поясе UTC+0.

...

ПараметрОбязательныйОписание
speed НетСкорость воспроизведения, может принимать отрицательные значения.
formatНет

Параметр может принимать значения "mjpeg", "rtsp", "mp4", "hls". В случае, если  формат не указан, указан "rtsp" или не распознан, сервер выбирает нативный формат (чтобы избежать перекодирования). Если при этом нативный формат не поддерживается клиентом, сервер выбирает WebM.

В случае, если не задано значение ни одного из двух вышеперечисленных параметров, скорость считается равной 0, а формат - JPEG, и запрос интерпретируется как запрос на покадровый просмотр архива.

idНетУникальный идентификатор архивного потока. Необходим для получения информации о потоке или для управления им.

w

h

Нет

w – ширина кадра, h – высота кадра.

frНет

Частота кадров

Note
titleВнимание!

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

archiveНетИмя архива из запроса получения списка архивов (см. Получение содержания архивов). Если не задано, используется архив по умолчанию.


enable_token_auth Нет

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

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

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

valid_token_hoursНет

...

Note
titleВнимание!

Архивное видео по протоколу HLS будет доступно в течение 30 секунд после ответа.

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

Code Block
{
    "http": {
        "description": "RTP/RTSP/HTTP/TCP",
        "path": "archive/hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20110608T060141.375000?speed=1&id=a865fcea-cfe6-44a1-bf7b-9e6a94c44a53&exp=20200525T171234&nonce=1&hmac=wVlyHvZkB2TnqftTfYugtwmZ7g8=",
        "port": "8554"
    },
    "httpproxy": {
        "description": "RTP/RTSP/HTTP/TCP Current Http Port",
        "path": "rtspproxy/archive/hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20110608T060141.375000?speed=1&id=a865fcea-cfe6-44a1-bf7b-9e6a94c44a53&exp=20200525T171234&nonce=2&hmac=BVICx8NVV4yijwqc0Q6Xzji41Rg="
    },
    "rtsp": {
        "description": "RTP/UDP or RTP/RTSP/TCP",
        "path": "archive/hosts/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20110608T060141.375000?speed=1&id=a865fcea-cfe6-44a1-bf7b-9e6a94c44a53&exp=20200525T171234&nonce=1&hmac=wVlyHvZkB2TnqftTfYugtwmZ7g8=",
        "port": "554"
    }
}

...

В качестве id можно использовать и другие значения, состоящие из букв и цифр латинского алфавита. Рекомендуется для получения уникальных значений использовать функцию UUID (см.   Получение уникального идентификатора).

Архивное видео по протоколу RTSP

GET rtsp://логин:пароль@IP-адрес:554/archive/hosts/SERVER1/DeviceIpint.0/SourceEndpoint.video:0:0/20160907T050548.723000Z?speed=1

speed - скорость воспроизведения, обязательный параметр.

Примеры:

  • speed=1 - воспроизведение в прямом направлении с обычной скоростью;
  • speed=-1 - воспроизведение воспроизведение в обратном направлении с обычной скоростью;
  • speed=4 - воспроизведение воспроизведение в прямом направлении со скоростью 4х;
  • speed=-8 - воспроизведение в обратном направлении со скоростью 8х.

...