Перейти в хранилище документации
Обратиться в техническую поддержку
POST http://IP-адрес:порт/префикс/export/archive/{VIDEOSOURCEID}/{BEGINTIME}/{ENDTIME} − экспорт из архива.
POST http://IP-адрес:порт/префикс/export/live/{VIDEOSOURCEID}/{BEGINTIME}/{ENDTIME} − экспорт живого потока.
{VIDEOSOURCEID} − трехкомпонентный идентификатор endpoint-а источника (см. Получение списка устройств телеметрии для источника видео). Например, "SERVER1/DeviceIpint.3/SourceEndpoint.video:0:0".
Примечание
BEGINTIME и ENDTIME задают время в формате YYYYMMDDTHHMMSS в часовом поясе UTC+0. Если BEGINTIME больше ENDTIME, то значения поменяются местами. Для экспорта кадра BEGINTIME должно быть равно ENDTIME.
Синтаксис ENDTIME и BEGINTIME описан в разделе Получение содержания архивов.
Параметр | Обязательный | Описание |
---|---|---|
waittimeout | Нет | Таймаут ожидания поступления кадра в миллисекундах. Значение по умолчанию − 10000. Если значение параметра меньше, чем интервал опорных кадров, экспорт выполнен не будет. Рекомендуется устанавливать значение не меньше 30000 |
archive | Нет | Имя архива в формате "hosts/SERVER1/MultimediaStorage.AliceBlue/MultimediaStorage" (см. Получение содержания архивов). Если значение не задано, для экспорта будет использоваться архив по умолчанию |
Пример запроса:
POST http://127.0.0.1:80/export/archive/Server1/DeviceIpint.1/SourceEndpoint.video:0:0/20200415T085456.908/20200415T085501.908?waittimeout=30000
Пример тела запроса:
{ "format": "mp4", "vc": 4, "comment": "сomment" }
Поддерживаемые параметры передаваемые в теле начального POST запроса:
Параметр | Формат | Описание | Пример |
---|---|---|---|
format | Текстовое значение | Обязательный параметр. Доступные значения mp4, mkv, avi, exe, jpg, pdf. Задает формат выходного контейнера экспорта | |
maxfilesize | Числовое значение | Максимальный размер файла экспорта в байтах. При достижении этого размера будет создаваться новый файл. Результатом экспорта будет коллекция файлов. Значение по умолчанию − 0 (на выходе единственный файл) | "maxfilesize": 1e+6 "maxfilesize": 1000000 |
vc, ac | Числовое значение | Уровень качества сжатия для видео и аудио соответственно. Допустимые значения от 0 до 6 (6 − наихудшее). Значение по умолчанию − 0 | |
freq | Числовое значение | Частота кадров выходного потока. Значение по умолчанию − 0. Допустимые значения:
| |
tsformat | Текстовое значение | Шаблон формата временной метки. Можно генерировать любую строку на основании http://www.boost.org/doc/libs/1_55_0/doc/html/date_time/date_time_io.html. Значение по умолчанию: %Y-%b-%d %H:%M:%S. Внимание! Сервер не проверяет формат введенной строки | "tsformat": "%B %Y", |
croparea | Область | Область кадра для экспорта. Значение по умолчанию [[0, 0], [1,1]] − весь кадр Изображение для примера: | "croparea": [ [ 0.3, 0.3 ], [ 0.8, 0.8 ] ] |
maskspace | Область | Область маскировки кадра, задается в координатах. По умолчанию кадр не маскируется. Построение области происходит минимум по 3 узловым точкам + 1 замыкающая (совпадает с одной из точек). Начало координат – левый верхний угол. Допускается задание нескольких полигонов. Изображение для примера: | "maskspace": [ [ [ 0.2, 0.2 ], [ 0.3, 0.7 ], [ 0.5, 0.5 ], [ 0.2, 0.2 ] ] ] |
color | Текстовое значение | Цвет текста для комментария и временной метки. Задается в Web-формате #FFFFFF | "color": "#e31e1e", |
comment | Текстовое значение | Комментарий | |
Параметры актуальные только для экспорта в PDF: | |||
snapshotplace | Область | Положение кадра на странице | |
commentplace | Область | Положение комментария на странице | |
tsplace | Область | Положение временной метки на странице | |
layout | Числовое значение | Ориентация страницы. Допустимые значения − 0 (портретная), 1 (альбомная) |
Пример ответа:
HTTP/1.1 202 Accepted Connection: Close Location: /export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3 Cache-Control: no-cache
Возможные ошибки:
Код ошибки | Описание |
---|---|
400 | Неправильно сформированный запрос |
500 | Внутренняя ошибка Сервера |
GET http://IP-адрес:порт/префикс/export/{id}/status
id − значение из поля Location (в данном случае 3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3).
Пример запроса:
GET http://127.0.0.1:80/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3/status
Пример ответа:
{ "id": "38e3e286-c07c-490f-a452-e4b541b958c4", "state": 2, "progress": 1.000000000e+00, "error": "", "files": [ "Server1_DeviceIpint.10[20190903T050000-20190903T050100].mp4" ], "filesFriendly": [ "Server1_10.RHCP[20190903T050000-20190903T050100].mp4" ] }
Параметр | Описание |
---|---|
state | Текущее состояние экспорта. Возможные значения: |
progress | Прогресс сессии экспорта в диапазоне от 0 до 1 |
error | Описание ошибки, если таковая присутствует |
files | Список файлов, созданных в результате экспорта |
GET http://IP-адрес:порт/префикс/export/{id}/file
id − значение из поля Location (в данном случае 3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3).
Параметр | Обязательный | Описание |
---|---|---|
name | Да | Имя файла из поля files |
Пример запроса:
GET http://127.0.0.1:80/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3/file?name=Server1_DeviceIpint.10[20190903T050000-20190903T050100].mp4
Примечание
На Сервере экспортированный файл сохраняется в папку C:\ProgramData\ITV\IntellectX\Export\{ID}.
Данный запрос удаляет сформированный файл на Сервере.
DELETE http://IP-адрес:порт/префикс/export/{id}
id − значение из поля Location (в данном случае 3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3).
Пример запроса:
DELETE http://127.0.0.1:80/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3
Файлы из папки для экспорта могут автоматически удаляться: