28181平台对接接口详解.docx

28181平台对接接口详解

文档名称
文档密级

28181平台对接接口详解
1 信令接口
1.1 平台注册
l 下级平台主动向上级平台注册；
l 注册鉴权信息（用户名和密码）由上级提供；
l 举例说明：
下级--->上级
REGISTER sip:62010000002000000001上级平台ID
@10.130.140.82:7100 SIP/2.0
Call-ID: c82dee890ea56d9d332fe4a5dbd2772c@10.129.4.21
CSeq: 1 REGISTER
From: 001下级平台ID
@10.129.4.21:5080>;tag=5923_661_2647061
To:
Max-Forwards: 70
Contact:
Expires: 3600
Via: SIP/2.0/UDP 10.129.4.21:5080;branch=z9hG4bK2647061_661_55795848069639126081
Content-Length: 0

上级--->下级
SIP/2.0 401 Unauthorized
Via: SIP/2.0/UDP 10.129.4.21:5080;branch=z9hG4bK2647061_661_55795848069639126081
From: ;tag=5923_661_2647061
To: ;tag=316765889
Call-ID: c82dee890ea56d9d332fe4a5dbd2772c@10.129.4.21
CSeq: 1 REGISTER
WWW-Authenticate: Digest realm="1234", nonce="7104983f5477dd30a65167b28553df65", opaque="f10efb1af3e8a362bcda7465284073ce", algorithm=MD5
User-Agent: Hikvision
Expires: 3600
Content-Length: 0

下级--->上级
REGISTER sip:62010000002000000001@10.130.140.82:7100 SIP/2.0
Call-ID: c82dee890ea56d9d332fe4a5dbd2772c@10.129.4.21
CSeq: 2 REGISTER
From: ;tag=5923_661_2647061
To:
Max-Forwards: 70
Contact:
Via: SIP/2.0/UDP 10.129.4.21:5080;branch=z9hG4bK2647061_661_19459966820285136301
Authorization: Digest username="admin"上级平台提供鉴权信息时指定的用户。
,realm="1234",nonce="7104983f5477dd30a65167b28553df65",uri="sip:62010000002000000001@10.130.140.82:7100",response="ceb3a346523335fb0c6d66d24a7e77b5下级平台根据上级平台返回的挑战字和上级平台的鉴权信息，用MD5算法计算得到。
",algorithm=MD5,opaque="f10efb1af3e8a362bcda7465284073ce"
Expires: 3600
Content-Length: 0

上级--->下级
SIP/2.0 200 OK
Via: SIP/2.0/UDP 10.129.4.21:5080;branch=z9hG4bK2647061_661_19459966820285136301
From: ;tag=5923_661_2647061
To: ;tag=300030239
Call-ID: c82dee890ea56d9d332fe4a5dbd2772c@10.129.4.21
CSeq: 2 REGISTER
Contact:
User-Agent: Hikvision
Date: 2013-07-27T14:45:39
Content-Length: 0
1.2 平台心跳保活
l 下级平台定期向上级平台发心跳消息；
l 定期时间可配置，上下级配置一致；
l 上级平台连续三次未收到下级心跳消息，则认为下级平台离线；
l 下级平台连续三次未收到心跳响应，则认为上级平台离线；
l 举例说明：
下级--->上级
MESSAGE sip:62010000002000000001@10.130.140.82:7100 SIP/2.0
Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d5@10.129.4.13
CSeq: 1 MESSAGE
From: ;tag=0673_661_2850021
To:
Max-Forwards: 70
Content-Type: application/Xml
Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK2850021_661_35032844903563514200
Content-Length: 138

Keepalive
43
62010201002000000001下级平台ID

OK

上级--->下级
SIP/2.0 200 OK
Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK2850021_661_35032844903563514200
From: ;tag=0673_661_2850021
To: ;tag=1421372822
Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d5@10.129.4.13
CSeq: 1 MESSAGE
Content-Length: 0

1.3 平台设备共享
l 下级平台将设备共享给上级平台，共享关系临时保存在本地数据库；
l 下级平台收到上级平台的目录查询消息时，返回共享给该上级平台的所有共享设备信息；
l 上级平台收到目录查询响应结果后，根据设备编码或自定义方式给设备建立目录；
l 上级平台最好支持定期查询目录和手动查询目录功能，以便及时获取到下级平台新共享的设备；
l 举例说明
上级--->下级上级向下级发送目录查询请求

MESSAGE sip:62010201002000000001@10.129.4.13:5080 SIP/2.0
Via: SIP/2.0/UDP 172.16.3.26:7100;rport;branch=z9hG4bK3420267366
From: ;tag=500485300
To:
Call-ID: 124958176
CSeq: 20 MESSAGE
Content-Type: Application/MANSCDP+xml
Max-Forwards: 70
User-Agent: Hikvision
Content-Length: 127

Catalog
8903查询消息的序号，下级平台返回的查询响应消息的序号必须和该序号一致，以便标识是该查询的响应。

62010201002000000001下级平台ID
（上级平台查询下级平台共享设备）

