Versions Compared

Old Version 1

changes.mady.by.user Alina Luchkina

Saved on

compared with

New Version 2

changes.mady.by.user Darya Andryieuskaya

Saved on

Key

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

...

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

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

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

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

.

w

h

Нет

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

.

Info
titleПримечание
  • Если значения параметров h и w больше размеров оригинального кадра, кадр будет получен с оригинальными размерами.
  • Уменьшение ширины и высоты возможно только дискретно − в 2, 4, 8 и т. д. раз. Если указаны размеры, не соответствующие 1/2, 1/4 и т. д. размеров оригинального кадра, то кадр будет получен с размерами, кратными размерам оригинального кадра, наиболее близкими к указанным.
archiveНетИмя архива из запроса получения списка архивов (см. Получение содержания архивов). Если не задано, используется архив по умолчанию
.

left

top

right

bottom

Нетleft −

crop_x

crop_y

crop_width

crop_height

Нет
  • crop_x – отступ от левого верхнего угла по горизонтали. Значения от 0 до 1. По умолчанию 0
.
  • ;
  • crop_y –
top −
  • отступ от левого верхнего угла по вертикали. Значения от 0 до 1. По умолчанию 0
.right −
  • ;
  • crop_width – доля первоначальной ширины картинки. Значения от 0 до 1. По умолчанию 1
.bottom −
  • ;
  • crop_height – доля первоначальной длины картинки. Значения от 0 до 1. По умолчанию 1
.

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

Code Block
GET http://127.0.0.1:80/archive/media/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0/20210910T092100

Результат запроса:

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

Code Block
GET http://127.0.0.1:80/archive/media/SERVER1/DeviceIpint.1/SourceEndpoint.video:0:0/20210910T092200?archive=hosts/SERVER1/MultimediaStorage.AntiqueWhite/MultimediaStorage

Результат запроса:

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

...

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

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

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

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

.

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

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

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

Code Block
{
 "frames": [
  "20200525T113229.649000",
  "20200525T113229.100000",
  "20200525T113228.588000"
 ],
 "more": true
}
ПараметрОписание параметра
frames

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

.

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

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

more
  • true – Сервер вернул все кадры из заданного диапазона
.
  • ;
  • false – Сервер вернул не все кадры из-за превышения лимита (параметр limit)
.