平台对接接口详解

28181平台对接接口详解

信令接口

平台注册

●下级平台主动向上级平台注册；

●注册鉴权信息（用户名和密码）由上级提供；

●举例说明：

下级--->上级

REGISTERsip:SIP/2.0

Call-ID:

CSeq:1REGISTER

From:

To:

Max-Forwards:70

Contact:

Expires:3600

Via:SIP/2.0/UDP;branch

Content-Length:0

上级--->下级

SIP/2.0401Unauthorized

Via:SIP/2.0/UDP;branch

From:

To:

Call-ID:

CSeq:1REGISTER

WWW-Authenticate:Digestrealm="1234",nonce="7104983f5477dd30a65167b28553df65",algorithm=MD5 User-Agent:Hikvision

Expires:3600

Content-Length:0

下级--->上级

REGISTERSIP/2.0

Call-ID:

CSeq:2REGISTER

From:

To:

Max-Forwards:70

Contact:

Via:SIP/2.0/UDP;branch

Authorization:Digest username="admin",realm response="

Expires:3600

Content-Length:0

上级--->下级

SIP/2.0200OK

Via:SIP/2.0/UDP;branch

From:

To:

Call-ID:

CSeq:2REGISTER

Contact:

User-Agent:Hikvision

Date:2013-07-27T14:45:39

Content-Length:0

平台心跳保活

●下级平台定期向上级平台发心跳消息；

●定期时间可配置，上下级配置一致；

●上级平台连续三次未收到下级心跳消息，则认为下级平台离线；

●下级平台连续三次未收到心跳响应，则认为上级平台离线；

●举例说明：

下级--->上级

MESSAGESIP/2.0

Call-ID:

CSeq:1MESSAGE

From:

To:

Max-Forwards:70

Content-Type:application/Xml

Via:SIP/2.0/UDP;branch

Content-Length:138

Keepalive

43

OK

上级--->下级

SIP/2.0200OK

Via:SIP/2.0/UDP;branch

From:

To:

Call-ID:

CSeq:1MESSAGE

Content-Length:0

平台设备共享

●下级平台将设备共享给上级平台，共享关系临时保存在本地数据库；

●下级平台收到上级平台的目录查询消息时，返回共享给该上级平台的所有共享设备信息；

●上级平台收到目录查询响应结果后，根据设备编码或自定义方式给设备建立目录；

●上级平台最好支持定期查询目录和手动查询目录功能，以便及时获取到下级平台新共享的

设备；

●举例说明

上级--->下级

MESSAGESIP/2.0

Via:SIP/2.0/UDP;rport

From:

To:

Call-ID:

CSeq:20MESSAGE

Content-Type:Application/MANSCDP+xml

Max-Forwards:70

User-Agent:Hikvision

Content-Length:127

Catalog

8903

下级--->上级

SIP/2.0200OK

To:

Via:SIP/2.0/UDP;rport

CSeq:20MESSAGE

Call-ID:

From:

Content-Length:0

下级--->上级

MESSAGESIP/2.0

Call-ID:

CSeq:1MESSAGE

From:

To:

Max-Forwards:70

Content-Type:application/MANSCDP+XML

Via:SIP/2.0/UDP;branch

Content-Length:746

Catalog

8903

2

共享镜头01

hik

1

1

0

1

1

400

1

0

0

0.000000

0.000000

ON

上级--->下级

SIP/2.0200OK

Via:SIP/2.0/UDP;branch

From:

To:

Call-ID:

CSeq:1MESSAGE

User-Agent:Hikvision

Content-Length:0

下级--->上级

MESSAGESIP/2.0

Call-ID:

CSeq:1MESSAGE

From:

To:

Max-Forwards:70

Content-Type:application/MANSCDP+XML Via:SIP/2.0/UDP;branch

Content-Length:749

Catalog

8903

2

共享镜头02

hik

1

1

0

1

1

400

1

0

0

0.000000

0.000000

ON

上级--->下级

SIP/2.0200OK

Via:SIP/2.0/UDP;branch

From:

To:

Call-ID:

CSeq:1MESSAGE

User-Agent:Hikvision

Content-Length:0

备注：

上级平台收到下级平台目录查询响应消息后，根据SumNum字段确定共享设备数量，并累计DeviceList的Item数量，当累计数量和SumNum字段值相等时，则说明查询结束。

共享设备状态变更通知

●下级平台共享设备状态变更时通知给上级平台；

●举例说明：

下级--->上级

Call-ID:

CSeq:1NOTIFY

From:

