HTTP-API (Application Programming Interface/интерфейс прикладного программирования) - это интерфейс для соединения с камерой на основе программных средств, позволяющий интегрировать камеру в централизованную систему управления. Интерфейс состоит из двух сценариев CGI, которые Вы можете вызвать с помощью команд HTTP, используя параметры и значения. С помощью этих сценариев можно изменять настройки подменю меню Установка и осуществлять функции камеры.
Изменение настроек Установочного менюКоманда HTTP http://31.47.87.165/control/control
позволит Вам изменить настройки Установочного меню.
Выполнение функций камеры
Команда HTTP http://31.47.87.165/control/rcontrol
позволит Вам выполнять определенные функции камеры.
Важно: |
Некоторые функции по сохранению и восстановлению конфигурации могут выполняться лишь одним пользователем уровня admin (администратор). В этом случае с помощью другой команды HTTP необходимо вызвать сценарий rcontrol:http://31.47.87.165/admin/rcontrol
|
---|
Если Вы хотите использовать, например, предписание list
с командой control
, последующее предписание должно быть отделено от команды знаком ?:
http://31.47.87.165/control/control?list
Чтобы было выполнено предписание с одним параметром, оно должно быть отделено от параметра знаком &. Значение параметра выделяется с помощью знака =
:
http://31.47.87.165/control/control?list§ion=actions
Если необходимо передать несколько параметров, необходимо разделить их с помощью знака &:
http://31.47.87.165/control/rcontrol?action=ledson&time=5
У некоторых параметров требуется указать два значения, чтобы было выполнено изменение в двух объективах. Эти параметры отличаются тем, что в качестве стандартных значений указываются два параметра (например, 0 0
). В самой команде HTTP эти значения необходимо разделить знаком +:
http://31.47.87.165/control/control?set§ion=general&sharpen=0+0
Если в вызове команды должен быть один или несколько концов строки (например, чтобы задать несколько определений окон для распознания движения), их необходимо отобразить с помощью знака замены CGI %0A
: http://31.47.87.165/control/control?set§ion=general&
coverimage_area=0,540,380,200,200,2%0A1,320,100,100,150,2
Чтобы использовать сами знаки форматирования CGI или специальные знаки (конец строки, пробелы, умлауты, ...), введите знаки кодировано в формате URL-адреса. При этом используется знак %
, за которым следует шестнадцатеричное значение знака, как в следующих примерах:
Знак | Кодировка в формате URL-адреса | Знак | Кодировка в формате URL-адреса | Знак | Кодировка в формате URL-адреса |
---|---|---|---|---|---|
(конец строки) | %0A |
(пробел) | %20 или + |
% | %25 |
& | %26 |
+ | %2B |
= | %3D |
? | %3F |
© | %A9 |
® | %AE |
Я | %DF |
д | %e4 |
Д | %c4 |
ц | %F6 |
Ц | %D6 |
ь | %FC |
Ь | %DC |
C | %c7 |
a | %e0 |
a | %e1 |
a | %E2 |
? | %E6 |
c | %E7 |
e | %E8 |
e | %E9 |
e | %EA |
e | %EB |
i | %ee |
i | %EF |
o | %F4 |
u | %F9 |
u | %FA |
u | %FB |
u | %fc |
Для определенных параметров можно указать цветовые тона, основанные на шестнадцатеричных значениях красного, зеленого и синего (RGB). Цвет определяют два знака; так, 00
обозначает наименьший цветовой тон (отсутствие цвета), FF
обозначает максимальный цветовой тон (насыщенный цвет). Соответствующий цвет смешивается аддитивно, так что 0x000000
дает черный цвет, а 0xFFFFFF
- белый.
Пример:
0xFF0000 |
Красный |
0x00FF00 |
Зеленый |
0x0000FF |
Синий |
Имя цвета | Шестнадцатер.обоз. | Цвет | Имя цвета | Шестнадцатер.обоз. | Цвет |
---|---|---|---|---|---|
Черный | 0x000000 |
Красно-бурый | 0x800000 |
||
Нежно-зеленый | 0x008000 |
Оливковый | 0x808000 |
||
Ультрамариновый | 0x000080 |
Лиловый | 0x800080 |
||
Аквамарин | 0x008080 |
Темно-серый | 0x808080 |
||
Светло-серый | 0xC0C0C0 |
Красный | 0xFF0000 |
||
Зеленый | 0x00FF00 |
Желтый | 0xFFFF00 |
||
Синий | 0x0000FF |
Пурпурный | 0xFF00FF |
||
Голубой | 0x00FFFF |
Белый | 0xFFFFFF |
Сначала укажите камере, какое предписание должно быть выполнено.
Предписание | Описание |
---|---|
set |
Доступ по записи к настройкам изображения. Используйте это предписание для изменения настроек изображения.http://31.47.87.165/control/control?set
|
read |
Доступ по считыванию к настройкам изображения. Используйте это предписание для запроса информации о настройках изображения.http://31.47.87.165/control/control?read
|
list |
Предписание list задает составление перечня разделов файла конфигурации, которые можно изменять.
Пример: Эта команда позволяет как считывать текущие значения, так и вызывать опции и отображаемые тексты с помощью других программ. |
factory |
С помощью предписания factory можно восстановить заводские настройки параметров раздела. В вызове в качестве дополнительного параметра необходимо также указать имя раздела: section=<имя раздела>.http://31.47.87.165/control/control?factory§ion=<имя раздела>
|
restore |
С помощью предписания restore можно восстановить значения параметров раздела, сохраненные последними во флэш-памяти. В вызове в качестве дополнительного параметра необходимо также указать имя раздела: section=<имя раздела>.http://31.47.87.165/control/control?restore§ion=<имя раздела>
|
В сценарии в качестве первого значения всегда нужно указывать имя действия, которое должно быть выполнено. В зависимости от действия может также потребоваться указать дополнительные параметры. Среди дополнительных параметров различают обязательные параметры и параметры на выбор.
Указания:
Указание: |
Можно отобразить все опции для команды rcontrol, для этого в строке адреса браузера необходимо использовать команду |
---|
cn, de, en, es, fr, it, jp, ru |