28181平台对接接口详解.docx
《28181平台对接接口详解.docx》由会员分享,可在线阅读,更多相关《28181平台对接接口详解.docx(22页珍藏版)》请在冰豆网上搜索。
28181平台对接接口详解
28181平台对接接口详解
1信令接口
1.1平台注册
●下级平台主动向上级平台注册;
●注册鉴权信息(用户名和密码)由上级提供;
●举例说明:
下级--->上级
REGISTERsip:
62010000002000000001@10.130.140.82:
7100SIP/2.0
Call-ID:
c82dee890ea56d9d332fe4a5dbd2772c@10.129.4.21
CSeq:
1REGISTER
From:
62010201002000000001@10.129.4.21:
5080>;tag=5923_661_2647061
To:
62010201002000000001@10.129.4.21:
5080>
Max-Forwards:
70
Contact:
62010201002000000001@10.129.4.21:
5080>
Expires:
3600
Via:
SIP/2.0/UDP10.129.4.21:
5080;branch=z9hG4bK2647061_661_55795848069639126081
Content-Length:
0
上级--->下级
SIP/2.0401Unauthorized
Via:
SIP/2.0/UDP10.129.4.21:
5080;branch=z9hG4bK2647061_661_55795848069639126081
From:
62010201002000000001@10.129.4.21:
5080>;tag=5923_661_2647061To:
62010201002000000001@10.129.4.21:
5080>;tag=316765889Call-ID:
c82dee890ea56d9d332fe4a5dbd2772c@10.129.4.21CSeq:
1REGISTERWWW-Authenticate:
Digestrealm="1234",nonce="7104983f5477dd30a65167b28553df65",opaque="f10efb1af3e8a362bcda7465284073ce",algorithm=MD5User-Agent:
HikvisionExpires:
3600Content-Length:
0下级--->上级
REGISTERsip:
62010000002000000001@10.130.140.82:
7100SIP/2.0Call-ID:
c82dee890ea56d9d332fe4a5dbd2772c@10.129.4.21CSeq:
2REGISTERFrom:
62010201002000000001@10.129.4.21:
5080>;tag=5923_661_2647061To:
62010201002000000001@10.129.4.21:
5080>Max-Forwards:
70Contact:
62010201002000000001@10.129.4.21:
5080>Via:
SIP/2.0/UDP10.129.4.21:
5080;branch=z9hG4bK2647061_661_19459966820285136301Authorization:
Digestusername="admin",realm="1234",nonce="7104983f5477dd30a65167b28553df65",uri="sip:
62010000002000000001@10.130.140.82:
7100",response="ceb3a346523335fb0c6d66d24a7e77b5",algorithm=MD5,opaque="f10efb1af3e8a362bcda7465284073ce"Expires:
3600Content-Length:
0
上级--->下级SIP/2.0200OKVia:
SIP/2.0/UDP10.129.4.21:
5080;branch=z9hG4bK2647061_661_19459966820285136301From:
62010201002000000001@10.129.4.21:
5080>;tag=5923_661_2647061To:
62010201002000000001@10.129.4.21:
5080>;tag=300030239Call-ID:
c82dee890ea56d9d332fe4a5dbd2772c@10.129.4.21CSeq:
2REGISTERContact:
62010201002000000001@10.129.4.21:
5080>User-Agent:
HikvisionDate:
2013-07-27T14:
45:
39Content-Length:
0
1.2平台心跳保活
●下级平台定期向上级平台发心跳消息;
●定期时间可配置,上下级配置一致;
●上级平台连续三次未收到下级心跳消息,则认为下级平台离线;
●下级平台连续三次未收到心跳响应,则认为上级平台离线;
●举例说明:
下级--->上级
MESSAGEsip:
62010000002000000001@10.130.140.82:
7100SIP/2.0
Call-ID:
69c20964c5c9a8f0cc6cc5a7381423d5@10.129.4.13
CSeq:
1MESSAGE
From:
62010201002000000001@10.129.4.13>;tag=0673_661_2850021
To:
62010000002000000001@10.130.140.82>
Max-Forwards:
70
Content-Type:
application/Xml
Via:
SIP/2.0/UDP10.129.4.13:
5080;branch=z9hG4bK2850021_661_35032844903563514200
Content-Length:
138
xmlversion="1.0"?
>
Keepalive
43
62010201002000000001
OK
上级--->下级
SIP/2.0200OK
Via:
SIP/2.0/UDP10.129.4.13:
5080;branch=z9hG4bK2850021_661_35032844903563514200
From:
62010201002000000001@10.129.4.13>;tag=0673_661_2850021
To:
62010000002000000001@10.130.140.82>;tag=1421372822
Call-ID:
69c20964c5c9a8f0cc6cc5a7381423d5@10.129.4.13
CSeq:
1MESSAGE
Content-Length:
0
1.3平台设备共享
●下级平台将设备共享给上级平台,共享关系临时保存在本地数据库;
●下级平台收到上级平台的目录查询消息时,返回共享给该上级平台的所有共享设备信息;
●上级平台收到目录查询响应结果后,根据设备编码或自定义方式给设备建立目录;
●上级平台最好支持定期查询目录和手动查询目录功能,以便及时获取到下级平台新共享的设备;
●举例说明
上级--->下级
MESSAGEsip:
62010201002000000001@10.129.4.13:
5080SIP/2.0
Via:
SIP/2.0/UDP172.16.3.26:
7100;rport;branch=z9hG4bK3420267366
From:
62010000002000000001@10.183.21.20:
7100>;tag=500485300
To:
62010201002000000001@10.129.4.13:
5080>
Call-ID:
124958176
CSeq:
20MESSAGE
Content-Type:
Application/MANSCDP+xml
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
127
xmlversion="1.0"?
>
Catalog
8903
62010201002000000001
下级--->上级
SIP/2.0200OK
To:
62010201002000000001@10.129.4.13:
5080>;tag=6840_661_3935882
Via:
SIP/2.0/UDP172.16.3.26:
7100;rport=7100;branch=z9hG4bK3420267366;received=10.130.140.82
CSeq:
20MESSAGE
Call-ID:
124958176
From:
62010000002000000001@10.183.21.20:
7100>;tag=500485300
Content-Length:
0
下级--->上级
MESSAGEsip:
62010000002000000001@10.130.140.82:
7100SIP/2.0
Call-ID:
3c2375ee902cdef0c10aa9fe2001e4f9@10.129.4.13
CSeq:
1MESSAGE
From:
62010201002000000001@10.129.4.13>;tag=7373_661_6058761
To:
62010000002000000001@10.130.140.82>
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Via:
SIP/2.0/UDP10.129.4.13:
5080;branch=z9hG4bK6058761_661_61989619576009343309
Content-Length:
746
xmlversion="1.0"encoding="UTF-8"?
>
Catalog
8903
62010201002000000001
2
62010401001310004766
共享镜头01
hik
1
1
62010201002000000001
1
0
1
1
400
62010201002000000001
1
0
0
0.000000
0.000000
ON
上级--->下级
SIP/2.0200OK
Via:
SIP/2.0/UDP10.129.4.13:
5080;branch=z9hG4bK6058761_661_61989619576009343309
From:
62010201002000000001@10.129.4.13>;tag=7373_661_6058761
To:
62010000002000000001@10.130.140.82>;tag=3437297396
Call-ID:
3c2375ee902cdef0c10aa9fe2001e4f9@10.129.4.13
CSeq:
1MESSAGE
User-Agent:
Hikvision
Content-Length:
0
下级--->上级
MESSAGEsip:
62010000002000000001@10.130.140.82:
7100SIP/2.0
Call-ID:
7e4db4fa734be13c979511f6a8e84df6@10.129.4.13
CSeq:
1MESSAGE
From:
62010201002000000001@10.129.4.13>;tag=5183_661_6342350
To:
62010000002000000001@10.130.140.82>
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Via:
SIP/2.0/UDP10.129.4.13:
5080;branch=z9hG4bK6342350_661_77897377155966919994
Content-Length:
749
xmlversion="1.0"encoding="UTF-8"?
>
Catalog
8903
62010201002000000001
2
62010501001310005076
共享镜头02
hik
1
1
62010201002000000001
1
0
1
1
400
62010201002000000001
1
0
0
0.000000
0.000000
ON
上级--->下级
SIP/2.0200OK
Via:
SIP/2.0/UDP10.129.4.13:
5080;branch=z9hG4bK6342350_661_77897377155966919994
From:
62010201002000000001@10.129.4.13>;tag=5183_661_6342350
To:
62010000002000000001@10.130.140.82>;tag=3651745157
Call-ID:
7e4db4fa734be13c979511f6a8e84df6@10.129.4.13
CSeq:
1MESSAGE
User-Agent:
Hikvision
Content-Length:
0
备注:
上级平台收到下级平台目录查询响应消息后,根据SumNum字段确定共享设备数量,并累计DeviceList的Item数量,当累计数量和SumNum字段值相等时,则说明查询结束。
1.4共享设备状态变更通知
●下级平台共享设备状态变更时通知给上级平台;
●举例说明:
下级--->上级
NOTIFYsip:
62010000002000000001@10.130.140.82:
7100SIP/2.0
Call-ID:
cd0cba2fc6dc8baa82738ffdf4f13add@10.129.4.13
CSeq:
1NOTIFY
From:
62010201002000000001@10.129.4.13>;tag=7373_661_6058761
To:
62010000002000000001@10.130.140.82>
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Via:
SIP/2.0/UDP10.129.4.13:
5080;branch=z9hG4bK6058761_661_61989619576009343309
Content-Length:
747
xmlversion='1.0'encoding='UTF-8'?
>
Catalog
3
62010201002000000001
1
62010401001310004766
共享镜头01
hik
1
1
62010201002000000001
1
0
1
1
400
62010201002000000001
1
0
0
0.000000
0.000000
OFF
上级--->下级
SIP/2.0200OK
Via:
SIP/2.0/UDP10.129.4.13:
5080;branch=z9hG4bK6058761_661_61989619576009343309
From:
62010201002000000001@10.129.4.13>;tag=7373_661_6058761
To:
62010000002000000001@10.130.140.82>;tag=3437297396
Call-ID:
cd0cba2fc6dc8baa82738ffdf4f13add@10.129.4.13
CSeq:
1NOTIFY
User-Agent:
Hikvision
Content-Type:
application/MANSCDP+XML
Content-Length:
171
xmlversion="1.0"encoding="GB2312"?
>
Catalog
3
62010201002000000001
OK
1.5实时视频
●上级平台请求下级共享镜头视频;
●举例说明:
上级--->下级
INVITEsip:
62010201001310000033@10.129.4.21:
5080SIP/2.0
Via:
SIP/2.0/UDP10.130.140.82:
7100;rport;branch=z9hG4bK1642482264
From:
62010000002000000001@10.130.140.82:
7100>;tag=3983823828
To:
62010201001310000033@10.129.4.21:
5080>
Call-ID:
2081113375
CSeq:
20INVITE
Contact:
62010000002000000001@10.130.140.82:
7100>
Content-Type:
Application/SDP
Max-Forwards:
70
User-Agent:
Hikvision
Subject:
62010201001310000033:
0,62010000002000000001:
0
Content-Length:
220
v=0
o=6201020100131000003300INIP410.130.140.82
s=Play
c=INIP410.130.140.82
t=00
m=video5400RTP/AVP969798
a=rtpmap:
96PS/90000
a=rtpmap:
97MPEG4/90000
a=rtpmap:
98H2