Table of Contents   MOBOTIX Online Help

HTTP API

HTTP API(Application Programming Interface,应用编程接口)是摄像机的一个软件接口,用于将摄像机便利地集成到一个中央管理系统中。该接口包含两个 CGI 脚本,可以使用 HTTP 命令通过参数和值调用它们。通过这些脚本可以修改设置子菜单的设置或执行特定的摄像机功能。

修改设置菜单的设置

使用 HTTP 命令 http://128.243.66.90/control/control 可以修改设置菜单的设置。

执行摄像机功能

使用 HTTP 命令 http://128.243.66.90/control/rcontrol 可以执行特定的摄像机功能。

重要事项: 用来保存和恢复配置的某些功能只能由具有管理访问权限的用户执行。此时需要使用另一个 HTTP 命令来调用 rcontrol 脚本,即:
http://128.243.66.90/admin/rcontrol

命令约定

包含一个指令的命令

例如如果要将 list 指令用于 control 命令,则需要使用 ? 分隔指令与命令:
   http://128.243.66.90/control/control?list

包含一个指令和参数/值对的命令

要执行含有参数的指令,必须用符号 & 分隔指令和参数。参数和值之间用 = 符号分隔。
   http://128.243.66.90/control/control?list&section=actions

包含一个指令和多个参数/值对的命令

如果要使用多个参数,需使用符号 & 分隔它们:
    http://128.243.66.90/control/rcontrol?action=ledson&time=5

一个参数有多个值

为了支持两个镜头,有些参数需要输入两个值。这些参数显示为具有两个默认值(例如 0 0)。在 http 命令中,必须用 + 符号分隔这些值:
   http://128.243.66.90/control/control?set&section=general&sharpen=0+0

命令中的换行字符

如果要在命令中使用一个或多个换行字符(例如设置多个动态侦测窗口定义),必须用 CGI 替换字符串 %0A 取代换行字符。   http://128.243.66.90/control/control?set&section=general&sharpen=0+0
    coverimage_area=0,540,380,200,200,2%0A1,320,100,100,150,2

命令中的特殊字符

要使用 CGI 格式化字符串或特殊字符(换行、空白、变音...),可输入 URL-encoded 字符。为此,请输入 % 符号,后接要显示的字符的十六进制值。下表包含最常用的字符:

字符 URL 编码 字符 URL 编码 字符 URL 编码
(换行) %0A (空格) %20+ % %25
& %26 + %2B = %3D
? %3F © %A9 ® %AE
ß %DF ä %e4 Ä %c4
ö %F6 Ö %D6 ü %FC
Ü %DC Ç %c7 à %e0
á %e1 â %E2 æ %E6
ç %E7 è %E8 é %E9
ê %EA ë %EB î %ee
ï %EF ô %F4 ù %F9
ú %FA ù %FB û %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  

control 命令

首先需要告知摄像机执行哪些指令。

control 命令的指令

指令 说明
set 对图像设置有写入权限。使用此指令可以修改图像设置。
http://128.243.66.90/control/control?set
read 对图像设置有读取权限。使用此指令可以查询有关图像设置的信息。
http://128.243.66.90/control/control?read
list

list 指令将传回可修改的配置文件段落列表。
要检索一个特定段落的参数,请在命令末尾加上 section=<sectionname>

示例:
http://128.243.66.90/control/control?list&section=actions 将列出 actions 段落的所有选项。

此命令既用于阅读当前值,也是其它应用程序获取选项和用户界面文本的一种方式。

factory factory 指令用于将段落的参数重置为出厂默认设置。此命令需要将段落名称 section=<sectionname> 作为附加参数。
http://128.243.66.90/control/control?factory&section=<sectionname>
restore restore 指令用于将段落的参数重置为闪存中存储的值。此命令需要将段落名称 section=<sectionname> 作为附加参数。
http://128.243.66.90/control/control?restore&section=<sectionname>



rcontrol 命令

脚本期待的第一个值始终是要执行的操作的名称。根据操作,可能必须提供附加的参数。附加参数可以分成必要和可选参数。

注:


注:

要查看用于 rcontrol 命令的所有选项,请在浏览器的地址栏中输入 list 指令:
http://128.243.66.90/control/rcontrol?list.

cn, de, en, es, fr, it, jp, ru

© 2001-2017 MOBOTIX AG, Germany · http://www.mobotix.com/