28181平台对接接口详解.doc

1、Comment w1: 上级平台 IDComment w2: 下级平台 ID文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 1页, 共 14页28181平台对接接口详解1 信令接口1.1 平台注册 下级平台主动向上级平台注册； 注册鉴权信息（用户名和密码）由上级提供； 举例说明：下级 -上级REGISTER sip:6201000000200000000110.130.140.82:7100 SIP/2.0Call-ID: c82dee890ea56d9d332fe4a5dbd2772c10.129.4.21CSeq: 1 REGISTERFrom: ;tag=592

2、3_661_2647061To: Max-Forwards: 70Contact: Expires: 3600Via: SIP/2.0/UDP 10.129.4.21:5080;branch=z9hG4bK2647061_661_55795848069639126081Content-Length: 0上级 -下级SIP/2.0 401 UnauthorizedVia: SIP/2.0/UDP 10.129.4.21:5080;branch=z9hG4bK2647061_661_55795848069639126081From: ;tag=5923_661_2647061To: ;tag=31

3、6765889Call-ID: c82dee890ea56d9d332fe4a5dbd2772c10.129.4.21CSeq: 1 REGISTERWWW-Authenticate: Digest realm=“1234“, nonce=“7104983f5477dd30a65167b28553df65“, opaque=“f10efb1af3e8a362bcda7465284073ce“, algorithm=MD5User-Agent: HikvisionExpires: 3600Content-Length: 0下级 -上级REGISTER sip:620100000020000000

4、0110.130.140.82:7100 SIP/2.0Call-ID: c82dee890ea56d9d332fe4a5dbd2772c10.129.4.21CSeq: 2 REGISTERFrom: ;tag=5923_661_2647061To: Comment w3: 上级平台提供鉴权信息时指定的用户。Comment w4: 下级平台根据上级平台返回的挑战字和上级平台的鉴权信息，用 MD5算法计算得到。文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 2页, 共 14页Max-Forwards: 70Contact: Via: SIP/2.0/UDP 10.12

5、9.4.21:5080;branch=z9hG4bK2647061_661_19459966820285136301Authorization: Digest username=“admin“,realm=“1234“,nonce=“7104983f5477dd30a65167b28553df65“,uri=“sip:6201000000200000000110.130.140.82:7100“,response=“ceb3a346523335fb0c6d66d24a7e77b5“,algorithm=MD5,opaque=“f10efb1af3e8a362bcda7465284073ce“E

6、xpires: 3600Content-Length: 0上级 -下级SIP/2.0 200 OKVia: SIP/2.0/UDP 10.129.4.21:5080;branch=z9hG4bK2647061_661_19459966820285136301From: ;tag=5923_661_2647061To: ;tag=300030239Call-ID: c82dee890ea56d9d332fe4a5dbd2772c10.129.4.21CSeq: 2 REGISTERContact: User-Agent: HikvisionDate: 2013-07-27T14:45:39Con

7、tent-Length: 01.2 平台心跳保活 下级平台定期向上级平台发心跳消息； 定期时间可配置，上下级配置一致； 上级平台连续三次未收到下级心跳消息，则认为下级平台离线； 下级平台连续三次未收到心跳响应，则认为上级平台离线； 举例说明：下级 -上级MESSAGE sip:6201000000200000000110.130.140.82:7100 SIP/2.0Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d510.129.4.13CSeq: 1 MESSAGEFrom: ;tag=0673_661_2850021To: Max-Forwards: 70C

8、ontent-Type: application/XmlVia: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK2850021_661_35032844903563514200Content-Length: 138Comment w5: 下级平台 IDComment w6: 上级向下级发送目录查询请求文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 3页, 共 14页Keepalive4362010201002000000001OK上级 -下级SIP/2.0 200 OKVia: SIP/2.0/UDP 10.129.4.13:5

9、080;branch=z9hG4bK2850021_661_35032844903563514200From: ;tag=0673_661_2850021To: ;tag=1421372822Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d510.129.4.13CSeq: 1 MESSAGEContent-Length: 01.3 平台设备共享 下级平台将设备共享给上级平台，共享关系临时保存在本地数据库； 下级平台收到上级平台的目录查询消息时，返回共享给该上级平台的所有共享设备信息； 上级平台收到目录查询响应结果后，根据设备编码或自定义方式给设备建立目录； 上

