海康威視攝像頭HTTP接口能力調(diào)研報告

1、視頻監(jiān)控平臺調(diào)研報告【海康】目錄目錄 錯誤!未定義書簽。1. 前言 錯誤! 未定義書簽。2. 部署情況 錯誤! 未定義書簽。1) 賬號信息 錯誤! 未定義書簽。2) 設(shè)備部署&端口映射 錯誤 ! 未定義書簽。3) 設(shè)備配置注意事項(xiàng) 錯誤!未定義書簽。3. 視頻監(jiān)控 錯誤! 未定義書簽。主碼流與字碼流. 錯誤 ! 未定義書簽。RTSPtt址格式 錯誤!未定義書簽錄像回放 . 錯誤 !未定義書簽。4. HTTPR 口 錯誤!未定義書簽設(shè)備信息 錯誤!未定義書簽?；拘畔?錯誤!未定義書簽。設(shè)備狀態(tài) 錯誤!未定義書簽。重啟設(shè)備 錯誤!未定義書簽?；謴?fù)出廠設(shè)置 錯誤!未定義書簽。圖像抓拍 錯誤

2、!未定義書簽。告警通知 錯誤!未定義書簽。設(shè)置告警開關(guān) 錯誤!未定義書簽。配置告警中心 錯誤!未定義書簽。告警消息示例 錯誤!未定義書簽。告警消息格式說明 錯誤!未定義書簽。云臺控制 錯誤!未定義書簽。云臺設(shè)置 錯誤!未定義書簽。巡航指令 錯誤!未定義書簽?？刂婆_指令 錯誤!未定義書簽。精確定位 錯誤!未定義書簽。5. 遺留問題 錯誤!未定義書簽。定位跟蹤 錯誤!未定義書簽。合碼器 錯誤!未定義書簽。6. 附錄 錯誤!未定義書簽。VLCMedia Player 錯誤!未定義書簽。手機(jī)端監(jiān)控 錯誤!未定義書簽。DEMO?序 錯誤!未定義書簽RTSP?肖息示例 錯誤!未定義書簽1 .前言本次從?？?/p>

3、租借了一臺硬盤錄像機(jī)、一個槍機(jī)和一個球機(jī)。由于對方HTT*警消息模塊有BUG 調(diào)測花費(fèi)時間較長。對方提供升級測試版本后已經(jīng)解決。 從目前的進(jìn)展情況看基本完成了我們的預(yù) 期目標(biāo)。主要常用功能均已驗(yàn)證通過，包括：視頻監(jiān)控（ VLC插件方式）、錄像回放、讀取設(shè)備信 息、設(shè)備重啟、圖像抓拍、告警通知、云臺控制。本次報告主要目的是記錄相關(guān)功能具體實(shí)現(xiàn)和驗(yàn) 證的方式方法及注意事項(xiàng)。2 .部署情況租借的三臺設(shè)備均部署在五層實(shí)驗(yàn)室，通過無線路由器連接到公司網(wǎng)絡(luò)。1）賬號信息設(shè)備類型設(shè)備型號IP地址管理賬號密碼槍機(jī)DS-2CD2T20-I3錄相機(jī)DS-8608N-E8球機(jī):DS-2DE7184-A2）設(shè)備部署&

4、amp;® 口映射3）設(shè)備配置注意事項(xiàng)IPC和NVR勻需要通過修改管理員密碼才可以激活，然后接入網(wǎng)絡(luò)；錄相機(jī)（NVR標(biāo)準(zhǔn)配置都是不帶硬盤，所以需要事先準(zhǔn)備好SATAM盤；錄相機(jī)（NVR在接入槍機(jī)時，自動識別的設(shè)備協(xié)議為“?？祬f(xié)議”但實(shí)際需要根據(jù)說 明書修改為ONVIF才可以，否則會一直報“未知錯誤”；槍機(jī)（IPC）須另備DC12V圓頭電源；設(shè)備因?yàn)槭亲饨鑱淼?，所以不是全新，建議配置調(diào)試之前先做出廠設(shè)置；3 .設(shè)備默認(rèn)出廠IP均為：視頻監(jiān)控3.1 主碼流與字碼流主碼流與子碼流是海康威視提出的概念，是為了解決在網(wǎng)絡(luò)情況不好時為了滿足遠(yuǎn)程預(yù)覽的流暢性，而不影響本地錄像提出的雙碼流技術(shù)， 主

