Перейти в хранилище документации
Обратиться в техническую поддержку
GET http://IP-адрес:порт/префикс/live/media/snapshot/{VIDEOSOURCEID}
{VIDEOSOURCEID} − трехкомпонентный идентификатор endpoint-а источника (см. Получение списка устройств телеметрии для источника видео). Например, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".
Параметр | Обязательный | Описание |
---|---|---|
w h | Нет | w – значение ширины кадра. h – значение высоты кадра. Примечание Если значения параметров h и w больше размеров оригинального кадра, кадр будет получен с оригинальными размерами. Уменьшение ширины и высоты возможно только дискретно – в 2, 4, 8 и т. д. раз. Если указаны размеры, не соответствующие 1/2, 1/4 и т. д. размеров оригинального кадра, то кадр будет получен с размерами, кратными размерам оригинального кадра, наиболее близкими к указанным. |
crop_x crop_y crop_width crop_height | Нет | crop_x – отступ от левого верхнего угла по горизонтали. Значения от 0 до 1. По умолчанию 0. crop_y – отступ от левого верхнего угла по вертикали. Значения от 0 до 1. По умолчанию 0. crop_width – доля первоначальной ширины картинки. Значения от 0 до 1. По умолчанию 1. crop_height – доля первоначальной длины картинки. Значения от 0 до 1. По умолчанию 1. |
Примечание
По умолчанию период обновления кадра 30 секунд. Для его изменения необходимо создать системную переменную NGP_SNAPSHOT_TIMEOUT и задать необходимое значение в миллисекундах (см. Приложение 9. Создание системных переменных).
Пример запроса:
Получение снимка в оригинальном разрешении: GET http://IP-адрес:порт/префикс/live/media/snapshot/Server1/DeviceIpint.23/SourceEndpoint.video:0:0
Получение снимка в разрешении 640*480: GET http://IP-адрес:порт/префикс/live/media/snapshot/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=640&h=480
Получение правой нижней доли снимка: GET http://IP-адрес:порт/префикс/live/media/snapshot/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?crop_x=0.5&crop_y=0.5&crop_width=0.5&crop_height=0.5
Получение правой нижней доли снимка в разрешении 640*480: GET http://IP-адрес:порт/префикс/live/media/snapshot/Server1/DeviceIpint.23/SourceEndpoint.video:0:0?w=640&h=480&crop_x=0.5&crop_y=0.5&crop_width=0.5&crop_height=0.5