10、级平台最好支持定期查询目录和手动查询目录功能，以便及时获取到下级平台新共享的设备； 举例说明上级 -下级MESSAGE sip:6201020100200000000110.129.4.13:5080 SIP/2.0Via: SIP/2.0/UDP 172.16.3.26:7100;rport;branch=z9hG4bK3420267366From: ;tag=500485300To: Call-ID: 124958176CSeq: 20 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 70User-Agent: Hikvi

11、sionContent-Length: 127CatalogComment w7: 查询消息的序号，下级平台返回的查询响应消息的序号必须和该序号一致，以便标识是该查询的响应。Comment w8: 下级平台 ID（上级平台查询下级平台共享设备）Comment w9: 下级向上级返回目录查询响应Comment w10: 和查询请求的序号相同Comment w11: 下级平台 IDComment w12: 下级平台共享设备的总数Comment w13: 标识当前响应消息里包括的共享设备信息的数量（由于SIP消息长度不能超过 1500字节，建议一次只返回一个共享设备信息）Comment w14: 共

12、享设备 01的 ID文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 4页, 共 14页890362010201002000000001下级 -上级SIP/2.0 200 OKTo: ;tag=6840_661_3935882Via: SIP/2.0/UDP 172.16.3.26:7100;rport=7100;branch=z9hG4bK3420267366;received=10.130.140.82CSeq: 20 MESSAGECall-ID: 124958176From: ;tag=500485300Content-Length: 0下级 -上级MESSAG

13、E sip:6201000000200000000110.130.140.82:7100 SIP/2.0Call-ID: 3c2375ee902cdef0c10aa9fe2001e4f910.129.4.13CSeq: 1 MESSAGEFrom: ;tag=7373_661_6058761To: Max-Forwards: 70Content-Type: application/MANSCDP+XMLVia: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343309Content-Length: 7

14、46Catalog890362010201002000000001262010401001310004766共享镜头01hik11620102010020000000011011400Comment w15: 下级平台 IDComment w16: 共享设备 01的状态，ON： 镜头上线OFF：镜头下线Comment w17: 下级向上级返回目录查询响应。Comment w18: 和查询请求的序号相同Comment w19: 共享设备 02的 ID文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 5页, 共 14页620102010020000000011000.000

15、0000.000000ON上级 -下级SIP/2.0 200 OKVia: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343309From: ;tag=7373_661_6058761To: ;tag=3437297396Call-ID: 3c2375ee902cdef0c10aa9fe2001e4f910.129.4.13CSeq: 1 MESSAGEUser-Agent: HikvisionContent-Length: 0下级 -上级MESSAGE sip:620100000020000000

16、0110.130.140.82:7100 SIP/2.0Call-ID: 7e4db4fa734be13c979511f6a8e84df610.129.4.13CSeq: 1 MESSAGEFrom: ;tag=5183_661_6342350To: Max-Forwards: 70Content-Type: application/MANSCDP+XMLVia: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6342350_661_77897377155966919994Content-Length: 749Catalog890362010201002

17、000000001262010501001310005076共享镜头02文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 6 页, 共 14 页hik11620102010020000000011011400620102010020000000011000.0000000.000000ON上级 -下级SIP/2.0 200 OKVia: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6342350_661_77897377155966919994From: ;tag=5183_661_6342350To: ;tag=3651745

18、157Call-ID: 7e4db4fa734be13c979511f6a8e84df610.129.4.13CSeq: 1 MESSAGEUser-Agent: HikvisionContent-Length: 0备注：上级平台收到下级平台目录查询响应消息后，根据SumNum字段确定共享设备数量，并累计DeviceList的Item数量，当累计数量和SumNum字段值相等时，则说明查询结束。1.4 共享设备状态变更通知 下级平台共享设备状态变更时通知给上级平台； 举例说明：下级 -上级NOTIFY sip:6201000000200000000110.130.140.82:7100 SIP/

19、2.0Call-ID: cd0cba2fc6dc8baa82738ffdf4f13add10.129.4.13Comment w20: “共享设备 01“下线文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 7页, 共 14页CSeq: 1 NOTIFYFrom: ;tag=7373_661_6058761To: Max-Forwards: 70Content-Type: application/MANSCDP+XMLVia: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343

