/exportarchive : Получение фрагмента видео из архива в формате MP4🔗
GET /exportarchive : Экспортировать фрагменты архива в виде файлов в формате MP4🔗
Доступно во всех типах лицензий.
Важно
Во всех примерах указан локальный хост (localhost). При отправке реальных запросов замените его на адрес и порт сервера, на который отправляете запрос.
Помимо получения потокового вещания видео- и аудиоданных, сервер Macroscop также предоставляет возможность экспортировать фрагменты архива в виде файлов в формате MP4. Для этого используются запросы к ресурсу exportarchive.
Примечание
Функция поддерживается только для камер, архив которых записывается в форматах H.264, H.265 и MJPEG.
Пример запроса🔗
GET http://localhost:8080/exportarchive?login=root&password=&channelid=706c4691-3d90-41e3-8789-76eb9810648f&fromtime=01.01.2023%2000:00:00&totime=01.01.2023%2000:30:00&sound=on&usetimestamps=true
В ответ на такой запрос сервер подготовит файл в формате MP4, содержащий фрагмент архива с аудиодорожкой и временными метками, записанный 01 января 2023 года в период с 00:00:00 до 00:30:00. Скачивание файла начнётся автоматически, если соединение с сервером не будет прервано закрытием приложения.
Предупреждение
Запрос имеет ряд технических ограничений, которые необходимо учитывать при использовании:
Запросы на экспорт фрагмента архива при получении добавляются в очередь сервера на выполнение. Максимальный размер очереди – 10 запросов.
Максимальное количество одновременно обрабатываемых запросов – 5. Таким образом, при полной загрузке очереди обрабатываться будут только 5 запросов, поступившие первыми, пока остальные 5 будут находиться в режиме ожидания.
Все запросы сверх максимального размера очереди будут отброшены с кодом сообщения 500.
Максимальная продолжительность экспортируемого фрагмента – 1 час.
Дополнительные параметры запроса🔗
Параметр |
Значение по умолчанию |
Описание |
|---|---|---|
channelid |
— |
Уникальный идентификатор канала. Может быть получен при выполнении запроса Получение конфигурации системы. Обязательный параметр |
fromtime |
— |
Дата и время начала периода, за который запрашивается информация. Время должно указываться в часовом поясе UTC в формате DD.MM.YYYY hh:mm:ss. Обязательный параметр |
totime |
— |
Дата и время конца периода, за который запрашивается информация. Время должно указываться в часовом поясе UTC в формате DD.MM.YYYY hh:mm:ss. Обязательный параметр |
sound |
off |
Параметр для добавления аудиоданных из архива в экспортируемый файл. Доступно только для серверов под управлением Windows. Возможные значения: on – экспортировать звук, off – не экспортировать. Опциональный параметр |
usetimestamps |
false |
Параметр, позволяющий накладывать поверх видео временную метку с указанием времени записи отображаемого кадра. Возможные значения: true – накладывать временную метку, false – не накладывать. Опциональный параметр |
fromDevice |
false |
Параметр запроса на экспорт архива, хранящегося непосредственно на камере или видеорегистраторе, если они поддерживают функцию доступа к архиву. Возможные значения: true – экспортировать архив с устройства, false – экспортировать архив с сервера. Опциональный параметр |
addhvc1tagforhevc |
false |
Параметр для добавления заголовка, позволяющего воспроизведение экспортированного фрагмента формата H.265 на устройствах Apple. Незначительно увеличивает продолжительность экспорта. Возможные значения: true – добавить заголовок, false – не добавлять. Опциональный параметр |
Примечание
Разделение даты и времени осуществляется кодом («%20»).