http接口

发布时间：2023-06-09 作者：admin 来源：文学

http接口

2023年2月27日发(作者：香谱二十四法图)

视频监控平台调研报告【海康】

1.前言

本次从海康租借了一台硬盘录像机、一个枪机和一个球机。由于对方HTTP告警消息模块有BUG，

调测花费时间较长。对方提供升级测试版本后已经解决。从目前的进展情况看基本完成了我们的预

期目标。主要常用功能均已验证通过，包括：视频监控（VLC插件方式）、录像回放、读取设备信

息、设备重启、图像抓拍、告警通知、云台控制。本次报告主要目的是记录相关功能具体实现和验

证的方式方法及注意事项。

2.部署情况

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

1)账号信息

设备类型设备型号IP地址管理账号密码

枪机DS-2CD2T20-I3adminNuctech123

录相机DS-8608N-E8adminNuctech123

球机DS-2DE7184-AadminNuctech123

2)设备部署&端口映射

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

返回消息：

IPDOME

ef947dd1-f70b-11b4-83a0-c056e38ef866

IPDome

STD-CGI

DS-2DE7184-A

DS-2DE7184-ACCCH5

c0:56:e3:8e:f8:66

build150129

build141009

100316

0x0

IPDome

false

3.3.2设备状态

调用地址：/ISAPI/System/status

2015-07-30T14:40:27+08:00

185225

ARM926EJ-Sid(wb)[]revision5(ARMv5TEJ)

DDRMemory

8624

3.3.3重启设备

调用地址：/ISAPI/System/reboot

3.3.4恢复出厂设置

调用地址：/ISAPI/System/factoryDefault

3.4图像抓拍

调用地址：/ISAPI/Streaming/channels/ID/picture

返回消息：截图本身的二进制数据流

3.5告警通知

3.5.1设置告警开关

调用地址：

全部配置：/ISAPI/Event/triggers

VMD-1

VMD

VMDEventtriggerInformation

center

beginning

videoloss-1

videoloss

VideolossEventtriggerInformation

……

某项配置：/Event/triggers/ID

实际地址：/Event/triggers/VMD-1

VMD-1

VMD

VMDEventtriggerInformation

center

beginning

3.5.2配置告警中心

告警中心可以理解为一个HTTP服务，具体地址信息配置到设备中，当有告警发生，并告警

通知设置了为通知告警中心，则设备会根据设定间隔向指定的URL地址发送具体告警信息的

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

调用地址：/ISAPI/Event/notification/httpHosts

返回消息：

/ipd-warn/notify

HTTP

XML

ipaddress

8080

none

3.5.3告警消息示例

POST/ipd-warn/notifyHTTP/

Content-Type:application/xml;charset="UTF-8"

Host:

Connection:Keep-Alive

Content-Length:799

HTTP

c4:2f:90:33:f8:36

2015-07-29T17:05:46+08:00

VMD

active

Motionalarm

DS-2CD2T20-I5AACH8

xmlns="urn:selfextension:psiaext-ver10-xsd">VMD&&DS-2CD2T20-I5AACH8,2015-07-29T17:05:46+08:00

,1,

3.5.4告警消息格式说明

(1)XML节点

ipAddress：设备的IP地址

protocolType：协议类型，只支持HTTP

macAddress：设备的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

返回消息：

true

自动翻转

true

回到零点

true

巡航扫描1

……

true

白天模式

true

黑夜模式

true

花样扫描1

……

true

一键巡航

true

设置手动限位

true

确认手动限位

true

远程重启

true

停止扫描

true

随机扫描

true

帧扫描

true

自动扫描

true

100

垂直扫描

true

101

全景扫描

true

102

巡航扫描5

……

true

106

风扇常开模式

true

107

风扇常闭模式

true

108

风扇温控模式

3.6.2巡航指令

调用地址：/PTZCtrl/channels//presets//goto

举例：

全景扫描：

valueofcommandis:

LIGHT:Light

WIPER:Wiper

FAN:Fan

HEATER:Heater.

AUX1:auxiliaryequipment1.

AUX2:auxiliaryequipment2

SET_PRESET:Setpreset

CLE_PRESET:Clearpreset.

ZOOM_IN:Zoominthespecifiedspeed.

ZOOM_OUT:Zoomoutinthespecifiedspeed.

FOCUS_NEAR:focusnearinthespecifiedspeed.

FOCUS_FAR:focusfarinthespecifiedspeed.

IRIS_OPEN:IRISisopeninthespecifiedspeed

IRIS_CLOSE:IRISiscloesdinthespecifiedspeed

TILT_UP:PTZistiltupinthespecifiedspeed

TILT_DOWN:PTZistiltdowninthespecifiedspeed

PAN_LEFT:PTZispanleftinthespecifiedspeed

PAN_RIGHT:PTZispanrightinthespecifiedspeed

UP_LEFT:PTZisup-leftinthespecifiedspeed

UP_RIGHT:PTZisup-rightinthespecifiedspeed