5、碼流分辨率高于子碼流，主碼流用來錄像, 子碼流用來網(wǎng)傳，默認(rèn)客戶端訪問采用主碼流，客戶可以根據(jù)網(wǎng)絡(luò)情況選擇子碼流訪問，以達(dá) 到改善網(wǎng)絡(luò)瀏覽的流暢性，而又不改變本地錄像的錄像效果。3.2 RTSFM址格式（1）攝像頭（IPC/IPD）地址格式：username: pwd ip: port 554/h264/ch1/碼流類型 /av_stream碼流類型：main表示為主碼流，sub表示為子碼流舉例：IPC 主碼流:10010/h264/ch1/main/av_streamIPC 子碼流:10010/h264/ch1/sub/av_stream2 2） NVR地址格式：number > ,1

6、-32是模擬通道，33以后是IP通道。舉例：IPCNVR:10011/h264/ch33/main/av_streamIPDNVR:10011/h264/ch34/main/av_stream3 .3錄像回放RTSPtt址格式：舉例：10011/Streaming/tracks/101starttime=t102012z&endtime=t113016z4 . HTTP接口?？翟O(shè)備對外提供CGI和ISAPI兩種接口，設(shè)備信息和配置推薦使用ISAPI接口，云臺控制則 推薦使用CGI接口。接口入口地址：，GET表示讀取當(dāng)前信息、PUT表示更新配置、POSTS示創(chuàng)建數(shù)據(jù)、DELETES 示刪

7、除配置。4.1 設(shè)備信息4.1.1 基本信息調(diào)用地址：/ISAPI/System/deviceInfo返回消息：<xml version="" encoding="utf-8"><DeviceInfo xmlns="" version=""><deviceName>IP DOME</deviceName><deviceID>ef947dd1-f70b-11b4-83a0-c056e38ef866</deviceID><deviceDesc

8、ription>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><

9、firmwareVersion><firmwareReleasedDate>build 150129</firmwareReleasedDate><encoderVersion></encoderVersion><encoderReleasedDate>build 141009</encoderReleasedDate><bootVersion><bootReleasedDate>100316</bootReleasedDate><hardwareVersion>0x0

10、</hardwareVersion><deviceType>IPDome</deviceType><telecontrolID>88</telecontrolID><supportBeep>false</supportBeep><supportVideoLoss>false</supportVideoLoss></DeviceInfo>4.1.2 設(shè)備狀態(tài)調(diào)用地址：/ISAPI/System/status<xml version="" encodin

11、g="utf-8"><DeviceStatus xmlns="" version=""><currentDeviceTime>2015-07-30T14:40:27+08:00</currentDeviceTime><deviceUpTime>185225</deviceUpTime><CPUList><CPU><cpuDescription>ARM926EJ-Sid(wb) 口 revision 5 (ARMv5TEJ)</c

12、puDescription><cpuUtilization>58</cpuUtilization></CPU></CPUList><MemoryList><Memory><memoryDescription>DDR Memory</memoryDescription><memoryUsage>91</memoryUsage><memoryAvailable>8624</memoryAvailable></Memory></Mem

