海康威视摄像头HTTP接口能力调研报告

1、海康威视摄像头HTTP接口能力调研报告Hessen was revised in January 2021视频监控平台调研报告【海康】目录1. 前言本次从海康租借了一台硕盘录像机、一个枪机和一个球机。由于对方HTTP告警消息模块有 BUG,调测花费时间较长。对方提供升级测试版本后已经解决。从口前的进展情况看基本完成了我 们的预期口标。主要常用功能均已验证通过，包括：视频监控（VLC插件方式）、录像回放、读 取设备信息、设备重启、图像抓拍、告警通知、云台控制。本次报告主要H的是记录相关功能具 体实现和验证的方式方法及注意事项。2. 部署情况租借的三台设备均部署在五层实验室，通过无线路山器连接到公

2、司网络。1）账号信息设备类型设备型号IP地址管理账号密码枪机DS-2CD2T20-13adminNuctechl23录相机DS-8608N-E8adminNuctechl23球机DS-2DE7184-AadminNuctechl232）设备部署&端口映射球机摄像头(TPD)38 admin/Nuctechl233）设备配置注意事项IPC和NVR均需要通过修改管理员密码才可以激活，然后接入网络；录相机（NVR）标准配置都是不带硬盘，所以需要事先准备好SATA硬盘；录相机（NVR）在接入枪机时，自动识别的设备协议为“海康协议”但实际需要根据 说明书修改为ONVIF才可以，

3、否则会一直报“未知错误“；枪机（IPC）须另备DC12V圆头电源；设备因为是租借来的，所以不是全新，建议配置调试之前先做出厂设置；设备默认出厂IP均为：3. 视频监控3. 1主码流与字码流主码流与子码流是海康威视提出的概念，是为了解决在网络情况不好时为了满足远程预览 的流畅性，而不影响本地录像提出的双码流技术，主码流分辨率高于子码流，主码流用来录 像，子码流用来网传，默认客户端访问釆用主码流，客户可以根据网络惜况选择子码流访 问，以达到改善网络浏览的流畅性，而乂不改变本地录像的录像效果。3. 2 RTSP地址格式(1)摄像头(IPC/IPD)地址格式：username: pwd ip: por

4、t 554/h264/chl/码流类型/av_stream码流类型：main表示为主码流，sub表示为子码流举例：IPC主码流：number , 1-32是模拟通道，33以后是IP通道。举例：IPCNVR：举例：rtsp: /相 sername:passwordvaddress：vport/ Streaming/tracks *id|g?pann 仁 value1&parm2 七 value?.他址:RTSP端口通悟号耳他卷斟t.例如，起止时间：101: iiai?starttime =：201208O2tO6 5812z & endtime=20120802t064816z 1701: ii

5、B17举例说明：DS-9016HF-ST的模拟通道01：DS-9016HF-ST 的 IP 通道 01：、表示以单播形式回放指定设备的通道中的录像文件，时间范围是starttime到endtime-其屮starttime 和endtime的格式要符合ISO 8601。具体格式是YYYYMMDDTHHmmSS.fractional，Y是年，M是月，D 是日，T是时间分格符，H是小时，M是分，S是秒，Z是可选的、表示Zulu (GMT)时间。备信息和配置推荐使用ISAPI接口，云台控制则推荐使用CGI接口。接口入口地址：，GET表示读取当前信息、PUT表示更新配置、POST表示创建数据、DELET

6、E 表示删除配置。3. 3设备信息3. 3.1基本信息调用地址：/ISAPI/System/deviceinfo返回消息：IP DOMEef947ddl-f70b-llb4-83a0-c056e38ef866 IPDome STD-CGISTD-CGIDS-2DE7184-ADS-2DE7184-ACCCH5cO:56:e3:8e:f8:66buiId 150129build 141009 100316OxOIPDome88falsefalse/Devicelnfo3. 3. 2设备状态调用地址：/ISAPI/System/statusxml version二 encoding二2015-07

7、-30T14:40:27-08:00185225ARM926EJ-Sid(wb) revision 5 (ARMv5TEJ)58DDR Memory918624：/DeviceStatus3. 3.3重启设备调用地址：/ISAPI/System/reboot3. 3.4恢复出厂设置调用地址：/ISAPI/System/factoryDefault3. 4图像抓拍调用地址：/ISAPI/Streaming/channels/ID/picture返回消息：截图本身的二进制数据流3. 5告警通知3. 5.1设置调用地址：全部配置：/ISAPI/Event/triggersEventNotificat

8、ion xmlns二 version二EventTriggerList version二-leventTypeVMD/eventTypeVMD Event trigger Information ll EventTriggerNotificationList version二 centercenterbeginning EventTrigger version二videoloss-lvideolossVideoloss Event trigger Information ll 某项配置：/Event/triggers/ID实际地址：/Event/t:riggers/VMDT VMD-l VDX

9、/eventTypeVN Event trigger Information l lEventTriggerNotificationList vers ion二centercenter beginning3. 5.2配置告警中心告警中心可以理解为一个HTTP服务，具体地址信息配置到设备中，当有告警发生，并告 警通知设置了为通知告警中心，则设备会根据设定间隔向指定的URL地址发送具体告警信息 的XML文。具体配置的写入则通过PUT消息来实现。调用地址：/ISAPI/Event/notification/httpHosts 返回消息：xml version= encoding二l/ipd-wam/

