Versions Compared

Key

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

...

Get frame by timestamp

GET http://IP-addressAddress:port/prefix/archive/media/{VIDEOSOURCEID}/{STARTTIME} – gets frame by its STARTTIME. Frame is returned in JPEG format.

...

ParameterRequiredDescription
thresholdNo

If there is no frame at a given time, then the first frame from the [STARTTIME; STARTTIME + threshold] range is returned, where threshold is specified in milliseconds.

If there is no frame in the specified range, then there will be a 404 Not Found error in the response.

w

h

No

w – frame width, h – frame height.

Info
titleNote

If h and w values are more than size of original frame, the frame will be received with original size.

Zooming out of width and height is available only discretely − in 2, 4, 8 times, etc. If specified sizes are not corresponding to 1/2, 1/4 etc. of original frame size, the frame will be received with size divisible by the original frame size close to specified values.


left

top

right

bottom

No

left – horizontal indent from the upper left corner. Possible values are 0 to 1. The default is 0.

top – vertical indent from the upper left corner. Possible values are 0 to 1. The default is 0.

right – the ratio of the original image width. Possible values are 0 to 1. The default is 1.

bottom – the ratio of the original image hight. Possible values are 0 to 1. The default is 1.

Sample request: 1:

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

Query result:
Image Modified

Sample request: 2:

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

Query result:
Image Modified

Get frame registration time

GET http://IP-addressAddress:port/prefix/archive/contents/frames/{VIDEOSOURCEID}/{ENDTIME}/{BEGINTIME} – getting the time of frames registration in the archive.

...