下级--->上级
SIP/2.0 200 OK
To: ;tag=6840_661_3935882
Via: SIP/2.0/UDP 172.16.3.26:7100;rport=7100;branch=z9hG4bK3420267366;received=10.130.140.82
CSeq: 20 MESSAGE
Call-ID: 124958176
From: ;tag=500485300
Content-Length: 0

下级--->上级下级向上级返回目录查询响应

MESSAGE sip:62010000002000000001@10.130.140.82:7100 SIP/2.0
Call-ID: 3c2375ee902cdef0c10aa9fe2001e4f9@10.129.4.13
CSeq: 1 MESSAGE
From: ;tag=7373_661_6058761
To:
Max-Forwards: 70
Content-Type: application/MANSCDP+XML
Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343309
Content-Length: 746

Catalog
8903和查询请求的序号相同

62010201002000000001下级平台ID

2下级平台共享设备的总数

62010401001310004766共享设备01的ID

共享镜头01
hik
1
1
62010201002000000001
tal>
1
1
400
62010201002000000001下级平台ID

1
0

0
0.000000
0000000
ON共享设备01的状态，
ON： 镜头上线
OFF：镜头下线

上级--->下级
SIP/2.0 200 OK
Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343309
From: ;tag=7373_661_6058761
To: p:62010000002000000001@10.130.140.82>;tag=3437297396
Call-ID: 3c2375ee902cdef0c10aa9fe2001e4f9@10.129.4.13
CSeq: 1 MESSAGE
User-Agent: Hikvision
Content-Length: 0

下级--->上级下级向上级返回目录查询响应。

MESSAGE sip:62010000002000000001@10.130.140.82:7100 SIP/2.0
Call-ID: 7e4db4fa734be13c979511f6a8e84df6@10.129.4.13
CSeq: 1 MESSAGE
From: ;tag=5183_661_6342350
To:
Max-Forwards: 70
Content-Type: application/MANSCDP+XML
Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6342350_661_77897377155966919994
Content-Length: 749

Catalog
8903和查询请求的序号相同

62010201002000000001
2

62010501001310005076共享设备02的ID

共享镜头02
ufacturer>hik
1
1
62010201002000000001
>
1
0

0
0.000000
0.000000
ON

上级--->下级
SIP/2.0 200 OK
Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6342350_661_77897377155966919994
From: ;tag=5183_661_6342350
To: ;tag=3651745157
Call-ID: 7e4db4fa734be13c979511f6a8e84df6@10.129.4.13
CSeq: 1 MESSAGE
User-Agent: Hikvision
Content-Length: 0
备注：
上级平台收到下级平台目录查询响应消息后，根据SumNum字段确定共享设备数量，并累计DeviceList的Item数量，当累计数量和SumNum字段值相等时，则说明查询结束。

1.4 共享设备状态变更通知
l 下级平台共享设备状态变更时通知给上级平台；
l 举例说明：
下级--->上级
NOTIFY sip:62010000002000000001@10.130.140.82:7100 SIP/2.0
Call-ID: cd0cba2fc6dc8baa82738ffdf4f13add@10.129.4.13
CSeq: 1 NOTIFY
From: 201002000000001@10.129.4.13>;tag=7373_661_6058761
To:
Max-Forwards: 70
Content-Type: application/MANSCDP+XML
Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343309
Content-Length: 747

<Response>
Catalog
3
62010201002000000001
1

62010401001310004766
共享镜头01
hik
1
1
62010201002000000001
ss>
0
0.000000
0.000000
OFF“共享设备01“下线

上级--->下级
SIP/2.0 200 OK
Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343309
From: <sip:62010201002000000001@10.129.4.13>;tag=7373_661_6058761
To: ;tag=3437297396
Call-ID: cd0cba2fc6dc8baa82738ffdf4f13add@10.129.4.13
CSeq: 1 NOTIFY
User-Agent: Hikvision
Content-Type: application/MANSCDP+XML
Content-Length: 171

ncoding="GB2312" ?>

Catalog
3
62010201002000000001
OK

1.5 实时视频
l 上级平台请求下级共享镜头视频；
l 举例说明：
上级--->下级
INVITE sip:62010201001310000033请求视频的共享镜头ID
@10.129.4.21:5080 SIP/2.0
Via: SIP/2.0/UDP 10.130.14082:7100;rport;branch=z9hG4bK1642482264
From: ;tag=3983823828
To:
Call-ID: 2081113375
CSeq: 20 INVITE
Contact:
Content-Type: Application/SDP
Max-Forwards: 70

User-Agent: Hikvision
Subject: 62010201001310000033请求视频的共享镜头ID
:0,62010000002000000001:0
Content-Length: 220

v=0
o=62010201001310000033 0 0 IN IP4 10.130.140.82
s=Play视频请求方式：
Play： 实时视频
Playback： 录像回放
Download： 录像下载

c=IN IP4 10.130.140.82上级平台的媒体服务器IP

