平台对接接口详解

28181平台对接接口详解1信令接口

1.1平台注册

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

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

举例说明：

下级--->上级

REGISTER sip:6200001@:7100 SIP/

Call-ID: c82dee890ea56d9d332fe4a5dbd2772c@

CSeq: 1 REGISTER

From: ;tag=5923_661_2647061

To:

Max-Forwards: 70

Contact:

Expires: 3600

Via: SIP/UDP :5080;branch=z9hG4bK2647061_661_0081

Content-Length: 0

上级--->下级

SIP/ 401 Unauthorized

Via: SIP/UDP :5080;branch=z9hG4bK2647061_661_0081

From: ;tag=5923_661_2647061

To: ;tag=9

Call-ID: c82dee890ea56d9d332fe4a5dbd2772c@

CSeq: 1 REGISTER

WWW-Authenticate: Digest realm="1234",

nonce="7104983f5477dd30a65167b28553df65",

opaque="f10efb1af3e8a362bcda73ce", algorithm=MD5

User-Agent: Hikvision

Expires: 3600

Content-Length: 0

下级--->上级

REGISTER sip:6200001@:7100 SIP/

Call-ID: c82dee890ea56d9d332fe4a5dbd2772c@

CSeq: 2 REGISTER

From: ;tag=5923_661_2647061

To:

Max-Forwards: 70

Contact:

Via: SIP/UDP :5080;branch=z9hG4bK2647061_661_5136301 Authorization: Digest

username="admin",realm="1234",nonce="7104983f5477dd30a65167b

28553df65",uri="sip:6200001@:7100",response="ceb3a5fb0c6d66d 24a7e77b5",algorithm=MD5,opaque="f10efb1af3e8a362bcda73ce"

Expires: 3600

Content-Length: 0

上级--->下级

SIP/ 200 OK

Via: SIP/UDP :5080;branch=z9hG4bK2647061_661_5136301

From: ;tag=5923_661_2647061

To: ;tag=9

Call-ID: c82dee890ea56d9d332fe4a5dbd2772c@

CSeq: 2 REGISTER

Contact:

User-Agent: Hikvision

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

Content-Length: 0

1.2平台心跳保活

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

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

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

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

举例说明：

下级--->上级

MESSAGE sip:6200001@:7100 SIP/

Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d5@ CSeq: 1 MESSAGE

From: ;tag=0673_661_2850021

To:

Max-Forwards: 70

Content-Type: application/Xml

Via: SIP/UDP :5080;branch=z9hG4bK2850021_661_4200 Content-Length: 138

Keepalive

43

6200001

OK

上级--->下级

SIP/ 200 OK

Via: SIP/UDP :5080;branch=z9hG4bK2850021_661_4200 From: ;tag=0673_661_2850021

To: ;tag=22

Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d5@

CSeq: 1 MESSAGE

Content-Length: 0

1.3平台设备共享

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

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

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

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

举例说明

上级--->下级

MESSAGE sip:6200001@:5080 SIP/

Via: SIP/UDP :7100;rport;branch=z9hG4bK66

From: ;tag=0

To:

Call-ID: 6

CSeq: 20 MESSAGE

Content-Type: Application/MANSCDP+xml

Max-Forwards: 70

User-Agent: Hikvision

Content-Length: 127

Catalog

8903

6200001

下级--->上级

SIP/ 200 OK

To: ;tag=6840_661_3935882

Via: SIP/UDP :7100;rport=7100;branch=z9hG4bK66;received= CSeq: 20 MESSAGE

Call-ID: 6

From: ;tag=0

Content-Length: 0

下级--->上级

MESSAGE sip:6200001@:7100 SIP/

Call-ID: 3c2375ee902cdef0c10aa9fe2001e4f9@

CSeq: 1 MESSAGE

From: ;tag=7373_661_6058761

To:

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/ 200 OK

Via: SIP/UDP :5080;branch=z9hG4bK6058761_661_6343309 From: ;tag=7373_661_6058761

To: ;tag=96

Call-ID: 3c2375ee902cdef0c10aa9fe2001e4f9@

CSeq: 1 MESSAGE

User-Agent: Hikvision

Content-Length: 0

下级--->上级

MESSAGE sip:6200001@:7100 SIP/

Call-ID: 7e4db4fa734be13c979511f6a8e84df6@ CSeq: 1 MESSAGE

From: ;tag=5183_661_6342350 To:

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/ 200 OK