20、309Content-Length: 747Catalog362010201002000000001162010401001310004766共享镜头01hik11620102010020000000011011400620102010020000000011000.0000000.000000OFF上级 -下级SIP/2.0 200 OKVia: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343309From: ;tag=7373_661_6058761Comment w21: 请求视频的共享镜头

21、IDComment w22: 请求视频的共享镜头IDComment w23: 视频请求方式：Play： 实时视频Playback： 录像回放Download： 录像下载Comment w24: 上级平台的媒体服务器 IPComment w25: 上级平台接受视频流的端口Comment w26: 媒体传输方式：RTP/AVP： RTP基于 UDP方式RTP/AVP/TCP： RTP基于 UDP方式Comment w27: PS流的 PT值文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 8页, 共 14页To: ;tag=3437297396Call-ID: cd0cba

22、2fc6dc8baa82738ffdf4f13add10.129.4.13CSeq: 1 NOTIFYUser-Agent: HikvisionContent-Type: application/MANSCDP+XMLContent-Length: 171Catalog362010201002000000001OK1.5 实时视频 上级平台请求下级共享镜头视频； 举例说明：上级 -下级INVITE sip:6201020100131000003310.129.4.21:5080 SIP/2.0Via: SIP/2.0/UDP 10.130.140.82:7100;rport;branch=z9

23、hG4bK1642482264From: ;tag=3983823828To: Call-ID: 2081113375CSeq: 20 INVITEContact: Content-Type: Application/SDPMax-Forwards: 70User-Agent: HikvisionSubject: 62010201001310000033:0,62010000002000000001:0Content-Length: 220v=0o=62010201001310000033 0 0 IN IP4 10.130.140.82s=Playc=IN IP4 10.130.140.82

24、t=0 0m=video 5400 RTP/AVP 96 97 98a=rtpmap:96 PS/90000a=rtpmap:97 MPEG4/90000a=rtpmap:98 H264/90000Comment w28: 下级平台的媒体服务器 IPComment w29: 下级平台发送视频流的端口Comment w30: 视频传输方式：RTP/AVP： RTP基于 UDP方式RTP/AVP/TCP： RTP基于 UDP方式Comment w31: 视频流 PT值文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 9页, 共 14页a=recvonlyy=09999999

25、99下级 -上级SIP/2.0 100 TryingTo: Via: SIP/2.0/UDP 10.130.140.82:7100;rport=7100;branch=z9hG4bK1642482264;received=10.130.140.82CSeq: 20 INVITECall-ID: 2081113375From: ;tag=3983823828Content-Length: 0下级 -上级SIP/2.0 200 OKTo: ;tag=3222_661_8389915Via: SIP/2.0/UDP 10.130.140.82:7100;rport=7100;branch=z9hG4

26、bK1642482264;received=10.130.140.82CSeq: 20 INVITECall-ID: 2081113375From: ;tag=3983823828Contact: Content-Type: application/sdpContent-Length: 277v=0o=huawei 1375083193016081 0 IN IP4 10.129.4.21s=Playc=IN IP4 10.129.4.21t=0 0m=video 6016 RTP/AVP 96a=rtpmap:96 PS/90000a=sendonlym=audio 6018 RTP/AVP

27、 100a=rtpmap:100 G711Ua=sendonlya=username:admina=password:123456y=0999999999f=v/2/1/0/1/0a/上级 -下级ACK sip:10.129.4.21:5080 SIP/2.0文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 10 页, 共 14 页Via: SIP/2.0/UDP 10.130.140.82:7100;rport;branch=z9hG4bK825701276From: ;tag=3983823828To: ;tag=3222_661_8389915Call-ID: 2

28、081113375CSeq: 20 ACKContact: Max-Forwards: 70User-Agent: HikvisionContent-Length: 0上级 -下级BYE sip:10.129.4.21:5080 SIP/2.0Via: SIP/2.0/UDP 10.130.140.82:7100;rport;branch=z9hG4bK825701276From: ;tag=3983823828To: ;tag=3222_661_8389915Call-ID: 2081113375CSeq: 21 BYEContact: Max-Forwards: 70User-Agent:

29、 HikvisionContent-Length: 01.6 云台控制 上级平台向下级平台发送云台控制请求； 举例说明：上级 -下级MESSAGE sip:6201020100131000003310.129.4.21:5080 SIP/2.0Via: SIP/2.0/UDP 10.130.140.82:7100;rport;branch=z9hG4bK2582872259From: ;tag=3773325418To: Call-ID: 1813198482CSeq: 20 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 7

