Versions Compared

Key

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

...

Expand
titleРаскрыть список
  • format (строка) - обязательный параметр, доступные значения mp4mkv, avi, exe, jpg, pdf. Задает формат выходного контейнера экспорта. 
  • maxfilesize (число) - максимальный размер файла экспорта в байтах. При достижении этого размера будет создаваться новый файл. Результатом экспорта будет коллекция файлов. Значение по умолчанию - 0 (на выходе единственный файл).
  • vcac (число) - уровень качества сжатия для видео и аудио соответственно. Допустимые значения от 0 до 6 (6 - наихудшее). Тонкий нюанс - при указании 0 в значении параметра будет оставлен исходный уровень качества (скорее всего недоработка исходного API). Значение по умолчанию - 0.
  • freq (число) - частота кадров выходного потока. Значение по умолчанию - 0. Допустимые значения:
    1. 0 - оригинальная
    2. 1 - половина оригинальной
    3. 2 - четверть
    4. 3 - осьмушка
  • waittimeout - таймаут ожидания поступления кадра в миллисекундах. Значение по умолчанию - 10. Если значение параметра меньше, чем интервал опорных кадров, экспорт выполнен не будет.
  • tsformat (строка) - шаблон формата временной метки. Можно генерировать любую строку на основании http://www.boost.org/doc/libs/1_55_0/doc/html/date_time/date_time_io.html. Значение по умолчанию: %Y-%b-%d %H:%M:%S. 

    Note
    titleВнимание!

    Сервер не проверяет формат введенной строки.


  • croparea (area) - область кадра для экспорта (Значение по умолчанию 0,0!0,0 - весь кадр).
  • maskspace (mask) - область маскировки кадра. По умолчанию кадр не маскируется.
  • color (строка) - цвет текста для комментария и временной метки. Задается в Web-формате - #FFFFFF.
  • comment (строка) - комментарий

Параметры, имеющие смысл только для формата PDF.

  1. snapshotplace (area) - положение кадра на странице
  2. commentplace (area) - положение комментария на странице
  3. tsplace (area) - положение временной метки на странице
  4. layout (число) - ориентация страницы. Допустимые значения - 0 (портретная), 1 (альбомная).

Пример тела запроса:

Code Block
{
    "format": "mp4",
    "vc": 4,
    "comment": "сomment"
}

Результатом запроса будет либо возврат ошибки, либо ответ следующего вида:

...

где id - значение из поля Location (в данном случае 3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3).

Пример запроса:

http://192.168.1.65:8001/export/3dc15b75-6463-4eb1-ab2d-0eb0a8f54bd3/status

Пример ответа:

Code Block
{
  "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"
  ]
}

...

где 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

...