t=0 0
m=video 5400上级平台接受视频流的端口
RTP/AVP媒体传输方式：
RTP/AVP： RTP基于UDP方式
RTP/AVP/TCP： RTP基于UDP方式
96 97 98
a=rtpmap:96PS流的PT值
PS/90000
a=rtpmap:97 MPEG4/90000
a=rtpmap:98 H264/90000
a=recvonly
y=0999999999

下级--->上级
SIP/2.0 100 Trying
To:
Via: SIP/2.0/UDP 10.130140.82:7100;rport=7100;branch=z9hG4bK1642482264;received=10.130.140.82
CSeq: 20 INVITE
Call-ID: 2081113375
From: ;tag=3983823828
Content-Length: 0

下级--->上级
SIP/2.0 200 OK
To: ;tag=3222_661_8389915
Via: SIP/2.0/UDP 10.130.140.82:7100;rport=7100;branch=z9hG4bK1642482264;received=10.130.140.82
CSeq: 20 INVITE
Call-ID: 2081113375
From: ;tag=3983823828
Contact:
Content-Type: application/sdp
Content-Length: 277

v=0
o=huawei 1375083193016081 0 IN IP4 10.129.4.21
s=Play
c=IN IP4 10.129.4.21下级平台的媒体服务器IP

t=0 0
m=video 6016 下级平台发送视频流的端口
RTP/AVP视频传输方式：
RTP/AVP： RTP基于UDP方式
RTP/AVP/TCP： RTP基于UDP方式
96视频流PT值

a=rtpmap:96 PS/90000
a=sendonly
m=audio 6018 RTP/AVP 100
a=rtpmap:100 G711U
a=sendonly
a=username:admin
a=password:123456
y=0999999999
f=v/2/1/0/1/0a///

上级--->下级
ACK sip:10.129.4.21:5080 SIP/2.0
Via: SIP/2.0/UDP 10.130.140.82:7100;rport;branch=z9hG4bK825701276
From: ;tag=3983823828
To: ;tag=3222_6618389915
Call-ID: 2081113375
CSeq: 20 ACK
Contact:
Max-Forwards: 70
User-Agent: Hikvision
Content-Length: 0

上级--->下级
BYE sip:10.129.4.21:5080 SIP/2.0
Via: SIP/2.0/UDP 10.130.140.82:7100;rport;branch=z9hG4bK825701276
From: 00001@10.130.140.82:7100>;tag=3983823828
To: ;tag=3222_661_8389915
Call-ID: 2081113375
CSeq: 21 BYE
Contact:
Max-Forwards: 70
User-Agent: Hikvision
Content-Length: 0

1.6 云台控制
l 上级平台向下级平台发送云台控制请求；
l 举例说明：
上级--->下级
MESSAGE sip:62010201001310000033@10.129.4.21:5080 SIP/2.0
Via: SIP/2.0/UDP 10.130.140.82:7100;rport;branch=z9hG4bK2582872259
From: ;tag=3773325418
To:
Call-ID: 1813198482
CSeq: 20 MESSAGE
Content-Type: Application/MANSCDP+xml
Max-Forwards: 70
User-Agent: Hikvision
Content-Length: 298

DeviceControl
8
62010201001310000033云台控制的设备ID

a50f4d0000000001云台控制命令，
详细参考28181规范的附录A.3
d>

150
0
0
0
0

下级--->上级
SIP/2.0 200 OK
To: ;tag=5541_661_3619007
Via: SIP/2.0/UDP 10.130.140.82:7100;rport=7100;branch=z9hG4bK2582872259;received=10.130.140.82
CSeq: 20 MESSAGE
Call-ID: 1813198482
From: ;tag=3773325418
Content-Length: 0
1.7 录像查询
l 上级平台向下级平台查询录像请求；
l 举例说明：
上级--->下级录像查询请求

MESSAGE sip:62010201002000000001@10.129.4.13:5080 SIP/2.0
Via: SIP/2.0/UDP 172.16.3.26:7100;rport;branch=z9hG4bK442669892
From: ;tag=2630907596
To:
Call-ID: 3317287086
CSeq: 20 MESSAGE
Content-Type: Application/MANSCDP+xml
Max-Forwards: 70
User-Agent: Hikvision
Content-Length: 258

RecordInfo
1894查询请求序号

62010201001310003793查询的镜头ID

2013-11-07T00:00:00开始时间

2013-11-07T23:59:59结束时间

all查询录像类型

1
ry>

下级--->上级
SIP/2.0 200 OK
To: ;tag=2792_661_3882029
Via: SIP/2.0/UDP 172.16.3.26:7100;rport=7100;branch=z9hG4bK442669892;received=10.130.140.82
CSeq: 20 MESSAGE
Call-ID: 3317287086
From: ;tag=2630907596
Content-Length: 0

下级--->上级录像查询响应

MESSAGE sip:62010000002000000001@10.130.140.82:7100 SIP/2.0
Call-ID: 8330948e40f07059c8cdccdc02d5aefd@10.129.4.13
CSeq: 1 MESSAGE
From: ;tag=3548_661_3776709
To:
Max-Forwards: