28181平台对接接口详解

1、精选文档28181平台对接接口详解1 信令接口1.1 平台注册l 下级平台主动向上级平台注册；l 注册鉴权信息（用户名和密码）由上级供应；l 举例说明：下级->上级REGISTER sip:62010000002000000001上级平台ID2:7100 SIP/2.0Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 1 REGISTERFrom: <sip:62010201002000000001下级平台ID1:5080>tag=5923_661_2647061To

2、: <sip:62010201002000000001:5080>Max-Forwards: 70Contact: <sip:62010201002000000001:5080>Expires: 3600Via: SIP/2.0/UDP 1:5080;branch=z9hG4bK2647061_661_55795848069639126081Content-Length: 0上级->下级SIP/2.0 401 UnauthorizedVia: SIP/2.0/UDP 1:5080;

3、branch=z9hG4bK2647061_661_55795848069639126081From: <sip:62010201002000000001:5080>tag=5923_661_2647061To: <sip:62010201002000000001:5080>tag=316765889Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 1 REGISTERWWW-Authenticate: Digest realm="1234"

4、, nonce="7104983f5477dd30a65167b28553df65", opaque="f10efb1af3e8a362bcda7465284073ce", algorithm=MD5User-Agent: HikvisionExpires: 3600Content-Length: 0下级->上级REGISTER sip:62010000002000000002:7100 SIP/2.0Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 2 R

5、EGISTERFrom: <sip:62010201002000000001:5080>tag=5923_661_2647061To: <sip:62010201002000000001:5080>Max-Forwards: 70Contact: <sip:62010201002000000001:5080>Via: SIP/2.0/UDP 1:5080;branch=z9hG4bK2647061_661_19459966820285136301Authorization:

6、 Digest username="admin"上级平台供应鉴权信息时指定的用户。,realm="1234",nonce="7104983f5477dd30a65167b28553df65",uri="sip:62010000002000000002:7100",response="ceb3a346523335fb0c6d66d24a7e77b5下级平台依据上级平台返回的挑战字和上级平台的鉴权信息，用MD5算法计算得到。",algorithm=MD5,opaque=&q

7、uot;f10efb1af3e8a362bcda7465284073ce"Expires: 3600Content-Length: 0上级->下级SIP/2.0 200 OKVia: SIP/2.0/UDP 1:5080;branch=z9hG4bK2647061_661_19459966820285136301From: <sip:62010201002000000001:5080>tag=5923_661_2647061To: <sip:62010201002000000001:5080>

8、;tag=300030239Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 2 REGISTERContact: <sip:62010201002000000001:5080>User-Agent: HikvisionDate: 2013-07-27T14:45:39Content-Length: 01.2 平台心跳保活l 下级平台定期向上级平台发心跳消息；l 定期时间可配置，上下级配置全都；l 上级平台连续三次未收到下级心跳消息，则认为下级平台离线；l 下级平台连续三次未收到心跳响应，则认为

9、上级平台离线；l 举例说明： 下级->上级MESSAGE sip:62010000002000000002:7100 SIP/2.0Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d53CSeq: 1 MESSAGEFrom: <sip:62010201002000000003>tag=0673_661_2850021To: <sip:62010000002000000002>Max-Forwards: 70Content-Type: app

10、lication/XmlVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK2850021_661_35032844903563514200Content-Length: 138<?xml version="1.0" ?><Notify><CmdType>Keepalive</CmdType><SN>43</SN><DeviceID>62010201002000000001下级平台ID</DeviceID><Status>O

11、K</Status></Notify>上级->下级SIP/2.0 200 OKVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK2850021_661_35032844903563514200From: <sip:62010201002000000003>tag=0673_661_2850021To: <sip:62010000002000000002>tag=1421372822Call-ID: 69c20964c5c9a8f0cc6cc5a73

12、81423d53CSeq: 1 MESSAGEContent-Length: 01.3 平台设备共享l 下级平台将设备共享给上级平台，共享关系临时保存在本地数据库；l 下级平台收到上级平台的名目查询消息时，返回共享给该上级平台的全部共享设备信息；l 上级平台收到名目查询响应结果后，依据设备编码或自定义方式给设备建立名目；l 上级平台最好支持定期查询名目和手动查询名目功能，以便准时猎取到下级平台新共享的设备；l 举例说明 上级->下级上级向下级发送名目查询恳求MESSAGE sip:62010201002000000003:5080 SIP/2.0

13、Via: SIP/2.0/UDP 6:7100;rport;branch=z9hG4bK3420267366From: <sip:62010000002000000000:7100>tag=500485300To: <sip:62010201002000000003:5080>Call-ID: 124958176CSeq: 20 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 70User-Agent: HikvisionContent-