Via: SIP/UDP :5080;branch=z9hG4bK6342350_661_

From: ;tag=5183_661_6342350

To: ;tag=57

Call-ID: 7e4db4fa734be13c979511f6a8e84df6@

CSeq: 1 MESSAGE

User-Agent: Hikvision

Content-Length: 0

备注：

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

1.4共享设备状态变更通知

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

举例说明：

下级--->上级

NOTIFY sip:6200001@:7100 SIP/

Call-ID: cd0cba2fc6dc8baa82738ffdf4f13add@

CSeq: 1 NOTIFY

From: ;tag=7373_661_6058761

To:

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/ 200 OK

Via: SIP/UDP :5080;branch=z9hG4bK6058761_661_6343309 From: ;tag=7373_661_6058761

To: ;tag=96

Call-ID: cd0cba2fc6dc8baa82738ffdf4f13add@

CSeq: 1 NOTIFY

User-Agent: Hikvision

Content-Type: application/MANSCDP+XML

Content-Length: 171

Catalog

3

6200001

OK

1.5实时视频

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

举例说明：

上级--->下级

INVITE sip:6200033@:5080 SIP/

Via: SIP/UDP :7100;rport;branch=z9hG4bK64

From: ;tag=28

To:

Call-ID: 75

CSeq: 20 INVITE

Contact:

Content-Type: Application/SDP

Max-Forwards: 70

User-Agent: Hikvision

Subject: 6200033:0,6200001:0

Content-Length: 220

v=0

o=6200033 0 0 IN IP4

s=Play

c=IN IP4

t=0 0

m=video 5400RTP/AVP 96 97 98

a=rtpmap:96 PS/90000

a=rtpmap:97 MPEG4/90000

a=rtpmap:98 H264/90000

a=recvonly

y=09

下级--->上级

SIP/ 100 Trying

To:

Via: SIP/UDP :7100;rport=7100;branch=z9hG4bK64;received= CSeq: 20 INVITE

Call-ID: 75

From: ;tag=28

Content-Length: 0

下级--->上级

SIP/ 200 OK

To: ;tag=3222_661_8389915

Via: SIP/UDP :7100;rport=7100;branch=z9hG4bK64;received= CSeq: 20 INVITE

Call-ID: 75

From: ;tag=28

Contact:

Content-Type: application/sdp

Content-Length: 277

v=0

o=huawei 081 0 IN IP4

s=Play

c=IN IP4

t=0 0

m=video 6016RTP/AVP96

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=09

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

上级--->下级

ACK sip::5080 SIP/

Via: SIP/UDP :7100;rport;branch=z9hG4bK6 From: ;tag=28

To: ;tag=3222_661_8389915 Call-ID: 75

CSeq: 20 ACK

Contact:

Max-Forwards: 70

User-Agent: Hikvision

Content-Length: 0

上级--->下级

BYE sip::5080 SIP/

Via: SIP/UDP :7100;rport;branch=z9hG4bK6 From: ;tag=28

To: ;tag=3222_661_8389915 Call-ID: 75

CSeq: 21 BYE

Contact:

Max-Forwards: 70

User-Agent: Hikvision

Content-Length: 0

1.6云台控制

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

举例说明：

上级--->下级

MESSAGE sip:6200033@:5080 SIP/

Via: SIP/UDP :7100;rport;branch=z9hG4bK59

From: ;tag=18

To:

Call-ID: 82

CSeq: 20 MESSAGE

Content-Type: Application/MANSCDP+xml

Max-Forwards: 70

User-Agent: Hikvision

Content-Length: 298

DeviceControl

8

6200033

a50f4d0000000001

150

0

0

0

0

下级--->上级

SIP/ 200 OK

To: ;tag=5541_661_3619007

Via: SIP/UDP :7100;rport=7100;branch=z9hG4bK59;received=

CSeq: 20 MESSAGE

Call-ID: 82

From: ;tag=18

Content-Length: 0

1.7录像查询

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

举例说明：

上级--->下级

MESSAGE sip:6200001@:5080 SIP/

Via: SIP/UDP :7100;rport;branch=z9hG4bK2 From: ;tag=96

To:

Call-ID: 86

CSeq: 20 MESSAGE

Content-Type: Application/MANSCDP+xml

Max-Forwards: 70

User-Agent: Hikvision

Content-Length: 258

RecordInfo

1894

6203793

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

all

1

下级--->上级