13、oryList></DeviceStatus>4.1.3 重啟設(shè)備調(diào)用地址：/ISAPI/System/reboot4.1.4 恢復(fù)出廠設(shè)置調(diào)用地址：/ISAPI/System/factoryDefault4.2 圖像抓拍調(diào)用地址：/ISAPI/Streaming/channels/ID/picture返回消息：截圖本身的二進(jìn)制數(shù)據(jù)流4.3 告警通知4.3.1 設(shè)置告警開關(guān)調(diào)用地址：全部配置：/ISAPI/Event/triggers<xml version="" encoding="utf-8"><EventNoti

14、fication xmlns="" version=""><EventTriggerList version=""><EventTrigger version=""><id>VMD-1</id><eventType>VMD</eventType><eventDescription>VMD Event trigger Information</eventDescription><videoInputChanne

15、lID>1</videoInputChannelID><dynVideoInputChannelID>1</dynVideoInputChannelID><EventTriggerNotificationList version=""><EventTriggerNotification><id>center</id><notificationMethod>center</notificationMethod><notificationRecurrence&

16、gt;beginning</notificationRecurrence></EventTriggerNotification></EventTriggerNotificationList></EventTrigger><EventTrigger version=""><id>videoloss-1</id><eventType>videoloss</eventType><eventDescription>Vide010ss Event trigger I

17、nformation</eventDescription><videoInputChannelID>1</videoInputChannelID><dynVideoInputChannelID>1</dynVideoInputChannelID><EventTriggerNotificationList version=""> </EventTriggerNotificationList></EventTrigger></EventTriggerList></E

18、ventNotification>某項(xiàng)配置:/Event/triggers/ID實(shí)際地址：/Event/triggers/VMD-1<xml version="" encoding="utf-8"><EventTrigger xmlns="" version=""><id>VMD-1</id><eventType>VMD</eventType><eventDescription>VMD Event trigger Inform

19、ation</eventDescription><videoInputChannelID>1</videoInputChannelID><dynVideoInputChannelID>1</dynVideoInputChannelID><EventTriggerNotificationList version=""><EventTriggerNotification><id>center</id><notificationMethod>center<

20、/notificationMethod><notificationRecurrence>beginning</notificationRecurrence></EventTriggerNotification></EventTriggerNotificationList></EventTrigger>4.3.2 配置告警中心告警中心可以理解為一個HTTP1務(wù)，具體地址信息配置到設(shè)備中，當(dāng)有告警發(fā)生，并告警 通知設(shè)置了為通知告警中心，則設(shè)備會根據(jù)設(shè)定間隔向指定的URL地址發(fā)送具體告警信息的XM&。具體配置白寫入則通過PUT

21、?肖息來實(shí)現(xiàn)。調(diào)用地址：/ISAPI/Event/notification/httpHosts返回消息：<xml version="" encoding="utf-8"><HttpHostNotificationList xmlns="" version=""><HttpHostNotification version=""><id>1</id><url>/ipd-warn/notify</url><pro

22、tocolType>HTTP</protocolType><parameterFormatType>XML</parameterFormatType><addressingFormatType>ipaddress</addressingFormatType><ipAddress><portNo>8080</portNo><userName/><httpAuthenticationMethod>none</httpAuthenticationMethod>&l

23、t;/HttpHostNotification></HttpHostNotificationList>4.3.3 告警消息示例POST /ipd-warn/notify HTTP/Content-Type: application/xml; charset="UTF-8" Host: Keep-AliveContent-Length: 799<xml version="" encoding="UTF-8"><EventNotificationAlert version="" xm

24、lns="urn:psialliance-org"><ipAddress> alarm</eventDescription><Extensions version="" xmlns="urn:psialliance-org"><serialNumber xmlns="urn:selfextension:psiaext-ver10-xsd">DS-2CD2T20-I5AACH8</serialNumber><eventPushxmlns=&quo

25、t;urn:selfextension:psiaext-ven0-xsd">VMD&&DS-2CD2T20-I5AACH8,2015-07-29T17:05:46+08:00,1,</eventPush>/Extensions</EventNotificationAlert>4.3.4告警消息格式說明(1) XMLS點(diǎn)ipAddress :設(shè)備的IP地址protocolType :協(xié)議類型，只支持 HTTPmacAddress：設(shè)備的 MACS址channellD :通道號dateTime：發(fā)生報警的時間activePostCount :

