当前位置:文档之家› 海康威视摄像头HTTP接口能力调研报告

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

视频监控平台调研报告【海康】目录1.前言本次从海康租借了一台硬盘录像机、一个枪机和一个球机。

由于对方HTTP告警消息模块有BUG,调测花费时间较长。

对方提供升级测试版本后已经解决。

从目前的进展情况看基本完成了我们的预期目标。

主要常用功能均已验证通过,包括:视频监控(VLC插件方式)、录像回放、读取设备信息、设备重启、图像抓拍、告警通知、云台控制。

本次报告主要目的是记录相关功能具体实现和验证的方式方法及注意事项。

2.部署情况租借的三台设备均部署在五层实验室,通过无线路由器连接到公司网络。

1)账号信息设备类型设备型号IP地址管理账号密码枪机DS-2CD2T20-I3admin Nuctech123录相机DS-8608N-E8admin Nuctech123球机DS-2DE7184-A admin Nuctech1232)设备部署&端口映射3)设备配置注意事项IPC和NVR均需要通过修改管理员密码才可以激活,然后接入网络;录相机(NVR)标准配置都是不带硬盘,所以需要事先准备好SATA硬盘;录相机(NVR)在接入枪机时,自动识别的设备协议为“海康协议”但实际需要根据说明书修改为ONVIF才可以,否则会一直报“未知错误“;枪机(IPC)须另备 DC12V Φ圆头电源;设备因为是租借来的,所以不是全新,建议配置调试之前先做出厂设置;设备默认出厂IP均为:3.视频监控3.1主码流与字码流主码流与子码流是海康威视提出的概念,是为了解决在网络情况不好时为了满足远程预览的流畅性,而不影响本地录像提出的双码流技术,主码流分辨率高于子码流,主码流用来录像,子码流用来网传,默认客户端访问采用主码流,客户可以根据网络情况选择子码流访问,以达到改善网络浏览的流畅性,而又不改变本地录像的录像效果。

3.2RTSP地址格式(1)摄像头(IPC/IPD)地址格式: username: pwd @ ip: port [554]/h264/ch1/码流类型/av_stream码流类型:main表示为主码流,sub表示为子码流举例:IPC主码流: number >,1-32是模拟通道,33以后是IP通道。

举例:IPC@NVR:举例:,设备信息和配置推荐使用ISAPI接口,云台控制则推荐使用CGI接口。

接口入口地址:,GET表示读取当前信息、PUT表示更新配置、POST表示创建数据、DELETE表示删除配置。

3.3设备信息3.3.1基本信息调用地址:/ISAPI/System/deviceInfo<xml version="" encoding="utf-8"><DeviceInfo xmlns="" version=""><deviceName>IP DOME</deviceName><deviceID>ef947dd1-f70b-11b4-83a0-c056e38ef866</deviceID><deviceDescription>IPDome</deviceDescription><deviceLocation>STD-CGI</deviceLocation><systemContact>STD-CGI</systemContact><model>DS-2DE7184-A</model><serialNumber>DS-2DE7184-ACCCH5</serialNumber><macAddress>c0:56:e3:8e:f8:66</macAddress><firmwareVersion><firmwareReleasedDate>build 150129</firmwareReleasedDate><encoderVersion></encoderVersion><encoderReleasedDate>build 141009</encoderReleasedDate><bootVersion>3.3.2设备状态3.3.3重启设备调用地址:/ISAPI/System/reboot3.3.4恢复出厂设置调用地址:/ISAPI/System/factoryDefault3.4图像抓拍调用地址:/ISAPI/Streaming/channels/ID/picture 返回消息:截图本身的二进制数据流3.5告警通知3.5.1设置告警开关调用地址:3.5.2配置告警中心告警中心可以理解为一个HTTP服务,具体地址信息配置到设备中,当有告警发生,并告警通知设置了为通知告警中心,则设备会根据设定间隔向指定的URL地址发送具体告警信息的XML文。

具体配置的写入则通过PUT消息来实现。