10、not i f y HTTP XML ipaddress 8080none:/HttpHostNotificationList告警消息示例POST /ipd-warn/not i fy HTTP/Content-Type: application/xml; charset二UTF-8Host:Connection: Keep-AliveContent-Length: 799 HTTPc4:2f:90:33:f8:3612015-07-29T17:05:46+08:0051 eventTypeVMD/eventTypeactiveMotion alarm DS-2CD2T20-I5AACH8 V

11、rNfl)&DS-2CD2T20-I5AACH8, 2015-07- 29T17:05:46+08:00,1, /EventNotificationAlert5?4告警消息格式说明(1) XML节点ipAddress：设备的IP地址 protocolType：协议类型，只支持HTTP mac Address：设备的MAC地址 channel ID：通道号 dateTime：发生报警的时间 activePostCount :该类型报警发生的次数 eventType：事件类型： eventState：事件状态 eventDescription：时间描述 Extensions：私有信息，内部用序列号

12、.事件类型、时间等(2) 事件类型(eventType)的含义10：报警输入报警 VMD：移动侦测 videoloss：视频丢失 shelteralarm：遮挡报警 facedetection：人脸侦测 defocus：虚焦侦测 audioexception：音频异常 scenechangedetection： 场景变更 fielddetection：区域入侵 linedetection：越界侦测 regionEntrance：进入区域 regionExiting：离开区域 loitering：徘徊侦测 group：人员聚集 rapidMove：快速移动 parking：停车侦测 unatte

13、ndedBaggage：物品遗留 attendedBaggage：物品拿去 PIR：人体检测3. 6云台控制云台设置调用地址：/PTZCtrl/channels/l/presets返回消息： PTZPresetList xmlns二versiontrue33 自动鋪转 true34 回到零点 true35巡航扫描 ltrue39 白天模式 true4Opr e se t Name黑夜模式 true41花样扫描 l true45键巡航 true92 设置.于动限位 true93 确认于动限位 true91 远程 31 启 true96 停 1 上扫描/pre s etName true97 随机

14、扫描/pre set Name true98 帧扫描 true99 自动扫描 true100 垂直扫描 true101 全景扫描 true102巡航扫描 5 true106 风扇常开模式 true107 风扇常闭模式 true108 风扇温控模式 3. 6. 2巡航指令调用地址：/PTZCtrl/channels/presets/goto 举例：全景扫描：value of command is：LIGHT: LightWIPER: WiperFAN： FanHEATER: HeaterAUX1: auxiliary equipment 1AUX2: auxiliary equipment 2S

15、ET.PRESET： Set presetCLE_PRESET： Clear presetZ00M_IN: 2oom in the specified speed200M_0UT: Zoom out in the specified speedFOCUS_NEAR: focus near in the specified speed FOCUS_FAR： focus far in the specified speed IRIS OPEX： IRIS is open in the specified speedIRIS_CLOSE： IRIS is cloesd in the specifie

16、d speedTILT_UP: PTZ is tilt up in the specified speedTILT_D0WN: PTZ is tilt down in the specified speedPAN_LEFT: PTZ is pan left in the specified speedPAN_RIGHT： PTZ is pan right in the specified speedUP_LEFT: PTZ is up-left in the specified speedUP_RIGHT: PTZ is up-right in the specified speedDOWNJ

17、LEFT： PTZ is down-left in the specified speedDOWN-RIGHT: PTZ is down-right in the specified speedPAN_AUTO: PTZ scans pan with the specified speed MEM_PATTERN: memory pattern.RUN_PATTERN: Start patternPATROL: patrol.GOTO_PRESET: Go to preset.mode value is start and stop It indicates the start or stop

18、 of some actions for PTZ, or the turn on or turn off of external equipment power for PT2 The default is start In addition to the 飞ET_PRESET： CLE_PRESET, RUN_PATTERN andGOTO_PRESET command, all commands require the mode query parameters speed range is 17When the command is ZOOM.IN, ZOOM.OUT*, *FOCUS_

19、NEAR *FOCUS_FARIRIS.OPEN*, or IRIS_CLOSE the default is 1When the command is TILT_UP, TILT_D0WN PAN_LEFT PAN_RIGHT, UPLEFT, UP_RIGHT, ”DOWN_LEFT： ”DOWX_RIGHr, ”PAX_AUTO, the default is 33. & 3精确定位调用地址：PTZCtrl/channels/1/continuous 请求消息：0-800PTZDati 口IL Block 1- opt, xs:integer,-100.100 一- opt, xslnt

20、eger, -100.100 一 4.遗留问题4.1定位跟踪定位模块提供U标的坐标后，如何通过该位置坐标与摄像头的位置坐标计算出摄像头跟踪 显示该目标所需要调整的角度或相应云台动作的指令参数。4. 2合码器NVR没有将多路视频合并成一路视频的功能，需要单独采购合码器支持合码功能，可以将 多路视频合成一路视频输出。如果没有合码器，只能是一个插件同时只能显示一路视频。5. 附录5. 1 VLC Media Playerrt5p/1921625M.264/chlAub/iv.rtr-am VtC m“ 刁文洋的| :诜盘HO网瀰仪影入磁m.rtsp /vhn Xue I echini 2C 16ft 25 6 $5 i/1264 /.i：34nos- tz eTaroi*s oxk txretr. e?r nw 5*tv*toTr SO test. wdfttrp - ttt reartac esr.cjiir也可以通过VLC的下载地址列表：最新版本: 插件方式在浏览器中实现视频接入，具体代码如下/object/body5. 2手机端监控安装海康的手机监控软件(iWS-4500)即可。APP下载地址：具体配置及效果图中动4Gf 口电|岂卫 侔診2下午5:44中国动40歸”匕金下午4:23编辑设备（=）实时预览别名枪机册像头注田类型IP