DOWN_LEFT:PTZisdown-leftinthespecifiedspeed

DOWN_RIGHT:PTZisdown-rightinthespecifiedspeed

PAN_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"aultis"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.

3.6.3精确定位

调用地址：PTZCtrl/channels/1/continuous

请求消息：

-80

4.遗留问题

4.1定位跟踪

定位模块提供目标的坐标后，如何通过该位置坐标与摄像头的位置坐标计算出摄像头跟踪

显示该目标所需要调整的角度或相应云台动作的指令参数。

4.2合码器

NVR没有将多路视频合并成一路视频的功能，需要单独采购合码器支持合码功能，可以将

多路视频合成一路视频输出。如果没有合码器，只能是一个插件同时只能显示一路视频。

5.附录

5.1VLCMediaPlayer

下载地址列表：最新版本：也可以通过VLC的插

件方式在浏览器中实现视频接入，具体代码如下

height="540"pluginspage=""codebase="">

5.2手机端监控

安装海康的手机监控软件(iVMS-4500)即可。

APP下载地址：具体配置及效果图

5.3DEMO程序

设备安装配置好之后，可以通过海康提供的ClientDemo程序来测试验证。

5.4RTSP消息示例

OPTIONSRTSP/

CSeq:2

User-Agent:LibVLC/(LIVE555StreamingMedia200OK

CSeq:2

Public:OPTIONS,DESCRIBE,PLAY,PAUSE,SETUP,TEARDOWN,SET_PARAMETER,GET_PARAMETER

Date:Tue,Jul14201513:10:15GMT

DESCRIBERTSP/

CSeq:3

User-Agent:LibVLC/(LIVE555StreamingMediaapplication/sdp

RTSP/401Unauthorized

CSeq:3

WWW-Authenticate:Digestrealm="c42f9033f836",nonce="05dff23367cb73d755cf0115e0266a94",stale="FALSE"

WWW-Authenticate:Basicrealm="c42f9033f836"

Date:Tue,Jul14201513:10:15GMT

DESCRIBERTSP/

CSeq:4

Authorization:Digestusername="admin",realm="c42f9033f836",nonce="05dff23367cb73d755cf0115e0266a94",uri="",

response="08e21e4e865cd01f"

User-Agent:LibVLC/(LIVE555StreamingMediaapplication/sdp

RTSP/200OK

CSeq:4

Content-Type:application/sdp

Content-Base:604

v=0

o=-841841INIP4

s=MediaPresentation

e=NONE

b=AS:5050

t=00

a=control:0RTP/AVP96

c=INIP4

b=AS:5000

a=recvonly

a=x-dimensions:1920,1080

a=control:H264/90000

a=fmtp:96profile-level-id=420029;packetization-mode=1;

sprop-parameter-sets=Z00AKpWoHgCJ+WEAAAcIAAFfkAQ=,aO48gA==

a=Media_header:MEDIAINFO=494D4B00000;

a=appversion:

SETUPRTSP/

CSeq:5

Authorization:Digestusername="admin",realm="c42f9033f836",nonce="05dff23367cb73d755cf0115e0266a94",uri="",

response="dff80e7fc5585ac08e4c50162e27e872"

User-Agent:LibVLC/(LIVE555StreamingMediaRTP/AVP;unicast;client_port=61748-61749

RTSP/200OK

CSeq:5

Session:6;timeout=60

Transport:RTP/AVP;unicast;client_port=61748-61749;server_port=8368-8369;ssrc=6dd2629c;mode="play"

Date:Tue,Jul14201513:10:15GMT

PLAYRTSP/

CSeq:6

Authorization:Digestusername="admin",realm="c42f9033f836",nonce="05dff23367cb73d755cf0115e0266a94",uri="",

response="df820265db78985f3f231cc5af9bc58d"

User-Agent:LibVLC/(LIVE555StreamingMedia6

Range:npt=

RTSP/200OK

CSeq:6

Session:6

RTP-Info:url=;seq=28417;rtptime=70

Date:Tue,Jul14201513:10:15GMT

GET_PARAMETERRTSP/

CSeq:7

Authorization:Digestusername="admin",realm="c42f9033f836",nonce="05dff23367cb73d755cf0115e0266a94",uri="",

response="bf6e13938d7ee447e52c4b342cb91078"

User-Agent:LibVLC/(LIVE555StreamingMedia6

RTSP/200OK

CSeq:7

Date:Tue,Jul14201513:10:15GMT

TEARDOWNRTSP/

CSeq:8

Authorization:Digestusername="admin",realm="c42f9033f836",nonce="05dff23367cb73d755cf0115e0266a94",uri="",

response="a981d92164ceefabb40ea0449f67d084"

User-Agent:LibVLC/(LIVE555StreamingMedia6

RTSP/200OK

CSeq:8

Session:6

Date:Tue,Jul14201513:10:26GMT

6.参考文献资料

1.海康设备接口资料官方地址

2.播放器官网

3.插件集成

👁️ 阅读量：0

🔖 本文标签：

🔥 最新发布文章