14、Length: 127<?xml version="1.0"?><Query><CmdType>Catalog</CmdType><SN>8903查询消息的序号，下级平台返回的查询响应消息的序号必需和该序号全都，以便标识是该查询的响应。</SN><DeviceID>62010201002000000001下级平台ID（上级平台查询下级平台共享设备）</DeviceID></Query>下级->上级SIP/2.0 200 OKTo: <sip:6201020

15、1002000000003:5080>tag=6840_661_3935882Via: SIP/2.0/UDP 6:7100;rport=7100;branch=z9hG4bK3420267366;received=2CSeq: 20 MESSAGECall-ID: 124958176From: <sip:62010000002000000000:7100>tag=500485300Content-Length: 0下级->上级下级向上级返回名目查询响应MESSAGE sip:62

16、010000002000000002:7100 SIP/2.0Call-ID: 3c2375ee902cdef0c10aa9fe2001e4f93CSeq: 1 MESSAGEFrom: <sip:62010201002000000003>tag=7373_661_6058761To: <sip:62010000002000000002>Max-Forwards: 70Content-Type: application/MANSCDP+XMLVia: SIP/2.0/UDP 1

17、3:5080;branch=z9hG4bK6058761_661_61989619576009343309Content-Length: 746<?xml version="1.0" encoding="UTF-8" ?><Response><CmdType>Catalog</CmdType><SN>8903和查询恳求的序号相同</SN><DeviceID>62010201002000000001下级平台ID</DeviceID><Su

18、mNum>2下级平台共享设备的总数</SumNum><DeviceList Num="1标识当前响应消息里包括的共享设备信息的数量（由于SIP消息长度不能超过1500字节，建议一次只返回一个共享设备信息）"><Item><DeviceID>62010401001310004766共享设备01的ID</DeviceID><Name>共享镜头01</Name><Manufacturer>hik</Manufacturer><Owner>1</Own

19、er><Model>1</Model><CivilCode>62010201002000000001</CivilCode><Address>1</Address><Parental>0</Parental><CertNum>1</CertNum><Certifiable>1</Certifiable><ErrCode>400</ErrCode><ParentID>62010201002000000001下级平

20、台ID</ParentID><RegisterWay>1</RegisterWay><Secrecy>0</Secrecy><IPAddress></IPAddress><Port>0</Port><Longitude>0.000000</Longitude><Latitude>0.000000</Latitude><Status>ON共享设备01的状态，ON： 镜头上线OFF：镜头下线</Status></I

21、tem></DeviceList></Response>上级->下级SIP/2.0 200 OKVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6058761_661_61989619576009343309From: <sip:62010201002000000003>tag=7373_661_6058761To: <sip:62010000002000000002>tag=3437297396Call-ID: 3c2375ee902cd

22、ef0c10aa9fe2001e4f93CSeq: 1 MESSAGEUser-Agent: HikvisionContent-Length: 0下级->上级下级向上级返回名目查询响应。MESSAGE sip:62010000002000000002:7100 SIP/2.0Call-ID: 7e4db4fa734be13c979511f6a8e84df63CSeq: 1 MESSAGEFrom: <sip:62010201002000000003>tag=5183_661_6342350

23、To: <sip:62010000002000000002>Max-Forwards: 70Content-Type: application/MANSCDP+XMLVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6342350_661_77897377155966919994Content-Length: 749<?xml version="1.0" encoding="UTF-8" ?><Response><CmdType>Cat

24、alog</CmdType><SN>8903和查询恳求的序号相同</SN><DeviceID>62010201002000000001</DeviceID><SumNum>2</SumNum><DeviceList Num="1"><Item><DeviceID>62010501001310005076共享设备02的ID</DeviceID><Name>共享镜头02</Name><Manufacturer>h

25、ik</Manufacturer><Owner>1</Owner><Model>1</Model><CivilCode>62010201002000000001</CivilCode><Address>1</Address><Parental>0</Parental><CertNum>1</CertNum><Certifiable>1</Certifiable><ErrCode>400</ErrCo

26、de><ParentID>62010201002000000001</ParentID><RegisterWay>1</RegisterWay><Secrecy>0</Secrecy><IPAddress></IPAddress><Port>0</Port><Longitude>0.000000</Longitude><Latitude>0.000000</Latitude><Status>ON</Sta

27、tus></Item></DeviceList></Response>上级->下级SIP/2.0 200 OKVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6342350_661_77897377155966919994From: <sip:62010201002000000003>tag=5183_661_6342350To: <sip:62010000002000000002>tag=3651745157Call-ID:

28、7e4db4fa734be13c979511f6a8e84df63CSeq: 1 MESSAGEUser-Agent: HikvisionContent-Length: 0备注：上级平台收到下级平台名目查询响应消息后，依据SumNum字段确定共享设备数量，并累计DeviceList的Item数量，当累计数量和SumNum字段值相等时，则说明查询结束。1.4 共享设备状态变更通知l 下级平台共享设备状态变更时通知给上级平台；l 举例说明： 下级->上级NOTIFY sip:62010000002000000002:7100 SIP/2.0Cal

