Перейти в хранилище документации
Обратиться в техническую поддержку
Документация для версии Axxon Next 4.4.6. Документация на другие версии также доступна.
Предыдущая страница Следующая страница
На странице:
Запуск экспорта
Экспорт инициируется с помощью одного из следующих POST запросов:
http://IP-адрес:порт/префикс/export/archive/SERVER1/VIDEOSOURCEID/BEGINTIME/ENDTIME - экспорт из архива
http://IP-адрес:порт/префикс/export/live/SERVER1/VIDEOSOURCEID/BEGINTIME/ENDTIME - экспорт живого потока
где
- BEGINTIME и ENDTIME задают время в формате YYYYMMDDTHHMMSS. Если BEGINTIME больше ENDTIME, то значения поменяются местами. Для экспорта кадра BEGINTIME должно быть равно ENDTIME.
- waittimeout - таймаут ожидания поступления кадра в миллисекундах. Значение по умолчанию - 10. Если значение параметра меньше, чем интервал опорных кадров, экспорт выполнен не будет.
- archive - имя архива в формате "hosts/SERVER1/MultimediaStorage.AliceBlue/MultimediaStorage" (см. Получение содержания архивов).
Поддерживаемые параметры передаваемые в теле начального POST запроса:
| Параметр | Формат | Описание | Пример |
|---|---|---|---|
| format | Текстовое значение | Обязательный параметр. Доступные значения mp4, mkv, avi, exe, jpg, pdf. Задает формат выходного контейнера экспорта. | |
maxfilesize | Числовое значение | Максимальный размер файла экспорта в байтах. При достижении этого размера будет создаваться новый файл. Результатом экспорта будет коллекция файлов. Значение по умолчанию - 0 (на выходе единственный файл). | "maxfilesize": 1e+6"maxfilesize": 1000000 |
| vc, ac | Числовое значение | Уровень качества сжатия для видео и аудио соответственно. Допустимые значения от 0 до 6 (6 - наихудшее). Тонкий нюанс - при указании 0 в значении параметра будет оставлен исходный уровень качества (скорее всего недоработка исходного API). Значение по умолчанию - 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 (альбомная). | |
Пример тела запроса:
{
"format": "mp4",
"vc": 4,
"comment": "сomment"
}
Результатом запроса будет либо возврат ошибки, либо ответ следующего вида:
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).
Пример запроса:
http://192.168.1.65:8001/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 определяет текущее состояние экспорта. Возможные значения:
1 - экспорт выполняется
2 - экспорт завершен
3 - ошибка экспорта
4 - недостаточно места для выполнения операции - progress - прогресс сессии экспорта в диапазоне от 0 до 1.
- error - описание ошибки, если таковая присутствует.
- files - список файлов, созданных в результате экспорта.
Завершение экспорта
DELETE http://IP-адрес:порт/префикс/export/id
где id - значение из поля Location.
Пример запроса:
http://192.168.1.65:8001/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3
Скачивание файла
GET http://IP-адрес:порт/префикс/export/id/file?name=SERVER_DeviceIpint.1[20160527T132900-20160527T133000].mkv
где
- id - значение из поля Location
- file?name - имя файла из поля files
Overview
Content Tools