GET http://IP-Address:port/prefix/live/media/snapshot/{VIDEOSOURCEID}

{VIDEOSOURCEID} – three-component source endpoint ID (see Get list of cameras and information about them). For instance, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".

ParameterRequiredDescription

w

h

No

w – frame width, h – frame height

  • 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.

crop_x

crop_y

crop_width

crop_height


No
  • crop_x – horizontal indent from the upper left corner. Possible values are 0 to 1. The default is 0;
  • crop_y – vertical indent from the upper left corner. Possible values are 0 to 1. The default is 0;
  • crop_width – the ratio of the original image width. Possible values are 0 to 1. The default is 1;
  • crop_height – the ratio of the original image height. Possible values are 0 to 1. The default is 1

By default, the snapshot update period is 30 seconds. To change this value, create the NGP_SNAPSHOT_TIMEOUT system variable and set the required value in milliseconds (see Appendix 9. Creating system variable).

Sample request: