Получение кадра по моменту времени

GET http://IP-адрес:порт/префикс/archive/media/VIDEOSOURCEID/STARTTIME?threshold=N - получение кадра, соответствующего моменту времени STARTTIME. Кадр возвращается в формате JPEG.

ПараметрОбязательныйОписание
VIDEOSOURCEIDYesТрехкомпонентный идентификатор endpoint-а источника формата (см. Получение списка источников видео (камер)). Например,  "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".
STARTTIMEYes

Время в формате ISO.

Время задается в часовом поясе UTC+0


thresholdНет

Доступен начиная с Axxon Next 4.4.1.9245.

Если кадра в заданный момент времени в архиве нет, то берется первый кадр из диапазона [STARTTIME; STARTTIME + threshold], где threshold задается в миллисекундах.

Если кадра нет в заданном диапазоне, то в ответе будет ошибка 404 Not Found.

w

h

Нет

w – значение ширины кадра.

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

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

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


crop_x

crop_y

crop_width

crop_height

Нет

Доступны начиная с Axxon Next 4.4.1.9115.

crop_x - отступ от левого верхнего угла по горизонтали. Значения от 0 до 1. По умолчанию 0.

crop_y - отступ от левого верхнего угла по вертикали. Значения от 0 до 1. По умолчанию 0.

crop_width - доля первоначальной ширины картинки. Значения от 0 до 1. По умолчанию 1.

crop_height - доля первоначальной длины картинки. Значения от 0 до 1. По умолчанию 1.

Получение времени регистрации кадра

GET http://IP-адрес:порт/префикс/archive/contents/frames/VIDEOSOURCEID/ENDTIME/BEGINTIME?limit=COUNT - получение времени регистрации кадров, находящихся в архиве. Семантика параметров описана в разделе Покадровый просмотр архива.

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

Значение по умолчанию для параметра limit равно 250. Сервер не обязан следовать заданному клиентом значению limit и может по своему усмотрению вернуть меньшее количество результатов.


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

GET http://127.0.0.1:80/archive/contents/frames/SERVER1/DeviceIpint.2/SourceEndpoint.video:0:0/past/future?limit=3

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

{
  "frames": [
    "20200525T113229.649000",
    "20200525T113229.100000",
    "20200525T113228.588000"
  ],
  "more": true
}


ПараметрОписание параметра
frames

Массив, содержащий время хранящихся кадров.

Время возвращается в формате UTC.


more

true - Сервер вернул все кадры из заданного диапазона.

false - Сервер вернул не все кадры из-за превышения лимита (параметр limit).