海康威视摄像头HTTP接口能力调研材料Word文档下载推荐.docx

1、主码流与子码流是海康威视提出的概念，是为了解决在网络情况不好时为了满足远程预览的流畅性，而不影响本地录像提出的双码流技术，主码流分辨率高于子码流，主码流用来录像，子码流用来网传，默认客户端访问采用主码流，客户可以根据网络情况选择子码流访问，以达到改善网络浏览的流畅性，而又不改变本地录像的录像效果。3.2 RTSP地址格式（1） 摄像头（IPC/IPD）地址格式：rtsp:/ username: pwd ip: port 554/h264/ch1/码流类型/av_stream码流类型：main表示为主码流，sub表示为子码流举例：IPC主码流：/admin:Nuctech123192.168.2

2、5.6:10010/h264/ch1/main/av_streamIPC子码流：10010/h264/ch1/sub/av_stream（2） NVR/username:pwdip:port/h264/ch/码流类型/av_stream其中：ch，1-32是模拟通道，33以后是IP通道。IPCNVR：abc123192.168.25.6:10011/h264/ch33/main/av_streamIPDNVR：10011/h264/ch34/main/av_stream3.3 录像回放RTSP地址格式：port/Streaming/tracks/101?starttime=yyyymmddtH

3、HMMSSz&endtime=yyyymmddtHHMMSSz 举例：10011/Streaming/tracks/101?starttime=20150710t102012z&endtime=20150710t113016z4. HTTP接口海康设备对外提供CGI和ISAPI两种接口，设备信息和配置推荐使用ISAPI接口，云台控制则推荐使用CGI接口。接口入口地址：http:/ip:port80/接口协议：HTTP消息格式：XML接口形式：采用REST风格模式，GET表示读取当前信息、PUT表示更新配置、POST表示创建数据、DELETE表示删除配置。4.1 设备信息4.1.1 基本信息调用

4、地址：/ISAPI/System/deviceInfo返回消息：DeviceInfo xmlns=/www.std- version=2.0 IP DOMEdeviceIDef947dd1-f70b-11b4-83a0-c056e38ef866deviceDescriptionIPDomedeviceLocationSTD-CGIsystemContact/systemContactmodelDS-2DE7184-AserialNumberDS-2DE7184-A20140928CCCH482033105macAddressc0:56:e3:8e:f8:66firmwareVersionV5.

5、2.7firmwareReleasedDatebuild 150129encoderVersionV5.0encoderReleasedDatebuild 141009bootVersionV1.3.4bootReleasedDate100316hardwareVersion0x0deviceType/deviceTypetelecontrolID88supportBeepfalsesupportVideoLoss/supportVideoLoss/DeviceInfo4.1.2 设备状态/ISAPI/System/statusDeviceStatus xmlns=currentDeviceT

6、ime2015-07-30T14:40:27+08:00deviceUpTime185225CPUListCPUcpuDescriptionARM926EJ-Sid（wb） 41069265 revision 5 （ARMv5TEJ）cpuUtilization58/CPU/CPUListMemoryListMemorymemoryDescriptionDDR MemorymemoryUsage91memoryAvailable8624/Memory/MemoryList/DeviceStatus4.1.3 重启设备/ISAPI/System/reboot4.1.4 恢复出厂设置/ISAPI/

7、System/factoryDefault4.2 图像抓拍/ISAPI/Streaming/channels/ID/picture截图本身的二进制数据流4.3 告警通知4.3.1 设置告警开关全部配置：/ISAPI/Event/triggersEventNotification xmlns=EventTriggerList version=EventTrigger version=idVMD-1eventTypeVMDeventDescriptionVMD Event trigger InformationvideoInputChannelID1dynVideoInputChannelID/d

8、ynVideoInputChannelIDEventTriggerNotificationList version=EventTriggerNotificationcenter/notificationMethodnotificationRecurrencebeginning/EventTriggerNotification/EventTriggerNotificationList/EventTriggervideoloss-1videolossVideoloss Event trigger Information/EventNotification 某项配置：/Event/triggers/

9、ID实际地址：/Event/triggers/VMD-1EventTrigger xmlns=4.3.2 配置告警中心告警中心可以理解为一个HTTP服务，具体地址信息配置到设备中，当有告警发生，并告警通知设置了为通知告警中心，则设备会根据设定间隔向指定的URL地址发送具体告警信息的XML文。具体配置的写入则通过PUT消息来实现。 调用地址：/ISAPI/Event/notification/httpHosts 返回消息：HttpHostNotificationList xmlns=HttpHostNotification version= /ipd-warn/notifyprotocolTyp

10、eHTTPparameterFormatTypeXMLaddressingFormatTypeipaddressipAddress192.111.111.224portNo8080userName/httpAuthenticationMethodnone/HttpHostNotification/HttpHostNotificationList4.3.3 告警消息示例POST /ipd-warn/notify HTTP/1.1Content-Type: application/xml; charset=UTF-8Host: 192.111.111.235Connection: Keep-Ali

11、veContent-Length: 799EventNotificationAlert version= xmlns=urn:psialliance-org192.111.111.235c4:2f:90:33:36/channelIDdateTime2015-07-29T17:05:46+08:/dateTimeactivePostCount51eventStateactiveMotion alarmExtensions version=serialNumber xmlns=selfextension:psiaext-ver10-xsdDS-2CD2T20-I320150605AACH5209

12、82018eventPush xmlns=VMD&DS-2CD2T20-I320150605AACH520982018,2015-07-29T17:00,1,1.0/Extensions/EventNotificationAlert4.3.4 告警消息格式说明（1） XML节点 ipAddress：设备的IP地址 protocolType：协议类型，只支持HTTP macAddress：设备的MAC地址 channelID：通道号 dateTime：发生报警的时间 activePostCount：该类型报警发生的次数 eventType：事件类型： eventState：事件状态 eventD

13、escription：时间描述 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/presetsPTZPresetList xmlns=PTZPresetenabledtrue33自动翻转/PTZPreset34回到零点35巡航扫描139白天模式40黑夜模式41花样扫描145一键巡航92设置手动限位93确认手动限位94远程重启96停止扫描97随机扫描98帧扫描99自动扫描100垂直扫描101全景扫描102巡航扫描5