HTTP API(Application Programming Interface,应用编程接口)是摄像机的一个软件接口,用于将摄像机便利地集成到一个中央管理系统中。该接口包含两个 CGI 脚本,可以使用 HTTP 命令通过参数和值调用它们。通过这些脚本可以修改设置子菜单的设置或执行特定的摄像机功能。
修改设置菜单的设置使用 HTTP 命令 http://10.10.12.49/control/control
可以修改设置菜单的设置。
执行摄像机功能
使用 HTTP 命令 http://10.10.12.49/control/rcontrol
可以执行特定的摄像机功能。
重要事项: |
用来保存和恢复配置的某些功能只能由具有管理访问权限的用户执行。此时需要使用另一个 HTTP 命令来调用 rcontrol 脚本,即:http://10.10.12.49/admin/rcontrol
|
---|
例如如果要将 list
指令用于 control
命令,则需要使用 ? 分隔指令与命令:
http://10.10.12.49/control/control?list
要执行含有参数的指令,必须用符号 & 分隔指令和参数。参数和值之间用 =
符号分隔。
http://10.10.12.49/control/control?list§ion=action
如果要使用多个参数,需使用符号 & 分隔它们:
http://10.10.12.49/control/rcontrol?action=ledson&time=5
为了支持两个镜头,有些参数需要输入两个值。这些参数显示为具有两个默认值(例如 0 0
)。在 http 命令中,必须用 + 符号分隔这些值:
http://10.10.12.49/control/control?set§ion=general&sharpen=0+0
如果要在命令中使用一个或多个换行字符(例如设置多个动态侦测窗口定义),必须用 CGI 替换字符串 %0A
取代换行字符。 http://10.10.12.49/control/control?set§ion=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 |
首先需要告知摄像机执行哪些指令。
指令 | 说明 |
---|---|
set |
对图像设置有写入权限。使用此指令可以修改图像设置。http://10.10.12.49/control/control?set
|
read |
对图像设置有读取权限。使用此指令可以查询有关图像设置的信息。http://10.10.12.49/control/control?read
|
list |
list 指令将传回可修改的配置文件段落列表。
示例: 此命令既用于阅读当前值,也是其它应用程序获取选项和用户界面文本的一种方式。 |
factory |
factory 指令用于将段落的参数重置为出厂默认设置。此命令需要将段落名称 section=<sectionname> 作为附加参数。http://10.10.12.49/control/control?factory§ion=<sectionname>
|
restore |
restore 指令用于将段落的参数重置为闪存中存储的值。此命令需要将段落名称 section=<sectionname> 作为附加参数。http://10.10.12.49/control/control?restore§ion=<sectionname>
|
脚本期待的第一个值始终是要执行的操作的名称。根据操作,可能必须提供附加的参数。附加参数可以分成必要和可选参数。
注:
注: |
要查看用于 rcontrol 命令的所有选项,请在浏览器的地址栏中输入 |
---|
cn, en |