海康威视摄像头HTTP接口能力调研材料.docx
《海康威视摄像头HTTP接口能力调研材料.docx》由会员分享，可在线阅读，更多相关《海康威视摄像头HTTP接口能力调研材料.docx（23页珍藏版）》请在冰豆网上搜索。
海康威视摄像头HTTP接口能力调研材料
视频监控平台调研报告【海康】
V1.0
1.前言
本次从海康租借了一台硬盘录像机、一个枪机和一个球机。
由于对方HTTP告警消息模块有BUG，调测花费时间较长。
对方提供升级测试版本后已经解决。
从目前的进展情况看基本完成了我们的预期目标。
主要常用功能均已验证通过，包括：
视频监控（VLC插件方式）、录像回放、读取设备信息、设备重启、图像抓拍、告警通知、云台控制。
本次报告主要目的是记录相关功能具体实现和验证的方式方法及注意事项。
2.部署情况
租借的三台设备均部署在五层实验室，通过无线路由器连接到公司网络。
1）账号信息
设备类型
设备型号
IP地址
管理账号
密码
枪机
DS-2CD2T20-I3
192.111.111.235
admin
Nuctech123
录相机
DS-8608N-E8
192.111.111.237
admin
Nuctech123
球机
DS-2DE7184-A
192.111.111.238
admin
Nuctech123
2）设备部署&端口映射
3）设备配置注意事项
ØIPC和NVR均需要通过修改管理员密码才可以激活，然后接入网络；
Ø录相机（NVR）标准配置都是不带硬盘，所以需要事先准备好SATA硬盘；
Ø录相机（NVR）在接入枪机时，自动识别的设备协议为“海康协议”但实际需要根据说明书修改为ONVIF才可以，否则会一直报“未知错误“；
Ø枪机（IPC）须另备DC12VΦ5.5mm圆头电源；
Ø设备因为是租借来的，所以不是全新，建议配置调试之前先做出厂设置；
Ø设备默认出厂IP均为：
192.0.0.64
3.视频监控
3.1主码流与字码流
主码流与子码流是海康威视提出的概念，是为了解决在网络情况不好时为了满足远程预览的流畅性，而不影响本地录像提出的双码流技术，主码流分辨率高于子码流，主码流用来录像，子码流用来网传，默认客户端访问采用主码流，客户可以根据网络情况选择子码流访问，以达到改善网络浏览的流畅性，而又不改变本地录像的录像效果。
3.2RTSP地址格式
（1）摄像头（IPC/IPD）
地址格式：
rtsp:
//username:
pwd@ip:
port[554]/h264/ch1/码流类型/av_stream
码流类型：
main表示为主码流，sub表示为子码流
举例：
IPC主码流：
rtsp:
//admin:
Nuctech123@192.168.25.6:
10010/h264/ch1/main/av_stream
IPC子码流：
rtsp:
//admin:
Nuctech123@192.168.25.6:
10010/h264/ch1/sub/av_stream
（2）NVR
地址格式：
rtsp:
//username:
pwd@ip:
port/h264/ch/码流类型/av_stream
其中：
ch，1-32是模拟通道，33以后是IP通道。
举例：
IPC@NVR：
rtsp:
//admin:
abc123@192.168.25.6:
10011/h264/ch33/main/av_stream
IPD@NVR：
rtsp:
//admin:
abc123@192.168.25.6:
10011/h264/ch34/main/av_stream
3.3录像回放
RTSP地址格式：
rtsp:
//username:
pwd@ip:
port/Streaming/tracks/101?
starttime=yyyymmddtHHMMSSz&endtime=yyyymmddtHHMMSSz
举例：
rtsp:
//admin:
abc123@192.168.25.6:
10011/Streaming/tracks/101?
starttime=20150710t102012z&endtime=20150710t113016z
4.HTTP接口
海康设备对外提供CGI和ISAPI两种接口，设备信息和配置推荐使用ISAPI接口，云台控制则推荐使用CGI接口。
接口入口地址：
http:
//ip:
port[80]/
接口协议：
HTTP
消息格式：
XML
接口形式：
采用REST风格模式，GET表示读取当前信息、PUT表示更新配置、POST表示创建数据、DELETE表示删除配置。
4.1设备信息
4.1.1基本信息
调用地址：
/ISAPI/System/deviceInfo
返回消息：
xmlversion="1.0"encoding="utf-8"?
>
//www.std-version="2.0">
IPDOME
ef947dd1-f70b-11b4-83a0-c056e38ef866
IPDome
STD-CGI
STD-CGI
DS-2DE7184-A
DS-2DE7184-A20140928CCCH482033105
c0:
56:
e3:
8e:
f8:
66
V5.2.7
build150129
V5.0
build141009
V1.3.4
100316
0x0
IPDome
88
false
false
4.1.2设备状态
调用地址：
/ISAPI/System/status
xmlversion="1.0"encoding="utf-8"?
>
//www.std-version="2.0">
2015-07-30T14:
40:
27+08:
00
185225
ARM926EJ-Sid（wb）[41069265]revision5（ARMv5TEJ）
58
DDRMemory
91
8624
4.1.3重启设备
调用地址：
/ISAPI/System/reboot
4.1.4恢复出厂设置
调用地址：
/ISAPI/System/factoryDefault
4.2图像抓拍
调用地址：
/ISAPI/Streaming/channels/ID/picture
返回消息：
截图本身的二进制数据流
4.3告警通知
4.3.1设置告警开关
调用地址：
全部配置：
/ISAPI/Event/triggers
xmlversion="1.0"encoding="utf-8"?
>
//www.std-version="2.0">
VMD-1
VMD
VMDEventtriggerInformation
1
1
center
center
beginning
videoloss-1
videoloss
VideolossEventtriggerInformation
1
1
……
某项配置：
/Event/triggers/ID
实际地址：
/Event/triggers/VMD-1
xmlversion="1.0"encoding="utf-8"?
>
//www.std-version="2.0">
VMD-1
VMD
VMDEventtriggerInformation
1
1
center
center
beginning
4.3.2配置告警中心
告警中心可以理解为一个HTTP服务，具体地址信息配置到设备中，当有告警发生，并告警通知设置了为通知告警中心，则设备会根据设定间隔向指定的URL地址发送具体告警信息的XML文。
具体配置的写入则通过PUT消息来实现。
调用地址：
/ISAPI/Event/notification/httpHosts
返回消息：
xmlversion="1.0"encoding="utf-8"?
>
//www.std-version="2.0">
1
/ipd-warn/notify
HTTP
XML
ipaddress
192.111.111.224
8080
none
4.3.3告警消息示例
POST/ipd-warn/notifyHTTP/1.1
Content-Type:
application/xml;charset="UTF-8"
Host:
192.111.111.235
Connection:
Keep-Alive
Content-Length:
799
xmlversion="1.0"encoding="UTF-8"?
>
psialliance-org">
192.111.111.235
HTTP
c4:
2f:
90:
33:
f8:
36
1
2015-07-29T17:
05:
46+08:
00
51
VMD
active
Motionalarm
psialliance-org">
selfextension:
psiaext-ver10-xsd">DS-2CD2T20-I320150605AACH520982018
selfextension:
psiaext-ver10-xsd">VMD&&DS-2CD2T20-I320150605AACH520982018,2015-07-29T17:
05:
46+08:
00,1,1.0
4.3.4告警消息格式说明
（1）XML节点
ØipAddress：
设备的IP地址
ØprotocolType：
协议类型，只支持HTTP
ØmacAddress：
设备的MAC地址
ØchannelID：
通道号
ØdateTime：
发生报警的时间
ØactivePostCount：
该类型报警发生的次数
ØeventType：
事件类型：
ØeventState：
事件状态
ØeventDescription：
时间描述
ØExtensions：
私有信息，内部用序列号、事件类型、时间等
（2）事件类型（eventType）的含义
ØIO：
报警输入报警
ØVMD：
移动侦测
Øvideoloss：
视频丢失
Øshelteralarm：
遮挡报警
Øfacedetection：
人脸侦测
Ødefocus：
虚焦侦测
Øaudioexception：
音频异常
Øscenechangedetection：
场景变更
Øfielddetection：
区域入侵
Ølinedetection：
越界侦测
ØregionEntrance：
进入区域
ØregionExiting：
离开区域
Øloitering：
徘徊侦测
Øgroup：
人员聚集
ØrapidMove：
快速移动
Øparking：
停车侦测
ØunattendedBaggage：
物品遗留
ØattendedBaggage：
物品拿去
ØPIR：
人体检测
4.4云台控制
4.4.1云台设置
调用地址：
/PTZCtrl/channels/1/presets
返回消息：
xmlversion="1.0"encoding="utf-8"?
>
//www.std-version="2.0">
true
33
自动翻转
true
34
回到零点
true
35
巡航扫描1
……
true
39
白天模式
true
40
黑夜模式
true
41
花样扫描1
……
true
45
一键巡航
true
92
设置手动限位
true
93
确认手动限位
true
94
远程重启
true
96
停止扫描
true
97
随机扫描
true
98
帧扫描
true
99
自动扫描
true
100
垂直扫描
true
101
全景扫描
true
102
巡航扫描5
…
升级会员 