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

视频监控平台调研报告【海康】V1.0名目名目 . 前言 部署状况 账号信息 \l“_TOC_250028“设备部署&端口映射 3\l“_TOC_250027“设备配置留意事项 3视频监控 \l“_TOC_250026“主码流与字码流 4\l“_TOC_250025“RTSP地址格式 4\l“_TOC_250024“录像回放 4接口 \l“_TOC_250023“设备信息 4\l“_TOC_250022“根本信息 4\l“_TOC_250021“设备状态 5\l“_TOC_250020“重启设备 5\l“_TOC_250019“恢复出厂设置 5\l“_TOC_250018“图像抓拍 6\l“_TOC_250017“告警通知 6\l“_TOC_250016“设置告警开关 6\l“_TOC_250015“配置告警中心 7\l“_TOC_250014“告警消息例如 7\l“_TOC_250013“告警消息格式说明 8\l“_TOC_250012“云台把握 8\l“_TOC_250011“云台设置 8\l“_TOC_250010“巡航指令 10\l“_TOC_250009“把握台指令 11\l“_TOC_250008“准确定位 11\l“_TOC_250007“遗留问题 .2\l“_TOC_250006“定位跟踪 12\l“_TOC_250005“合码器 12\l“_TOC_250004“. 附录 .2\l“_TOC_250003“VLCMediaPlayer 12\l“_TOC_250002“手机端监控 13\l“_TOC_250001“O程序 .3\l“_TOC_250000“RTSP消息例如 13前言本次从海康租借了一台硬盘录像机、一个枪机和一个球机。由于对方告警消息模块有BUG，调测花费时间较长。对方供给升级测试版本后已经解决。从目前的进展状况看根本完成了我们的预期目标。主要常用功能均已验证通过，包括：视频监控〔VLC插件方式、录像回放、读取现和验证的方式方法及留意事项。部署状况租借的三台设备均部署在五层试验室，通过无线路由器连接到公司网络。账号信息设备类型设备型号IP地址治理账号密码枪机DS-2CD2T20-I335adminNuctech123录相机DS-8608N-E837adminNuctech123球机DS-2DE7184-A38adminNuctech123设备部署&端口映射设备配置留意事项NVR均需要通过修改治理员密码才可以激活，然后接入网络；SATA硬盘；ONVIF才可以，否则会始终报“未知错误“；枪机〔IPC〕DC12VΦ5.5mm圆头电源；设备由于是租借来的，所以不是全，建议配置调试之前先做出厂设置；视频监控主码流与字码流主码流与子码流是海康威视提出的概念，是为了解决在网络状况不好时为了满足远程预览子码流用来网传，默认客户端访问承受主码流，客户可以依据网络状况选择子码流访问，以到达改善网络扫瞄的流畅性，而又不转变本地录像的录像效果。RTSP地址格式码流类型/av_stream码流类型：main表示为主码流，sub表示为子码流举例：IPC主码流：rtsp://admin:.25.6:10010/h264 /ch1/main/av_streamIPC子码流：rtsp://admin:.25.6:10010/h264 /ch1/sub/av_streamNVRnumber，1-32是模拟通道，33IP通道。举例：IPC@NVR：rtsp://admin:.25.6:10011 /h264/ch33/main/av_streamIPD@NVR：rtsp://admin:.25.6:10011 /h264/ch34/main/av_stream录像回放RTSP地址格式：e=yyyymmddtHHMMSSz举例：rtsp://admin:.25.6:10011 &endtime=20230710t113016z接口CGI接口。接口协议：XMLGET表示读取当前信息、PUT表示更配置、POST表示创立数据、DELETE表示删除配置。设备信息根本信息返回消息：<?xmlversion=“1.0“encoding=“utf-8“?><DeviceInfo“://std-cgi/ver20/XMLSchema“xmlns=“://std-cgi/ver20/XMLSchema“version=“2.0“><deviceName>IPDOME</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-A20230928CCCH482033105</serialNumber><macAddress>c0:56:e3:8e:f8:66</macAddress><firmwareVersion>V5.2.7</firmwareVersion><firmwareReleasedDate>build150129</firmwareReleasedDate><encoderVersion>V5.0</encoderVersion><encoderReleasedDate>build141009</encoderReleasedDate><bootVersion>V1.3.4</bootVersion><bootReleasedDate>100316</bootReleasedDate><hardwareVersion>0x0</hardwareVersion><deviceType>IPDome</deviceType><telecontrolID>88</telecontrolID><supportBeep>false</supportBeep><supportVideoLoss>false</supportVideoLoss></DeviceInfo>设备状态<?xml<?xmlversion=“1.0“encoding=“utf-8“?><DeviceStatus“://std-cgi/ver20/XMLSchema“xmlns=“://std-cgi/ver20/XMLSchema“version=“2.0“><currentDeviceTime>2023-07-30T14:40:27+08:00</currentDeviceTime><deviceUpTime>185225</deviceUpTime><CPUList><CPU><cpuDescription>ARM926EJ-Sid(wb)[41069265]revision5(ARMv5TEJ)</cpuDescription><cpuUtilization>58</cpuUtilization></CPU></CPUList><MemoryList><Memory><memoryDescription>DDRMemory</memoryDescription><memoryUsage>91</memoryUsage><memoryAvailable>8624</memoryAvailable></Memory></MemoryList></DeviceStatus>重启设备恢复出厂设置图像抓拍返回消息：截图本身的二进制数据流告警通知设置告警开关调用地址：<?xmlversion=“1.0“encoding=“utf-8“?><EventNotification“://std-cgi/ver20/XMLSchema“xmlns=“://std-cgi/ver20/XMLSchema“version=“2.0“><EventTriggerListversion=“2.0“><EventTriggerversion=“2.0“><id>VMD-1</id><eventType>VMD</eventType><eventDescription>VMDEventtriggerInformation</eventDescription><videoInputChannelID>1</videoInputChannelID><dynVideoInputChannelID>1</dynVideoInputChannelID><EventTriggerNotificationListversion=“2.0“><EventTriggerNotification><id>center</id><notificationMethod>center</notificationMethod><notificationRecurrence>beginning</notificationRecurrence></EventTriggerNotification></EventTriggerNotificationList></EventTrigger><EventTriggerversion=“2.0“><id>videoloss-1</id><eventType>videoloss</eventType><eventDescription>VideolossEventtriggerInformation</eventDescription><videoInputChannelID>1</videoInputChannelID><dynVideoInputChannelID>1</dynVideoInputChannelID><EventTriggerNotificationListversion=“2.0“></EventTriggerNotificationList></EventTrigger>……</EventTriggerList></EventNotification>某项配置：/Event/triggers/ID<?xml<?xmlversion=“1.0“encoding=“utf-8“?><EventTrigger“://std-cgi/ver20/XMLSchema“xmlns=“://std-cgi/ver20/XMLSchema“version=“2.0“><id>VMD-1</id><eventType>VMD</eventType><eventDescription>VMDEventtriggerInformation</eventDescription><videoInputChannelID>1</videoInputChannelID><dynVideoInputChannelID>1</dynVideoInputChannelID><EventTriggerNotificationListversion=“2.0“><EventTriggerNotification><id>center</id><notificationMethod>center</notificationMethod><notificationRecurrence>beginning</notificationRecurrence><notificationRecurrence>beginning</notificationRecurrence></EventTriggerNotification></EventTriggerNotificationList></EventTrigger>配置告警中心效劳，具体地址信息配置到设备中，当有告警发生，并告URL地址发送具体告警信息的PUT消息来实现。返回消息：<?xml<?xmlversion=“1.0“encoding=“utf-8“?><HostNotificationList“://std-cgi/ver20/XMLSchema“xmlns=“://std-cgi/ver20/XMLSchema“version=“2.0“><HostNotificationversion=“2.0“><id>1</id><url>/ipd-warn/notify</url><protocolType></protocolType><parameterFormatType>XML</parameterFormatType><addressingFormatType>ipaddress</addressingFormatType><ipAddress>24</ipAddress><portNo>8080</portNo><userName/><AuthenticationMethod>none</AuthenticationMethod></HostNotification></HostNotificationList>告警消息例如POST/ipd-warn/notify/1.1Content-Type:application/xml;charset=“UTF-8“Host:35Connection:Keep-AliveContent-Length:799<?xmlversion=“1.0“encoding=“UTF-8“?><EventNotificationAlertversion=“1.0“xmlns=“urn:psialliance-org“><ipAddress>35</ipAddress><protocolType></protocolType><macAddress>c4:2f:90:33:f8:36</macAddress><channelID>1</channelID><dateTime>2023-07-29T17:05:46+08:00</dateTime><activePostCount>51</activePostCount><eventType>VMD</eventType><eventState>active</eventState><eventDescription>Motionalarm</eventDescription><Extensionsversion=“1.0“xmlns=“urn:psialliance-org“><serialNumberxmlns=“urn:selfextension:psiaext-ver10-xsd“>DS-2CD2T20-I320230605AACH520982023</serialNumber><eventPushxmlns=“urn:selfextension:psiaext-ver10-xsd“>VMD&&DS-2CD2T20-I320230605AACH520982023,2023-07-29T17:05:46+08:00,1,1.0</eventPush></Extensions></Extensions></EventNotificationAlert>告警消息格式说明XML节点channelID：通道号dateTime：发生报警的时间activePostCount：该类型报警发生的次数eventType：大事类型：eventState：大事状态eventDescription：时间描述Extensions：私有信息，内部用序列号、大事类型、时间等IO：报警输入报警VMD：移动侦测videoloss：视频丧失shelteralarm：遮挡报警facedetection：人脸侦测defocus：虚焦侦测audioexception：音频特别scenechangedetection：场景变更fielddetection：区域入侵linedetection：越界侦测regionEntrance：进入区域regionExiting：离开区域loitering：徘徊侦测group：人员聚拢rapidMove：快速移动parking：停车侦测unattendedBaggage：物品遗留attendedBaggage：物品拿去PIR：人体检测云台把握云台设置返回消息：<?xml<?xmlversion=“1.0“encoding=“utf-8“?><PTZPresetList“://std-cgi/ver20/XMLSchema“xmlns=“://std-cgi/ver20/XMLSchema“version=“2.0“><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></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></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></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>巡航指令举例：把握台指令Thevalueofcommandis:LIGHT:LightWIPER:WiperFAN:FanHEATER:Heater.AUX1:auxiliaryequipment1.AUX2:auxiliaryequipment2SET_PRESET:SetpresetCLE_PRESET:Clearpreset.ZOOM_IN:Zoominthespecifiedspeed.ZOOM_OUT:Zoomoutinthespecifiedspeed.FOCUS_NEAR:focusnearinthespecifiedspeed.FOCUS_FAR:focusfarinthespecifiedspeed.IRIS_OPEN:IRISisopeninthespecifiedspeedIRIS_CLOSE:IRISiscloesdinthespecifiedspeedTILT_UP:PTZistiltupinthespecifiedspeedTILT_DOWN:PTZistiltdowninthespecifiedspeedPAN_LEFT:PTZispanleftinthespecifiedspeedPAN_RIGHT:PTZispanrightinthespecifiedspeedUP_LEFT:PTZisup-leftinthespecifiedspeedUP_RIGHT:PTZisup-rightinthespecifiedspeedDOWN_LEFT:PTZisdown-leftinthespecifiedspeedDOWN_RIGHT:PTZisdown-rightinthespecifiedspeedPAN_AUTO:PTZscanspanwiththespecifiedspeed.MEM_PATTERN:memorypattern.RUN_PATTERN:Startpattern.PATROL:patrol.GOTO_PRESET:Gotopreset.“mode“valueis“start“and“stop“.Itindicatesthe“start“or“stop“ofsomeactionsforPTZ,orthe“turnon“or“turnoff“ofexternalequipmentpowerforPTZ.Thedefaultis“start“.Inadditiontothe“SET_PRESET“,“CLE_PRESET“,“RUN_PATTERN“and“GOTO_PRESET“command,allcommandsrequirethe“mode“queryparameters.“speed“rangeis1-7.Whenthecommandis“ZOOM_IN“,“ZOOM_OUT“,“FOCUS_NEAR“,“FOCUS_FAR“,“IRIS_OPEN“,or“IRIS_CLOSE“,thedefaultis1.Whenthecommandis“TILT_UP“,“TILT_DOWN“,“PAN_LEFT“,“PAN_RIGHT“,“UP_LEFT“,“UP_RIGHT“,“DOWN_LEFT“,“DOWN_RIGHT“,“PAN_AUTO“,thedefaultis3.准确定位恳求消息：<PTZData<PTZDataversion=“1.0““://hikvision/ver10/XMLSchema“xmlns=“://hikvision/ver10/XMLSchema“><pan>0</pan><tilt>-80</tilt><zoom>0</zoom></PTZData>遗留问题定位跟踪显示该目标所需要调整的角度或相应云台动作的指令参数。合码器NVR没有将多路视频合并成一路视频的功能，需要单独选购合码器支持合码功能，可以将多路视频合成一路视频输出。假设没有合码器，只能是一个插件同时只能显示一路视频。附录VLCMediaPlayer“:///pub/videolan/vlc/““:///pub/videolan/vlc/2.2.1/win64/“VLC的插件方式在扫瞄器中实现视频接入，具体代码如下<html><body><object type=”application/x-vlc-plugin” id=”vlc” events=”True” width=“720“ “:///“plugins=“://““:///pub/videolan/vlc-webplugins/2.0.6/npapi-vlc-2.0.6.t“ar.xz“><param name=”mrl”value=”rtsp://admin:.25.6:10010/h264 /ch1/sub/av_stream”/><paramname=”volume”value=”50”/><paramname=”autoplay”value=”true”/><paramname=”loop”value=”false”/><paramname=”fullscreen”value=”false”/></object></body></html>手机端监控(iVMS-4500)即可。“://hikvision/cn/download_more_391.html#prettyPhoto“具体配置及效果图DEMO程序ClientDemo程序来测试验证。RTSP消息例如CSeq:2User-Agent:LibVLC/2.2.1(LIVE555StreamingMediav2023.07.25)RTSP/1.0200OKCSeq:2Public:OPTIONS,DESCRIBE,PLAY,PAUSE,SETUP,TEARDOWN,SET_PARAMETER,GET_PARAMETERDate: Tue,Jul14202313:10:15GMTCSeq:3User-Agent:LibVLC/2.2.1(LIVE555StreamingMediav2023.07.25)Accept:application/sdpRTSP/1.0401UnauthorizedCSeq:3nonce=“05dff23367cb73d755cf0115e0266a94“,stale=“FALSE“WWW-Authenticate:Basicrealm=“c42f9033f836“Date: Tue,Jul14202313:10:15GMTCSeq:4Authorization: Digest username=“admin“, realm=“c42f9033f836“, uri=“rtsp://:10010/h264/ch1/main/av_stream“,response=“08e21e4e77440148865cd4864184001f“User-Agent:LibVLC/2.2.1(LIVE555StreamingMediav2023.07.25)Accept:application/sdpRTSP/1.0200OKCSeq:4Content-Type:application/sdpContent-Length:604v=0o=-14368794151488411436879415148841INIP435s=MediaPresentatione=NONEt=00m=video0RTP/AVP96c=INIPb=AS:5000a=recvonlya=x-dimensions:1920,1080a=rtpmap:96H264/90000a=fmtp:96profile-level-id=420239;packetization-mode=1;sprop-parameter-sets=Z00AKpWoHgCJ+WEAAAcIAAFfkAQ=,aO48gA==a=Media_header:MEDIAINFO=494D4B480101000004000100000000000000000000