To:

Max-Forwards:70

Content-Type:application/MANSCDP+XML Via:SIP/2.0/UDP;branch

Content-Length:747

Catalog

3

1

共享镜头01

hik

1

1

0

1

1

400

1

0

0

0.000000

0.000000

OFF

上级--->下级

SIP/2.0200OK

Via:SIP/2.0/UDP;branch

From:

To:

Call-ID:

User-Agent:Hikvision

Content-Type:application/MANSCDP+XML

Content-Length:171

Catalog

3

OK

实时视频

●上级平台请求下级共享镜头视频；

●举例说明：

上级--->下级

INVITEsip:SIP/2.0

Via:SIP/2.0/UDP;rport

From:

To:

Call-ID:

CSeq:20INVITE

Contact:

Content-Type:Application/SDP

Max-Forwards:70

User-Agent:Hikvision

Subject::0

Content-Length:220

v=0

00INIP4

s=Play

c=INIP4

t=00

m=video5400RTP/AVP969798

a=rtpmap:96PS/90000

a=rtpmap:97MPEG4/90000

a=rtpmap:98H264/90000

a=recvonly

下级--->上级

SIP/2.0100Trying

To:

Via:SIP/2.0/UDP;rport

CSeq:20INVITE

Call-ID:

From:

Content-Length:0

SIP/2.0200OK

To:

Via:SIP/2.0/UDP;rport CSeq:20INVITE

Call-ID:

From:

Contact:

Content-Type:application/sdp Content-Length:277

v=0

o=huawei0INIP4

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

f=v/2/1/0/1/0a///

上级--->下级ACKsipSIP/2.0

Via:SIP/2.0/UDP;rport From:

To:

Call-ID:

CSeq:20ACK

Contact:

Max-Forwards:70

User-Agent:Hikvision Content-Length:0

上级--->下级BYEsipSIP/2.0

Via:SIP/2.0/UDP;rport From:

To:

Call-ID:

CSeq:21BYE

Contact:

Max-Forwards:70

User-Agent:Hikvision

云台控制

●上级平台向下级平台发送云台控制请求；

●举例说明：

上级--->下级

MESSAGESIP/2.0

Via:SIP/2.0/UDP;rport

From:

To:

Call-ID:

CSeq:20MESSAGE

Content-Type:Application/MANSCDP+xml

Max-Forwards:70

User-Agent:Hikvision

Content-Length:298

DeviceControl

8

a50f4d0000000001

150

0

0

0

0

下级--->上级

SIP/2.0200OK

To:

Via:SIP/2.0/UDP;rport

CSeq:20MESSAGE

Call-ID:

From:

Content-Length:0

录像查询

●上级平台向下级平台查询录像请求；

●举例说明：

上级--->下级

MESSAGESIP/2.0

Via:SIP/2.0/UDP;rport

From:

To:

Call-ID:

CSeq:20MESSAGE

Content-Type:Application/MANSCDP+xml Max-Forwards:70

User-Agent:Hikvision

Content-Length:258

RecordInfo

1894

2013-11-07T00:00:00 2013-11-07T23:59:59 all

1

下级--->上级

SIP/2.0200OK

To:

Via:SIP/2.0/UDP;rport

CSeq:20MESSAGE

Call-ID:

From:

Content-Length:0

下级--->上级

MESSAGESIP/2.0

Call-ID:

CSeq:1MESSAGE

From:

To:

Max-Forwards:70

Content-Type:application/MANSCDP+XML Content-Encoding:UTF-8

Via:SIP/2.0/UDP;branch

Content-Length:566

RecordInfo

1894

共享镜头01

2

共享镜头01

2013-11-06T23:17:32

2013-11-07T00:02:48

time

上级--->下级

SIP/2.0200OK

Via:SIP/2.0/UDP;branch

From:

To:

Call-ID:

CSeq:1MESSAGE

User-Agent:Hikvision

Content-Length:0

下级--->上级

MESSAGESIP/2.0

Call-ID:

CSeq:1MESSAGE

From:

To:

Max-Forwards:70

Content-Type:application/MANSCDP+XML

Content-Encoding:UTF-8

Via:SIP/2.0/UDP;branch

Content-Length:566

RecordInfo

1894

共享镜头01

2

共享镜头01

2013-11-07T00:02:48

2013-11-07T00:48:03

time

上级--->下级

SIP/2.0200OK

Via:SIP/2.0/UDP;branch From:

To:

Call-ID:

CSeq:1MESSAGE User-Agent:Hikvision Content-Length:0