Покадровый просмотр архива

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

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

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

Параметры:

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

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

  Примечание

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

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

• параметры для обрезания картинки (доступны начиная с Axxon Nexy 4.4.1.9115):
  • crop_x - отступ от левого верхнего угла по горизонтали. Значения от 0 до 1. По умолчанию 0.
  • crop_y - отступ от левого верхнего угла по вертикали. Значения от 0 до 1. По умолчанию 0.
  • crop_width - доля первоначальной ширины картинки. Значения от 0 до 1. По умолчанию 1.
  • crop_height - доля первоначальной длины картинки. Значения от 0 до 1. По умолчанию 1.

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

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

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

В возвращаемом ответе (json объекте) массив, содержащий моменты времени, соответствующие кадрам, помещается  в свойство с именем frames.

В возвращаемом ответе (json объекте) отдельное свойство more - булевское значение, сигнализирующее о том, был ли выбран указанный в запросе отрезок времени полностью (false), или остались кадры, timestamp-ы которых не были возвращены из-за достижения предельного числа возвращаемых значений.

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

GET http://IP-адрес:порт/префикс/archive/contents/frames/SERVER1/DeviceIpint.2/SourceEndpoint.video:0:0/20101230T103943.000/20101230T103952.000?limit=3

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

{
"frames" :
[ "20101230T103951.800", "20101230T103951.760", "20101230T103951.720" ],
"more" : false
}