29、l-ID: cd0cba2fc6dc8baa82738ffdf4f13add3CSeq: 1 NOTIFYFrom: <sip:62010201002000000003>tag=7373_661_6058761To: <sip:62010000002000000002>Max-Forwards: 70Content-Type: application/MANSCDP+XMLVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6058761_661_619896

30、19576009343309Content-Length: 747<?xml version='1.0' encoding='UTF-8'?><Response><CmdType>Catalog</CmdType><SN>3</SN><DeviceID>62010201002000000001</DeviceID><SumNum>1</SumNum><DeviceList Num="1"><Item>

31、<DeviceID>62010401001310004766</DeviceID><Name>共享镜头01</Name><Manufacturer>hik</Manufacturer><Model>1</Model><Owner>1</Owner><CivilCode>62010201002000000001</CivilCode><Address>1</Address><Parental>0</Parenta

32、l><CertNum>1</CertNum><Certifiable>1</Certifiable><ErrCode>400</ErrCode><ParentID>62010201002000000001</ParentID><RegisterWay>1</RegisterWay><Secrecy>0</Secrecy><IPAddress></IPAddress><Port>0</Port><

33、;Longitude>0.000000</Longitude><Latitude>0.000000</Latitude><Status>OFF“共享设备01“下线</Status></Item></DeviceList></Response>上级->下级SIP/2.0 200 OKVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6058761_661_61989619576009343309From: <sip:62010201002

34、000000003>tag=7373_661_6058761To: <sip:62010000002000000002>tag=3437297396Call-ID: cd0cba2fc6dc8baa82738ffdf4f13add3CSeq: 1 NOTIFYUser-Agent: HikvisionContent-Type: application/MANSCDP+XMLContent-Length: 171<?xml version="1.0" encoding="GB

35、2312" ?><Response><CmdType>Catalog</CmdType><SN>3</SN><DeviceID>62010201002000000001</DeviceID><Result>OK</Result></Response>1.5 实时视频l 上级平台恳求下级共享镜头视频；l 举例说明： 上级->下级INVITE sip:62010201001310000033恳求视频的共享镜头ID1:5080 SIP/2.

36、0Via: SIP/2.0/UDP 2:7100;rport;branch=z9hG4bK1642482264From: <sip:62010000002000000002:7100>tag=3983823828To: <sip:620102010013100000331:5080>Call-ID: 2081113375CSeq: 20 INVITEContact: <sip:62010000002000000002:7100>Content-Type: Appl

37、ication/SDPMax-Forwards: 70User-Agent: HikvisionSubject: 62010201001310000033恳求视频的共享镜头ID:0,62010000002000000001:0Content-Length: 220v=0o=62010201001310000033 0 0 IN IP4 2s=Play视频恳求方式：Play： 实时视频Playback： 录像回放Download： 录像下载c=IN IP4 2上级平台的媒体服务器IPt=0 0m=video 5400上级平台接受视频流的端口 RTP

38、/AVP媒体传输方式：RTP/AVP： RTP基于UDP方式RTP/AVP/TCP： RTP基于UDP方式 96 97 98a=rtpmap:96PS流的PT值 PS/90000a=rtpmap:97 MPEG4/90000a=rtpmap:98 H264/90000a=recvonlyy=0999999999下级->上级SIP/2.0 100 TryingTo: <sip:620102010013100000331:5080>Via: SIP/2.0/UDP 2:7100;rport=7100;branch=z9hG4bK1642

39、482264;received=2CSeq: 20 INVITECall-ID: 2081113375From: <sip:62010000002000000002:7100>tag=3983823828Content-Length: 0下级->上级SIP/2.0 200 OKTo: <sip:620102010013100000331:5080>tag=3222_661_8389915Via: SIP/2.0/UDP 2:7100;rport=7100;branch=z

40、9hG4bK1642482264;received=2CSeq: 20 INVITECall-ID: 2081113375From: <sip:62010000002000000002:7100>tag=3983823828Contact: <sip:1:5080>Content-Type: application/sdpContent-Length: 277v=0o=huawei 1375083193016081 0 IN IP4 1s=Playc=IN IP4 10.129.4

41、.21下级平台的媒体服务器IPt=0 0m=video 6016 下级平台发送视频流的端口RTP/AVP视频传输方式：RTP/AVP： RTP基于UDP方式RTP/AVP/TCP： RTP基于UDP方式 96视频流PT值a=rtpmap:96 PS/90000a=sendonlym=audio 6018 RTP/AVP 100a=rtpmap:100 G711Ua=sendonlya=username:admina=password:123456y=0999999999f=v/2/1/0/1/0a/上级->下级ACK sip:1:5080 SIP/2.0Via: SI

