平台对接接口详解.docx
《平台对接接口详解.docx》由会员分享,可在线阅读,更多相关《平台对接接口详解.docx(20页珍藏版)》请在冰豆网上搜索。
平台对接接口详解
Companynumber【1089WT-1898YT-1W8CB-9UUT-92108】
平台对接接口详解
28181平台对接接口详解
1信令接口
1.1平台注册
下级平台主动向上级平台注册;
注册鉴权信息(用户名和密码)由上级提供;
举例说明:
下级--->上级
REGISTERsip:
6200001@:
7100SIP/
Call-ID:
c82dee890ea56d9d332fe4a5dbd2772c@
CSeq:
1REGISTER
From:
6200001@:
5080>;tag=5923_661_2647061
To:
6200001@:
5080>
Max-Forwards:
70
Contact:
6200001@:
5080>
Expires:
3600
Via:
SIP/UDP:
5080;branch=z9hG4bK2647061_661_0081
Content-Length:
0
上级--->下级
SIP/401Unauthorized
Via:
SIP/UDP:
5080;branch=z9hG4bK2647061_661_0081
From:
6200001@:
5080>;tag=5923_661_2647061
To:
6200001@:
5080>;tag=9
Call-ID:
c82dee890ea56d9d332fe4a5dbd2772c@
CSeq:
1REGISTER
WWW-Authenticate:
Digestrealm="1234",nonce="7104983f5477dd30a65167b28553df65",opaque="f10efb1af3e8a362bcda73ce",algorithm=MD5
User-Agent:
Hikvision
Expires:
3600
Content-Length:
0
下级--->上级
REGISTERsip:
6200001@:
7100SIP/
Call-ID:
c82dee890ea56d9d332fe4a5dbd2772c@
CSeq:
2REGISTER
From:
6200001@:
5080>;tag=5923_661_2647061
To:
6200001@:
5080>
Max-Forwards:
70
Contact:
6200001@:
5080>
Via:
SIP/UDP:
5080;branch=z9hG4bK2647061_661_5136301
Authorization:
Digestusername="admin",realm="1234",nonce="7104983f5477dd30a65167b28553df65",uri="sip:
6200001@:
7100",response="ceb3a5fb0c6d66d24a7e77b5",algorithm=MD5,opaque="f10efb1af3e8a362bcda73ce"
Expires:
3600
Content-Length:
0
上级--->下级
SIP/200OK
Via:
SIP/UDP:
5080;branch=z9hG4bK2647061_661_5136301
From:
6200001@:
5080>;tag=5923_661_2647061
To:
6200001@:
5080>;tag=9
Call-ID:
c82dee890ea56d9d332fe4a5dbd2772c@
CSeq:
2REGISTER
Contact:
6200001@:
5080>
User-Agent:
Hikvision
Date:
2013-07-27T14:
45:
39
Content-Length:
0
1.2平台心跳保活
下级平台定期向上级平台发心跳消息;
定期时间可配置,上下级配置一致;
上级平台连续三次未收到下级心跳消息,则认为下级平台离线;
下级平台连续三次未收到心跳响应,则认为上级平台离线;
举例说明:
下级--->上级
MESSAGEsip:
6200001@:
7100SIP/
Call-ID:
69c20964c5c9a8f0cc6cc5a7381423d5@
CSeq:
1MESSAGE
From:
6200001@>;tag=0673_661_2850021
To:
6200001@>
Max-Forwards:
70
Content-Type:
application/Xml
Via:
SIP/UDP:
5080;branch=z9hG4bK2850021_661_4200
Content-Length:
138
Keepalive
43
6200001
OK
上级--->下级
SIP/200OK
Via:
SIP/UDP:
5080;branch=z9hG4bK2850021_661_4200
From:
6200001@>;tag=0673_661_2850021
To:
6200001@>;tag=22
Call-ID:
69c20964c5c9a8f0cc6cc5a7381423d5@
CSeq:
1MESSAGE
Content-Length:
0
1.3平台设备共享
下级平台将设备共享给上级平台,共享关系临时保存在本地数据库;
下级平台收到上级平台的目录查询消息时,返回共享给该上级平台的所有共享设备信息;
上级平台收到目录查询响应结果后,根据设备编码或自定义方式给设备建立目录;
上级平台最好支持定期查询目录和手动查询目录功能,以便及时获取到下级平台新共享的设备;
举例说明
上级--->下级
MESSAGEsip:
6200001@:
5080SIP/
Via:
SIP/UDP:
7100;rport;branch=z9hG4bK66
From:
6200001@:
7100>;tag=0
To:
6200001@:
5080>
Call-ID:
6
CSeq:
20MESSAGE
Content-Type:
Application/MANSCDP+xml
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
127
Catalog
8903
6200001
下级--->上级
SIP/200OK
To:
6200001@:
5080>;tag=6840_661_3935882
Via:
SIP/UDP:
7100;rport=7100;branch=z9hG4bK66;received=
CSeq:
20MESSAGE
Call-ID:
6
From:
6200001@:
7100>;tag=0
Content-Length:
0
下级--->上级
MESSAGEsip:
6200001@:
7100SIP/
Call-ID:
3c2375ee902cdef0c10aa9fe2001e4f9@
CSeq:
1MESSAGE
From:
6200001@>;tag=7373_661_6058761
To:
6200001@>
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Via:
SIP/UDP:
5080;branch=z9hG4bK6058761_661_6343309
Content-Length:
746
Catalog
8903
6200001
2
6204766
共享镜头01
hik
1
1
6200001
1
0
1
1
400
6200001
1
0
0
ON
上级--->下级
SIP/200OK
Via:
SIP/UDP:
5080;branch=z9hG4bK6058761_661_6343309
From:
6200001@>;tag=7373_661_6058761
To:
6200001@>;tag=96
Call-ID:
3c2375ee902cdef0c10aa9fe2001e4f9@
CSeq:
1MESSAGE
User-Agent:
Hikvision
Content-Length:
0
下级--->上级
MESSAGEsip:
6200001@:
7100SIP/
Call-ID:
7e4db4fa734be13c979511f6a8e84df6@
CSeq:
1MESSAGE
From:
6200001@>;tag=5183_661_6342350
To:
6200001@>
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Via:
SIP/UDP:
5080;branch=z9hG4bK6342350_661_
Content-Length:
749
Catalog
8903
6200001
2
6205076
共享镜头02
hik
1
1
6200001
1
0
1
1
400
6200001
1
0
0
ON
上级--->下级
SIP/200OK
Via:
SIP/UDP:
5080;branch=z9hG4bK6342350_661_
From:
6200001@>;tag=5183_661_6342350
To:
6200001@>;tag=57
Call-ID:
7e4db4fa734be13c979511f6a8e84df6@
CSeq:
1MESSAGE
User-Agent:
Hikvision
Content-Length:
0
备注:
上级平台收到下级平台目录查询响应消息后,根据SumNum字段确定共享设备数量,并累计DeviceList的Item数量,当累计数量和SumNum字段值相等时,则说明查询结束。
1.4共享设备状态变更通知
下级平台共享设备状态变更时通知给上级平台;
举例说明:
下级--->上级
NOTIFYsip:
6200001@:
7100SIP/
Call-ID:
cd0cba2fc6dc8baa82738ffdf4f13add@
CSeq:
1NOTIFY
From:
6200001@>;tag=7373_661_6058761
To:
6200001@>
Max-Forwards:
70
Content-Type:
application/MANSCDP+XML
Via:
SIP/UDP:
5080;branch=z9hG4bK6058761_661_6343309
Content-Length:
747
Catalog
3
6200001
1
6204766
共享镜头01
hik
1
1
6200001
1
0
1
1
400
6200001
1
0
0
OFF
上级--->下级
SIP/200OK
Via:
SIP/UDP:
5080;branch=z9hG4bK6058761_661_6343309
From:
6200001@>;tag=7373_661_6058761
To:
6200001@>;tag=96
Call-ID:
cd0cba2fc6dc8baa82738ffdf4f13add@
CSeq:
1NOTIFY
User-Agent:
Hikvision
Content-Type:
application/MANSCDP+XML
Content-Length:
171
Catalog
3
6200001
OK
1.5实时视频
上级平台请求下级共享镜头视频;
举例说明:
上级--->下级
INVITEsip:
6200033@:
5080SIP/
Via:
SIP/UDP:
7100;rport;branch=z9hG4bK64
From:
6200001@:
7100>;tag=28
To:
6200033@:
5080>
Call-ID:
75
CSeq:
20INVITE
Contact:
6200001@:
7100>
Content-Type:
Application/SDP
Max-Forwards:
70
User-Agent:
Hikvision
Subject:
6200033:
0,6200001:
0
Content-Length:
220
v=0
o=620003300INIP4
s=Play
c=INIP4
t=00
m=video5400RTP/AVP969798
a=rtpmap:
96PS/90000
a=rtpmap:
97MPEG4/90000
a=rtpmap:
98H264/90000
a=recvonly
y=09
下级--->上级
SIP/100Trying
To:
6200033@:
5080>
Via:
SIP/UDP:
7100;rport=7100;branch=z9hG4bK64;received=
CSeq:
20INVITE
Call-ID:
75
From:
6200001@:
7100>;tag=28
Content-Length:
0
下级--->上级
SIP/200OK
To:
6200033@:
5080>;tag=3222_661_8389915
Via:
SIP/UDP:
7100;rport=7100;branch=z9hG4bK64;received=
CSeq:
20INVITE
Call-ID:
75
From:
6200001@:
7100>;tag=28
Contact:
:
5080>
Content-Type:
application/sdp
Content-Length:
277
v=0
o=huawei0810INIP4
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=09
f=v/2/1/0/1/0a///
上级--->下级
ACKsip:
:
5080SIP/
Via:
SIP/UDP:
7100;rport;branch=z9hG4bK6
From:
6200001@:
7100>;tag=28
To:
6200033@:
5080>;tag=3222_661_8389915
Call-ID:
75
CSeq:
20ACK
Contact:
6200001@:
7100>
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
0
上级--->下级
BYEsip:
:
5080SIP/
Via:
SIP/UDP:
7100;rport;branch=z9hG4bK6
From:
6200001@:
7100>;tag=28
To:
6200043@:
5080>;tag=3222_661_8389915
Call-ID:
75
CSeq:
21BYE
Contact:
6200001@:
7100>
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
0
1.6云台控制
上级平台向下级平台发送云台控制请求;
举例说明:
上级--->下级
MESSAGEsip:
6200033@:
5080SIP/
Via:
SIP/UDP:
7100;rport;branch=z9hG4bK59
From:
6200001@:
7100>;tag=18
To:
6200033@:
5080>
Call-ID:
82
CSeq:
20MESSAGE
Content-Type:
Application/MANSCDP+xml
Max-Forwards:
70
User-Agent:
Hikvision
Content-Length:
298
DeviceControl
8
6200033
a50f4d0000000001
150
0
0
0
0
下级--->上级
SIP/200OK
To:
6200033@:
5080>;tag=5541_661_3619007
Via:
SIP/UDP:
7100;rport=7100;branch=z9hG4bK59;received=
CSeq:
20MESSAGE
Call-ID:
82
From:
6200001@:
7100>;tag=18
Content-Lengt