26、該類型報警發(fā)生的次數(shù)eventType ：事件類型：eventstate :事件狀態(tài)eventDescription :時間描述Extensions :私有信息,內(nèi)部用序列號、事件類型、時間等事件類型(eventType)的含義IO：報警輸入報警VMD移動偵測videoloss :視頻丟失shelteralarm :遮擋報警facedetection :人臉偵測defocus :虛焦偵測audioexception :音頻異常scenechangedetection :場景變更fielddetection :區(qū)域入侵linedetection :越界偵測regionEntrance :進(jìn)入?yún)^(qū)域

27、regionExiting :離開區(qū)域loitering :徘徊偵測group：人員聚集rapidMove :快速移動parking :停車偵測unattendedBaggage ：物品遺留attendedBaggage ：物品拿去PIR:人體檢測4.4 云臺控制4.4.1 云臺設(shè)置調(diào)用地址：/PTZCtrl/channels/1/presets返回消息：<xml version="" encoding="utf-8"><PTZPresetList xmlns="" version="">&

28、lt;PTZPreset><enabled>true</enabled><id>33</id><presetName> 自動翻轉(zhuǎn) </presetName></PTZPreset><PTZPreset> <enabled>true</enabled><id>34</id><presetName> 回至U零點(diǎn) </presetName></PTZPreset><PTZPreset> <enabl

29、ed>true</enabled><id>35</id><presetName> 巡航掃描 1</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>39</id><presetName> 白天模式 </presetName></PTZPreset><PTZPreset><enabled>true</enabled>&

30、lt;id>40</id><presetName> 黑夜模式 </presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>41</id><presetName> 花樣掃描 1</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>45</id><p

31、resetName> 一鍵巡航 </presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>92</id><presetName> 設(shè)置手動限位 </presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>93</id><presetName> 確認(rèn)手動限位 </

32、presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>94</id><presetName> 遠(yuǎn)程重啟 </presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>96</id><presetName> 停止掃描 </presetName></PTZPreset

33、> <PTZPreset><enabled>true</enabled><id>97</id><presetName> 隨機(jī)掃描 </presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>98</id><presetName> 幀掃描 </presetName></PTZPreset> <PTZPreset><en

34、abled>true</enabled><id>99</id><presetName> 自動掃描 </presetName></PTZPreset><PTZPreset><enabled>true</enabled> <id>100</id><presetName> 垂直掃描 </presetName></PTZPreset><PTZPreset><enabled>true</enabled&

35、gt;<id>101</id><presetName> 全景掃描 </presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>102</id><presetName> 巡航掃描 5</presetName></PTZPreset><PTZPreset><enabled>true</enabled><id>106</id&g

36、t;<presetName> 風(fēng)扇常開模式</PTZPreset><PTZPreset><enabled>true</enabled><id>107</id><presetName> 風(fēng)扇常閉模式</PTZPreset><PTZPreset><enabled>true</enabled><id>108</id><presetName> 風(fēng)扇溫控模式</presetName></presetName&

37、gt;</presetName></PTZPreset></PTZPresetList>4.4.2 巡航指令調(diào)用地址：/PTZCtrl/channels/<ID>/presets/<ID>/goto舉例：4.4.3 全景掃描：停止掃描：回到零點(diǎn)：控制臺指令調(diào)用地址:/PTZ/channels/ID/PTZControl參數(shù)說明：command mode speed、presetNo、patrolNoThe value of command is:LIGHT: LightWIPER: WiperFAN: FanHEATER: Heate

