28181平台对接接口详解.docx
《28181平台对接接口详解.docx》由会员分享,可在线阅读,更多相关《28181平台对接接口详解.docx(14页珍藏版)》请在冰豆网上搜索。
28181平台对接接口详解
28181平台对接接口详解
1信令接口
1.1平台注册
●下级平台主动向上级平台注册;
●注册鉴权信息〔用户名和密码〕由上级提供;
●举例说明:
下级--->上级
REGISTERsip:
001
CSeq:
1REGISTER
From:
001
Max-Forwards:
70
Expires:
3600
Content-Length:
0
上级--->下级
SIP/2.0401Unauthorized
CSeq:
1REGISTERWWW-Authenticate:
Digestrealm="1234",nonce="7104983f5477dd30a65167b28553df65",opaque="f10efb1af3e8a362bcda7465284073ce",algorithm=MD5User-Agent:
HikvisionExpires:
3600Content-Length:
0下级--->上级
CSeq:
2REGISTERMax-Forwards:
70Authorization:
Digestusername="admin"response="ceb3a346523335fb0c6d66d24a7e77b5",algorithm=MD5,opaque="f10efb1af3e8a362bcda7465284073ce"Expires:
3600Content-Length:
0
上级--->下级SIP/2.0200OKCSeq:
2REGISTERUser-Agent:
HikvisionDate:
2013-07-27T14:
45:
39Content-Length:
0
1.2平台心跳保活
●下级平台定期向上级平台发心跳消息;
●定期时间可配置,上下级配置一致;
●上级平台连续三次未收到下级心跳消息,那么认为下级平台离线;
●下级平台连续三次未收到心跳响应,那么认为上级平台离线;
●举例说明:
下级--->上级
CSeq:
1MESSAGE
Max-Forwards:
70
Content-Type:
application/Xml
Content-Length:
138
xmlversion="1.0"?
>
Keepalive
43
001
OK
上级--->下级
SIP/2.0200OK
CSeq:
1MESSAGE
Content-Length:
0
1.3平台设备共享
●下级平台将设备共享给上级平台,共享关系临时保存在本地数据库;
●下级平台收到上级平台的目录查询消息时,返回共享给该上级平台的所有共享设备信息;
●上级平台收到目录查询响应结果后,根据设备编码或自定义方式给设备建立目录;
●上级平台最好支持定期查询目录和手动查询目录功能,以便与时获取到下级平台新共享的设备;
●举例说明
上级--->下级
Call-ID:
124958176
CSeq:
20MESSAGE
Content-Type:
Application/MANSCDP+xml
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
127
xmlversion="1.0"?
>
Catalog
8903
001
下级--->上级
SIP/2.0200OK
CSeq:
20MESSAGE
Call-ID:
124958176
Content-Length:
0
下级--->上级
CSeq:
1MESSAGE
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Content-Length:
746
xmlversion="1.0"encoding="UTF-8"?
>
Catalog
8903
001
2
766
共享镜头01
hik
1
1
001
1
0
1
1
400
001
1
0
0
0.000000
0.000000
ON
上级--->下级
SIP/2.0200OK
CSeq:
1MESSAGE
User-Agent:
Hikvision
Content-Length:
0
下级--->上级
CSeq:
1MESSAGE
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Content-Length:
749
xmlversion="1.0"encoding="UTF-8"?
>
Catalog
8903
001
2
076
共享镜头02
hik
1
1
001
10
1
1
400
001
1
0
0
0.000000
0.000000
ON
上级--->下级
SIP/2.0200OK
CSeq:
1MESSAGE
User-Agent:
Hikvision
Content-Length:
0
备注:
上级平台收到下级平台目录查询响应消息后,根据SumNum字段确定共享设备数量,并累计DeviceList的Item数量,当累计数量和SumNum字段值相等时,那么说明查询完毕。
1.4共享设备状态变更通知
●下级平台共享设备状态变更时通知给上级平台;
●举例说明:
下级--->上级
CSeq:
1NOTIFY
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Content-Length:
747
xmlversion='1.0'encoding='UTF-8'?
>
Catalog
3
001
1
766
共享镜头01
hik
1
1
001
10
1
1
400
001
1
0
0
0.000000
0.000000
OFF
上级--->下级
SIP/2.0200OK
CSeq:
1NOTIFY
User-Agent:
Hikvision
Content-Type:
application/MANSCDP+XML
Content-Length:
171
xmlversion="1.0"encoding="GB2312"?
>
Catalog
3
001
OK
1.5实时视频
●上级平台请求下级共享镜头视频;
●举例说明:
上级--->下级
INVITEsip:
033
Call-ID:
2081113375
CSeq:
20INVITE
Content-Type:
Application/SDP
Max-Forwards:
70
User-Agent:
Hikvision
Subject:
033:
0,001:
0
Content-Length:
220
v=0
s=Play
c=INIP4
t=00
m=video5400RTP/AVP969798
a=rtpmap:
96PS/90000
a=rtpmap:
97MPEG4/90000
a=rtpmap:
98H264/90000
a=recvonly
y=0999999999
下级--->上级
SIP/2.0100Trying
CSeq:
20INVITE
Call-ID:
2081113375
Content-Length:
0
下级--->上级
SIP/2.0200OK
CSeq:
20INVITE
Call-ID:
2081113375
Content-Type:
application/sdp
Content-Length:
277
v=0
s=Play
c=INIP4
t=00
m=video6016RTP/AVP96
a=rtpmap:
96PS/90000
a=sendonly
m=audio6018RTP/AVP100
a=rtpmap:
100G711U
a=sendonly
a=username:
admin
a=password:
123456
y=0999999999
f=v/2/1/0/1/0a///
上级--->下级
Call-ID:
2081113375
CSeq:
20ACK
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
0
上级--->下级
Call-ID:
2081113375
CSeq:
21BYE
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
0
1.6云台控制
●上级平台向下级平台发送云台控制请求;
●举例说明:
上级--->下级
Call-ID:
1813198482
CSeq:
20MESSAGE
Content-Type:
Application/MANSCDP+xml
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
298
xmlversion="1.0"?
>
DeviceControl
8
033
a50f4d0000000001
150
0
0
0
0
下级--->上级
SIP/2.0200OK
CSeq:
20MESSAGE
Call-ID:
1813198482
Content-Length:
0
1.7录像查询
●上级平台向下级平台查询录像请求;
●举例说明:
上级--->下级
Call-ID:
3317287086
CSeq:
20MESSAGE
Content-Type:
Application/MANSCDP+xml
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
258
xmlversion="1.0"?
>
RecordInfo
1894
793
2013-11-07T00:
00:
00
2013-11-07T23:
59:
59
all
1
下级--->上级
SIP/2.0200OK
CSeq:
20MESSAGE
Call-ID:
3317287086
Content-Length:
0
下级--->上级
CSeq:
1MESSAGE
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Content-Encoding:
UTF-8
Content-Length:
566
xmlversion='1.0'encoding='UTF-8'?
>
RecordInfo
1894
793
共享镜头01
2
793
共享镜头01
2013-11-06T23:
17:
32
2013-11-07T00:
02:
48
time
HWPLATRD-0101-VCURD-ch01_
上级--->下级
SIP/2.0200OK
CSeq:
1MESSAGE
User-Agent:
Hikvision
Content-Length:
0
下级--->上级
CSeq:
1MESSAGE
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Content-Encoding:
UTF-8
Content-Length:
566
xmlversion='1.0'encoding='UTF-8'?
>
RecordInfo
1894
793
共享镜头01
2
793
共享镜头01
2013-11-07T00:
02:
48
2013-11-07T00:
48:
03
time
HWPLATRD-0101-VCURD-ch01_
上级--->下级
SIP/2.0200OK
CSeq:
1MESSAGE
User-Agent:
Hikvision
Content-Length:
0