30、0User-Agent: HikvisionContent-Length: 298DeviceControlComment w32: 云台控制的设备 IDComment w33: 云台控制命令，详细参考 28181规范的附录 A.3Comment w34: 录像查询请求Comment w35: 查询请求序号文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 11页, 共 14页862010201001310000033a50f4d00000000011500000下级 -上级SIP/2.0 200 OKTo: ;tag=5541_661_3619007Via: SIP/2

31、.0/UDP 10.130.140.82:7100;rport=7100;branch=z9hG4bK2582872259;received=10.130.140.82CSeq: 20 MESSAGECall-ID: 1813198482From: ;tag=3773325418Content-Length: 01.7 录像查询 上级平台向下级平台查询录像请求； 举例说明：上级 -下级MESSAGE sip:6201020100200000000110.129.4.13:5080 SIP/2.0Via: SIP/2.0/UDP 172.16.3.26:7100;rport;branch=z9h

32、G4bK442669892From: ;tag=2630907596To: Call-ID: 3317287086CSeq: 20 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 70User-Agent: HikvisionContent-Length: 258RecordInfo1894Comment w36: 查询的镜头 IDComment w37: 开始时间Comment w38: 结束时间Comment w39: 查询录像类型Comment w40: 录像查询响应Comment w41: 录像总数量Comment w

33、42: 当前响应消息里的录像 Item数量Comment w43: 录像的开始时间Comment w44: 录像的结束时间Comment w45: 录像类型文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 12页, 共 14页620102010013100037932013-11-07T00:00:002013-11-07T23:59:59all1下级 -上级SIP/2.0 200 OKTo: ;tag=2792_661_3882029Via: SIP/2.0/UDP 172.16.3.26:7100;rport=7100;branch=z9hG4bK442669892

34、;received=10.130.140.82CSeq: 20 MESSAGECall-ID: 3317287086From: ;tag=2630907596Content-Length: 0下级 -上级MESSAGE sip:6201000000200000000110.130.140.82:7100 SIP/2.0Call-ID: 8330948e40f07059c8cdccdc02d5aefd10.129.4.13CSeq: 1 MESSAGEFrom: ;tag=3548_661_3776709To: Max-Forwards: 70Content-Type: application/

35、MANSCDP+XMLContent-Encoding: UTF-8Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK3776709_661_96971908661700620966Content-Length: 566RecordInfo189462010201001310003793共享镜头01262010201001310003793共享镜头012013-11-06T23:17:322013-11-07T00:02:48timeHWPLATRD-931200007270101-VCURD-ch01_00000000029000000Comme

36、nt w46: 录像查询响应文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 13页, 共 14页上级 -下级SIP/2.0 200 OKVia: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK3776709_661_96971908661700620966From: ;tag=3548_661_3776709To: ;tag=145328459Call-ID: 8330948e40f07059c8cdccdc02d5aefd10.129.4.13CSeq: 1 MESSAGEUser-Agent: HikvisionConten

37、t-Length: 0下级 -上级MESSAGE sip:6201000000200000000110.130.140.82:7100 SIP/2.0Call-ID: 4436793e8669679354e09c5d72ffadfb10.129.4.13CSeq: 1 MESSAGEFrom: ;tag=3002_661_4301591To: Max-Forwards: 70Content-Type: application/MANSCDP+XMLContent-Encoding: UTF-8Via: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK430

38、1591_661_53287493766224157149Content-Length: 566RecordInfo189462010201001310003793共享镜头01262010201001310003793共享镜头012013-11-07T00:02:482013-11-07T00:48:03timeHWPLATRD-931200007270101-VCURD-ch01_00000000030000000文档名称 文档密级2018-9-30 华为保密信息,未经授权禁止扩散 第 14 页, 共 14 页上级 -下级SIP/2.0 200 OKVia: SIP/2.0/UDP 10.129.4.13:5080;branch=z9hG4bK4301591_661_53287493766224157149From: ;tag=3002_661_4301591To: ;tag=608251420Call-ID: 4436793e8669679354e09c5d72ffadfb10.129.4.13CSeq: 1 MESSAGEUser-Agent: HikvisionContent-Length: 0