42、P/2.0/UDP 2:7100;rport;branch=z9hG4bK825701276From: <sip:62010000002000000002:7100>tag=3983823828To: <sip:620102010013100000331:5080>tag=3222_661_8389915Call-ID: 2081113375CSeq: 20 ACKContact: <sip:62010000002000000002:7100>Max-Forwar

43、ds: 70User-Agent: HikvisionContent-Length: 0上级->下级BYE sip:1:5080 SIP/2.0Via: SIP/2.0/UDP 2:7100;rport;branch=z9hG4bK825701276From: <sip:62010000002000000002:7100>tag=3983823828To: <sip:620102010013100000431:5080>tag=3222_661_8389915Call-ID:

44、 2081113375CSeq: 21 BYEContact: <sip:62010000002000000002:7100>Max-Forwards: 70User-Agent: HikvisionContent-Length: 01.6 云台把握l 上级平台向下级平台发送云台把握恳求；l 举例说明： 上级->下级MESSAGE sip:620102010013100000331:5080 SIP/2.0Via: SIP/2.0/UDP 2:7100;rport;branch=z9hG4bK2582872

45、259From: <sip:62010000002000000002:7100>tag=3773325418To: <sip:620102010013100000331:5080>Call-ID: 1813198482CSeq: 20 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 70User-Agent: HikvisionContent-Length: 298<?xml version="1.0"?><Contro

46、l><CmdType>DeviceControl</CmdType><SN>8</SN><DeviceID>62010201001310000033云台把握的设备ID</DeviceID><PTZCmd>a50f4d0000000001云台把握命令，具体参考28181规范的附录A.3</PTZCmd><Info><ControlPriority>150</ControlPriority><startX>0</startX><st

47、artY>0</startY><endX>0</endX><endY>0</endY></Info></Control>下级->上级SIP/2.0 200 OKTo: <sip:620102010013100000331:5080>tag=5541_661_3619007Via: SIP/2.0/UDP 2:7100;rport=7100;branch=z9hG4bK2582872259;received=2CSeq:

48、20 MESSAGECall-ID: 1813198482From: <sip:62010000002000000002:7100>tag=3773325418Content-Length: 01.7 录像查询l 上级平台向下级平台查询录像恳求；l 举例说明： 上级->下级录像查询恳求MESSAGE sip:62010201002000000003:5080 SIP/2.0Via: SIP/2.0/UDP 6:7100;rport;branch=z9hG4bK442669892From: <sip:62

49、010000002000000000:7100>tag=2630907596To: <sip:62010201002000000003:5080>Call-ID: 3317287086CSeq: 20 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 70User-Agent: HikvisionContent-Length: 258<?xml version="1.0"?><Query><CmdType>Re

50、cordInfo</CmdType><SN>1894查询恳求序号</SN><DeviceID>62010201001310003793查询的镜头ID</DeviceID><StartTime>2013-11-07T00:00:00开头时间</StartTime><EndTime>2013-11-07T23:59:59结束时间</EndTime><Type>all查询录像类型</Type><RecordPos>1</RecordPos><

51、;/Query>下级->上级SIP/2.0 200 OKTo: <sip:62010201002000000003:5080>tag=2792_661_3882029Via: SIP/2.0/UDP 6:7100;rport=7100;branch=z9hG4bK442669892;received=2CSeq: 20 MESSAGECall-ID: 3317287086From: <sip:62010000002000000000:7100>tag=263090759

52、6Content-Length: 0下级->上级录像查询响应MESSAGE sip:62010000002000000002:7100 SIP/2.0Call-ID: 8330948e40f07059c8cdccdc02d5aefd3CSeq: 1 MESSAGEFrom: <sip:62010201002000000003>tag=3548_661_3776709To: <sip:62010000002000000002>Max-Forwards: 70Content-

53、Type: application/MANSCDP+XMLContent-Encoding: UTF-8Via: SIP/2.0/UDP 3:5080;branch=z9hG4bK3776709_661_96971908661700620966Content-Length: 566<?xml version='1.0' encoding='UTF-8'?><Response><CmdType>RecordInfo</CmdType><SN>1894</SN><Dev

54、iceID>62010201001310003793</DeviceID><Name>共享镜头01</Name><SumNum>2录像总数量</SumNum><RecordList Num='1'当前响应消息里的录像Item数量><Item><DeviceID>62010201001310003793</DeviceID><Name>共享镜头01</Name><StartTime>2013-11-06T23:17:32录像的开头时间</StartTime><EndTime>2013-11-07T00:02:48录像的结束时间</EndTime><Type>time录像类型</Type><RecorderID>HWPLATRD-931200007270101-VCURD-ch01_00000000029000000</RecorderID>