Versions Compared

Old Version 1

changes.mady.by.user Vadim Belyakov

Saved on

compared with

New Version Current

changes.mady.by.user Yulia Morozova

Saved on

Key

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

...

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

Tip

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


Tip

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


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

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

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

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

w

h

Нет

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

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

Info
titleПримечание

Если значения параметров 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{BEGINTIME} - получение времени регистрации кадров, находящихся в архиве. Семантика параметров описана в разделе Покадровый просмотр архива.  

Info
titleПримечание

Синтаксис ENDTIME и BEGINTIME описан в разделе Получение содержания архивов


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

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

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

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


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

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

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

Code Block
{

...


  "frames":

...

 [
    "

...

20200525T113229.

...

649000",
    "

...

20200525T113229.

...

100000",
    "

...

20200525T113228.

...

588000"
  ],

...


  "more":

...

 true
}


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

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

Info
titleПримечание

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


more

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

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