MOBOTIX Online-Hilfe

HTTP-API

HTTP-API (Application Programming Interface/интерфейс прикладного программирования) - это интерфейс для соединения с камерой на основе программных средств, позволяющий интегрировать камеру в централизованную систему управления. Интерфейс состоит из двух сценариев CGI, которые Вы можете вызвать с помощью команд HTTP, используя параметры и значения. С помощью этих сценариев можно изменять настройки подменю меню Установка и осуществлять функции камеры.

Команда HTTP http://192.168.1.2/control/control позволит Вам изменить настройки Установочного меню.

Выполнение функций камеры

Команда HTTP http://192.168.1.2/control/rcontrol позволит Вам выполнять определенные функции камеры.

Способ написания вызовов команд

Команда с предписанием

Если Вы хотите использовать, например, предписание list с командой control, последующее предписание должно быть отделено от команды знаком ?:
   http://192.168.1.2/control/control?list

Команда с предписанием и комбинацией параметров/значений

Чтобы было выполнено предписание с одним параметром, оно должно быть отделено от параметра знаком &. Значение параметра выделяется с помощью знака =:
   http://192.168.1.2/control/control?list&section=actions

Команда с предписанием и несколькими комбинациями параметров/значений

Если необходимо передать несколько параметров, необходимо разделить их с помощью знака &:
    http://192.168.1.2/control/rcontrol?action=ledson&time=5

Несколько значений для одного параметра

У некоторых параметров требуется указать два значения, чтобы было выполнено изменение в двух объективах. Эти параметры отличаются тем, что в качестве стандартных значений указываются два параметра (например, 0 0). В самой команде HTTP эти значения необходимо разделить знаком +:
   http://192.168.1.2/control/control?set&section=general&sharpen=0+0

Концы строк в вызовах команд

Если в вызове команды должен быть один или несколько концов строки (например, чтобы задать несколько определений окон для распознания движения), их необходимо отобразить с помощью знака замены CGI %0A:    http://192.168.1.2/control/control?set&section=general&
    coverimage_area=0,540,380,200,200,2%0A1,320,100,100,150,2

Специальные знаки в вызовах команд

Чтобы использовать сами знаки форматирования CGI или специальные знаки (конец строки, пробелы, умлауты, ...), введите знаки кодировано в формате URL-адреса. При этом используется знак %, за которым следует шестнадцатеричное значение знака, как в следующих примерах:

Таблица цветовых тонов

Для определенных параметров можно указать цветовые тона, основанные на шестнадцатеричных значениях красного, зеленого и синего (RGB). Цвет определяют два знака; так, 00 обозначает наименьший цветовой тон (отсутствие цвета), FF обозначает максимальный цветовой тон (насыщенный цвет). Соответствующий цвет смешивается аддитивно, так что 0x000000 дает черный цвет, а 0xFFFFFF - белый.

Пример:

Команда control

Сначала укажите камере, какое предписание должно быть выполнено.

Предписания для команды control

Команда rcontrol

В сценарии в качестве первого значения всегда нужно указывать имя действия, которое должно быть выполнено. В зависимости от действия может также потребоваться указать дополнительные параметры. Среди дополнительных параметров различают обязательные параметры и параметры на выбор.

Указания:

• Содержимое этой рамки может отображаться только в том случае, если общий доступ к праву API был активирован в диалоговом окне Контроль за доступом групп (ACL) или группа Вашего имени пользователя имеет такое право.
• Эта страница камеры имеется в распоряжении, к сожалению, только на английском языке.