38、r.AUX1: auxiliary equipment 1.AUX2: auxiliary equipment 2SET_PRESET: Set presetCLE_PRESET: Clear preset.ZOOM_IN: Zoom in the specified speed.ZOOM_OUT: Zoom out in the specified speed.FOCUS_NEAR: focus near in the specified speed.FOCUS_FAR: focus far in the specified speed.IRIS_OPEN: IRIS is open in

39、the specified speedIRIS_CLOSE: IRIS is cloesd in the specified speedTILT_UP: PTZ is tilt up in the specified speedTILT_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 specifi

40、ed 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 speed PAN_AUTO: PTZ scans pan with the specified speed. MEM_PATTERN: memory pattern.RUN_PATTERN: Start pattern.PATROL: patrol.GOTO_PRESET: Go to pr

41、eset."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 "SE

42、T_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",

43、 "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

44、is 精確定位調(diào)用地址：PTZCtrl/channels/1/continuous請求消息：<PTZData version=""xmlns=""><pan>0</pan><tilt>-80</tilt><zoom>0</zoom></PTZData>5 .遺留問題5.1 定位跟蹤定位模塊提供目標(biāo)的坐標(biāo)后，如何通過該位置坐標(biāo)與攝像頭的位置坐標(biāo)計算出攝像頭跟蹤 顯示該目標(biāo)所需要調(diào)整的角度或相應(yīng)云臺動作的指令參數(shù)。5.2 合碼器NVR沒有將多路視頻

45、合并成一路視頻的功能，需要單獨(dú)采購合碼器支持合碼功能，可以將 多路視頻合成一路視頻輸出。如果沒有合碼器，只能是一個插件同時只能顯示一路視頻。6 .附錄6.1 VLC Media Player下載地址列表：最新版本：也可以通過VLC的插件方式在瀏覽器中實(shí)現(xiàn)視頻接入，具體代碼如下<html><body><object type='application/x-vlc-plugin'id='vlc' events='True' width="720"height="540" plugi

46、nspage=""codebase=""><param name='mrl' value=':10010/h264/ch1/sub/av_stream' /><param name='volume' value='50' /><param name='autoplay' value='true' /><param name='loop' value='false' /><

47、;param name='fullscreen' value='false' /></object></body></html>6.2 手機(jī)端監(jiān)控安裝?？档氖謾C(jī)監(jiān)控軟件(iVMS-4500)即可。APP下載地址：具體配置及效果圖6.3 DEM潴序設(shè)備安裝配置好之后，可以通過海康提供的ClientDemo程序來測試驗(yàn)證。6.4 RTSR肖息示例OPTIONS r RTSP/CSeq: 2User-Agent: LibVLC/ (LIVE555 Streaming Media 200 OKCSeq: 2Public: OPT

48、IONS, DESCRIBE, PLAY, PAUSE, SETUP, TEARDOWN, SET_PARAMETER, GET_PARAMETERDate: Tue, Jul 14 2015 13:10:15 GMTDESCRIBE r RTSP/CSeq: 3User-Agent: LibVLC/ (LIVE555 Streaming Media application/sdpRTSP/ 401 UnauthorizedCSeq: 3WWW-Authenticate: Digest realm="c42f9033f836", nonce="05dff23367

49、cb73d755cf0115e0266a94", stale="FALSE"WWW-Authenticate: Basic realm="c42f9033f836”Date: Tue, Jul 14 2015 13:10:15 GMTDESCRIBE r RTSP/CSeq: 4Authorization:Digest username="admin”, realm="c42f9033f836”,nonce="05dff23367cb73d755cf0115e0266a94",uri="r",r

50、esponse="08e21e4e865cd01f”User-Agent: LibVLC/ (LIVE555 Streaming Media application/sdpRTSP/ 200 OKCSeq: 4Content-Type: application/sdpContent-Base: r 604v=0 o=- 841 841 IN IP4 Presentatione=NONE b=AS:5050 t=0 0 a=control:r 0 RTP/AVP 96 c=IN IP4 H264/90000a=fmtp:96profile-level-id=420029;packetization-mode=1;sprop