海康威视摄像头HTTP 接口能力调研报告视频监控平台调研报告V1.0目录1. 前言本次从海康租借了一台硬盘录像机、一个枪机和一个球机由于对方 HTTP 告警消息模块有BUG,调测花费时间较长对方提供升级测试版本后已经解决从目前的进展情况看 基本完成了我们的预期目标主要常用功能均已验证通过,包括:视频监控(VLC插件方式)、录像回放、读取设备信息、设备重启、图像抓拍、告警通知、云台控制本次报告 主要目的是记录相关功能具体实现和验证的方式方法及注意事项2・部署情况租借的三台设备均部署在五层实验室,通过无线路由器连接到公司网络1)账号信息设备类型设备型号IP地址管理账号密码枪机DS-2CD2T20-I3adminNuctech123录相机DS-8608N-E8adminNuctech123球机DS-2DE7184-AadminNuctech1232)设备部署&端口映射3)设备配置注意事项IPC和NVR均需要通过修改管理员密码才可以激活,然后接入网络;录相机(NVR)标准配置都是不带硬盘,所以需要事先准备好SATA硬盘;录相机(NVR)在接入枪机时,自动识别的设备协议为“海康协议”但实际需要根据说明书修改为ONVIF才可以,否则会一直报“未知错误“;枪机(IPC)须另备DC12V①5.5mm圆头电源;设备因为是租借来的,所以不是全新,建议配置调试之前先做出厂设置;3・视频监控3・1主码流与字码流主码流与子码流是海康威视提出的概念,是为了解决在网络情况不好时为了满足远程预览的流畅性,而不影响本地录像提出的双码流技术,主码流分辨率高于子码流,主码流用来录像,子码流用来网传,默认客户端访问采用主码流,客户可以根据网络情况选择子码流访问,以达到改善网络浏览的流畅性,而又不改变本地录像的录像效 果。
3.2 RTSP地址格式⑴摄像头(IPC/IPD)地址格式:username: pwd @ ip: port [554]/h264/chl/码流类型/av_s tream码流类型:main表示为主码流,sub表示为子码流举例:IPC 主码流:10010/h264/chl/main/av_streamIPC 子码流:10010/h264/ch1/sub/av_stream(2)NVR地址格式:username:pwd@ip:port/h264/ch〈number>/码流类型/av_stream其中:ch< number >, 1-32是模拟通道,33以后是IP通道举例:IPC@NVR:3/main/av_streamIPD@NVR:3.3 录像回放RTSP地址格式:username : pwd@ip : port/Streaming/tracks/101?startt ime=yyyymmddtHHMMSSz&end time=yyyymmddtHHMMSSz举例:4. HTTP 接口海康设备对外提供CGI和ISAPI两种接口,设备信息和配置推荐使用ISAPI接口,云台控制则推荐使用CGI接口。
接口入口地址:]/接口协议:HTTP消息格式:XML接口形式:采用REST风格模式,GET表示读取当前信息、PUT表示更新配置、POST表示创建数据、DELETE表示删除配置4.1设备信息4.1.1 基本信息调用地址:/ISAPI/System/devicelnfo 返回消息:IP DOMEef947dd1-f70bT1b4-83a0-c056e38ef866〈deviceDescription>IPDome〈deviceLocation>STD-CGISTD-CGI 〈model>DS-2DE7184-A〈/model> 〈macAddress>c0:56:e3:8e:f8:66〈/macAddress> 〈firmwareReleasedDate>build 150129 〈encoderVersion>V5.0〈/encoderVersion>〈encoderReleasedDate>build 141009100316〈/bootReleasedDate>〈hardwareVersion>0x0〈/hardwareVersion>IPDome〈telecontrolID>88〈supportBeep>false〈/supportBeep>〈supportVideoLoss>false〈/supportVideoLoss>〈/DeviceInfo>4.1.2 设备状态调用地址:/ISAPI/System/status〈?xml version二"1.0" encoding二"utf-8"?>〈currentDeviceTime>2015-07-30T14:40:27+08:00〈/currentDeviceTime> 〈deviceUpTime>185225〈/deviceUpTime>〈cpuUtilization>58〈/cpuUtilization>〈/CPU>〈/CPUList>〈MemoryList>〈Memory〉〈memoryDescription>DDR Memory〈/memoryDescription> 91 〈memoryAvailable>8624〈/memoryAvailable>〈/Memory〉4・1・3 重启设备调用地址:/ISAPI/System/reboot4・1・4 恢复出厂设置调用地址:/ISAPI/System/factoryDefault4・2图像抓拍调用地址:/ISAPI/Streaming/channels/ID/picture返回消息:截图本身的二进制数据流4・3告警通知4・3・1 设置告警开关调用地址:全部配置:/ISAPI/Event/triggers.std- version二"2.0">VMD-1VMDVMD Event trigger Information〈/eventDescription> 〈videoInputChannelID>1〈dynVideoInputChannelID>1 center 〈notificationMethod>center 〈notificationRecurrence>beginning〈/notificationRecurrence> videolossTvideolossVideoloss Event triggerInformation〈videolnputChannelID>l〈dynVideolnputChannelID>l某项配置:/Event/triggers/ID实际地址:/Event/triggers/VMD-1center〈noti ficationMethod>centerbeginning4・3・2 配置告警中心告警中心可以理解为一个HTTP服务,具体地址信息配置到设备中,当有告警发生,并告警通知设置了为通知告警中心,则设备会根据设定间隔向指定的URL地址发送具体告警信息的XML文。
具体配置的写入则通过PUT消息来实现调用地址:/ISAPI/Event/notification/httpHosts返回消息: 1/ipd-warn/notify〈/url>HTTPXML 〈addressingForma。