调用地址:/ISAPI/Event/notification/httpHosts<addressingFormatType>ipaddress</addressingFormatType><ipAddress></ipAddress><portNo>8080</portNo><userName/><httpAuthenticationMethod>none</httpAuthenticationMethod></HttpHostNotification></HttpHostNotificationList>3.5.3告警消息示例POST /ipd-warn/notify HTTP/Content-Type: application/xml; charset="UTF-8"Host:Connection: Keep-AliveContent-Length: 799<xml version="" encoding="UTF-8"><EventNotificationAlert version="" xmlns="urn:psialliance-org"><ipAddress></ipAddress><protocolType>HTTP</protocolType><macAddress>c4:2f:90:33:f8:36</macAddress><channelID>1</channelID><dateTime>2015-07-29T17:05:46+08:00</dateTime><activePostCount>51</activePostCount><eventType>VMD</eventType><eventState>active</eventState><eventDescription>Motion alarm</eventDescription><Extensions version="" xmlns="urn:psialliance-org"><serialNumber xmlns="urn:selfextension:psiaext-ver10-xsd">DS-2CD2T20-I5AACH8</serialNumber> <eventPushxmlns="urn:selfextension:psiaext-ver10-xsd">VMD&&DS-2CD2T20-I5AACH8,2015-07-29T17:05:46+08:00 ,1,</eventPush></Extensions></EventNotificationAlert>3.5.4告警消息格式说明(1)XML节点ipAddress:设备的IP地址protocolType:协议类型,只支持HTTPmacAddress:设备的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:人体检测3.6云台控制3.6.1云台设置调用地址:/PTZCtrl/channels/1/presets 返回消息:<xml version="" encoding="utf-8"><PTZPresetList xmlns="" version=""><PTZPreset><enabled>true</enabled><id>33</id><presetName>自动翻转</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>34</id><presetName>回到零点</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>35</id><presetName>巡航扫描1</presetName></PTZPreset>……<PTZPreset><enabled>true</enabled><id>39</id><presetName>白天模式</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>40</id><presetName>黑夜模式</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>41</id><presetName>花样扫描1</presetName></PTZPreset>……<PTZPreset><enabled>true</enabled><id>45</id><presetName>一键巡航</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>92</id><presetName>设置手动限位</presetName> </PTZPreset><PTZPreset><enabled>true</enabled><id>93</id><presetName>确认手动限位</presetName> </PTZPreset><PTZPreset><enabled>true</enabled><id>94</id><presetName>远程重启</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>96</id><presetName>停止扫描</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>97</id><presetName>随机扫描</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>98</id><presetName>帧扫描</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>99</id><presetName>自动扫描</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>100</id><presetName>垂直扫描</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>101</id><presetName>全景扫描</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>102</id><presetName>巡航扫描5</presetName></PTZPreset>……<PTZPreset><enabled>true</enabled><id>106</id><presetName>风扇常开模式</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>107</id><presetName>风扇常闭模式</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>108</id><presetName>风扇温控模式</presetName></PTZPreset></PTZPresetList>3.6.2巡航指令调用地址:/PTZCtrl/channels/<ID>/presets/<ID>/goto 举例:TILT_DOWN: 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 speedDOWN_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 pattern.PATROL: patrol.GOTO_PRESET: Go to preset."mode" value is "start" and "stop". It indicates the "start" or "stop" of some actions for PTZ,or the "turn on" or "turn off" of external equipment power for PTZ. The default is "start".In addition to the "SET_PRESET", "CLE_PRESET", "RUN_PATTERN" and"GOTO_PRESET" command, all commands require the "mode" query parameters."speed" range is 1-7.When the command is "ZOOM_IN", "ZOOM_OUT", "FOCUS_NEAR", "FOCUS_FAR","IRIS_OPEN", or "IRIS_CLOSE", the default is 1.When the command is "TILT_UP", "TILT_DOWN", "PAN_LEFT", "PAN_RIGHT","UP_LEFT", "UP_RIGHT", "DOWN_LEFT", "DOWN_RIGHT", "PAN_AUTO", the default is 3.3.6.3精确定位调用地址:PTZCtrl/channels/1/continuous<PTZData version="" xmlns=""><pan>0</pan><tilt>-80</tilt><zoom>0</zoom></PTZData>4.遗留问题4.1定位跟踪定位模块提供目标的坐标后,如何通过该位置坐标与摄像头的位置坐标计算出摄像头跟踪显示该目标所需要调整的角度或相应云台动作的指令参数。

相关主题