28181平台对接接口详解

1、28181 平台对接接口详解1 信令接口1.1 平台注册下级平台主动向上级平台注册；注册鉴权信息用户名和密码由上级提供；举例说明：下级-> 上级REGISTER sip: 62021000002000000002:7100 SIP/2.0Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 1 REGISTERFrom: <sip: 62021202102000000001:5080>tag=5923_661_2647061To: <sip:6202120210

2、2000000001:5080>Max-Forwards: 70Contact: <sip:62021202102000000001: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;branch=z9hG4bK26470

3、61_661_55795848069639126081From: <sip:62021202102000000001:5080>tag=5923_661_2647061To: <sip:62021202102000000001:5080>tag=316765889Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 1 REGISTERWWW-Authenticate: Digest realm="1234", nonce="71049

4、83f5477dd30a65167b28553df65", opaque="f10efb1af3e8a362bcda7465284073ce", algorithm=MD5User-Agent: HikvisionExpires: 3600Content-Length: 0下级-> 上级REGISTER sip:62021000002000000002:7100 SIP/2.0Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 2 REGISTERFrom: <s

5、ip:62021202102000000001:5080>tag=5923_661_2647061To: <sip:62021202102000000001:5080>Max-Forwards: 70Contact: <sip:62021202102000000001:5080>Via: SIP/2.0/UDP 1:5080;branch=z9hG4bK2647061_661_19459966820285136301 Authorization: Digestusername=&

6、quot;admin ",realm="1234",nonce="7104983f5477dd30a65167b28553df65",uri="sip:6202100000200 0000002:7100", response=" ceb3a346523335fb0c6d66d24a7e77b5 ",algorithm=MD5,opaqu e="f10efb1af3e8a362bcda7465284073ce"Expires: 3600Content-Leng

7、th: 0上级-> 下级SIP/2.0 200 OKVia: SIP/2.0/UDP 1:5080;branch=z9hG4bK2647061_661_19459966820285136301From: <sip:62021202102000000001:5080>tag=5923_661_2647061To: <sip:62021202102000000001:5080>tag=300030239Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1

8、CSeq: 2 REGISTERContact: <sip:62021202102000000001:5080>User-Agent: HikvisionDate: 2021-07-27T14:45:39Content-Length: 01.2 平台心跳保活下级平台定期向上级平台发心跳消息；定期时间可配置，上下级配置一致；上级平台连续三次未收到下级心跳消息，那么认为下级平台离线；下级平台连续三次未收到心跳响应，那么认为上级平台离线；举例说明：下级 -> 上级MESSAGE sip:62021000002000000002:710

9、0 SIP/2.0Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d53CSeq: 1 MESSAGEFrom: <sip:62021202102000000003>tag=0673_661_2850021To: <sip:62021000002000000002>Max-Forwards: 70Content-Type: application/XmlVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK2850021_661_3

10、5032844903563514200 Content-Length: 138<?xml version="1.0" ?><Notify><CmdType>Keepalive</CmdType><SN>43</SN><DeviceID> 62021202102000000001</DeviceID><Status>OK</Status></Notify>上级-> 下级SIP/2.0 200 OKVia: SIP/2.0/UDP 10.12

11、9.4.13:5080;branch=z9hG4bK2850021_661_35032844903563514200From: <sip:62021202102000000003>tag=0673_661_2850021To: <sip:62021000002000000002>tag=1421372822Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d53CSeq: 1 MESSAGEContent-Length: 01.3 平台设备共享下级平台将设备共享给上级平台，共

12、享关系临时保存在本地数据库； 下级平台收到上级平台的目录查询消息时， 返回共享给该上级平台的所有共享设备信息； 上级平台收到目录查询响应结果后，根据设备编码或自定义方式给设备建立目录； 上级平台最好支持定期查询目录和手动查询目录功能， 以便及时获取到下级平台新共享 的设备；举例说明上级->下级MESSAGE sip:62021202102000000003:5080 SIP/2.0Via: SIP/2.0/UDP 6:7100;rport;branch=z9hG4bK3420267366From: <sip:6202100000200000

13、0000:7100>tag=500485300To: <sip:62021202102000000003:5080>Call-ID: 124958176CSeq: 20 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 70User-Agent: HikvisionContent-Length: 127<?xml version="1.0"?><Query><CmdType>Catalog</CmdTyp

14、e><SN>8903</SN><DeviceID> 62021202102000000001</DeviceID></Query>下级-上级SIP/2.0 200 OKTo: <sip:62021202102000000003:5080>tag=6840_661_3935882Via: SIP/2.0/UDP 6:7100;rport=7100;branch=z9hG4bK3420267366;received=2 CSeq: 20 MESSAGECa

15、ll-ID: 124958176From: <sip:62021000002000000000:7100>tag=500485300Content-Length: 0下级->上级MESSAGE sip:62021000002000000002:7100 SIP/2.0Call-ID: 3c2375ee902cdef0c10aa9fe2001e4f93CSeq: 1 MESSAGEFrom: <sip:62021202102000000003>tag=7373_661_605

16、8761To: <sip:62021000002000000002>Max-Forwards: 70Content-Type: application/MANSCDP+XMLVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6058761_661_61989619576009343309Content-Length: 746<?xml version="1.0" encoding="UTF-8" ?><Response><CmdType>

17、;Catalog</CmdType><SN> 8903</SN> <DeviceID>62021202102000000001</DeviceID><SumNum>2</SumNum><DeviceList Num="1"><Item><DeviceID>62021401001310004766</DeviceID>vName>共享镜头 01</Name><Manufacturer>hik</Manufact

18、urer> vOwner>1v/Owner>vModel>1v/Model> vCivilCode>62021202102000000001v/CivilCode>vAddress>1v/Address>vParental>0v/Parental>vCertNum>1v/CertNum>vCertifiable>1v/Certifiable>vErrCode>400v/ErrCode>vParentID>62021202102000000001v/ParentID>vRegiste

19、rWay>1v/RegisterWay>vSecrecy>0v/Secrecy>vIPAddress>v/IPAddress> vPort>0v/Port>vLongitude>0.000000v/Longitude>vLatitude>0.000000v/Latitude><Status>ON</Status></Item></DeviceList> </Response>上级->下级SIP/2.0 200 OKVia: SIP/2.0/UDP 10.12

20、9.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343309From: <sip:62021202102000000003>tag=7373_661_6058761To: <sip:62021000002000000002>tag=3437297396Call-ID: 3c2375ee902cdef0c10aa9fe2001e4f93 CSeq: 1 MESSAGEUser-Agent: HikvisionContent-Length: 0下级-&

21、gt;上级MESSAGE sip:62021000002000000002:7100 SIP/2.0Call-ID: 7e4db4fa734be13c979511f6a8e84df63CSeq: 1 MESSAGEFrom: <sip:62021202102000000003>tag=5183_661_6342350To: <sip:62021000002000000002>Max-Forwards: 70Content-Type: application/MANSCDP+XM

22、LVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6342350_661_77897377155966919994 Content-Length: 749<?xml version="1.0" encoding="UTF-8" ?><Response> <CmdType>Catalog</CmdType> <SN> 8903</SN><DeviceID>62021202102000000001</DeviceID>

23、; <SumNum>2</SumNum><DeviceList Num="1"><Item><DeviceID>62021501001310005076</DeviceID>vName>共享镜头 02</Name><Manufacturer>hik</Manufacturer> vOwner>1v/Owner> vModel>1v/Model>vCivilCode>62021202102000000001v/CivilCode>

24、;vAddress>1v/Address>vParental>0v/Parental> vCertNum>1v/CertNum>vCertifiable>1v/Certifiable> vErrCode>400v/ErrCode><ParentID>62021202102000000001</ParentID> <RegisterWay>1</RegisterWay><Secrecy>0</Secrecy><IPAddress></IPAddre

25、ss><Port>0</Port><Longitude>0.000000</Longitude><Latitude>0.000000</Latitude><Status>ON</Status></Item></DeviceList></Response>上级->下级SIP/2.0 200 OKVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6342350_661_77897377155966919994F

26、rom: <sip:62021202102000000003>tag=5183_661_6342350To: <sip:62021000002000000002>tag=3651745157Call-ID: 7e4db4fa734be13c979511f6a8e84df63CSeq: 1 MESSAGEUser-Agent: HikvisionContent-Length: 0备注：上级平台收到下级平台目录查询响应消息后，根据SumNu字段确定共享设备数量，并累计DeviceList的Item数量，当累

27、计数量和 SumNu字段值相等时，那么说明查询结束。1.4 共享设备状态变更通知下级平台共享设备状态变更时通知给上级平台；举例说明：下级->上级NOTIFY sip:62021000002000000002:7100 SIP/2.0Call-ID: cd0cba2fc6dc8baa82738ffdf4f13add3CSeq: 1 NOTIFYFrom: <sip:62021202102000000003>tag=7373_661_6058761To: <sip:620210000020000000011

28、2>Max-Forwards: 70Content-Type: application/MANSCDP+XMLVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6058761_661_61989619576009343309Content-Length: 747 <?xml version='1.0' encoding='UTF-8'?> <Response><CmdType>Catalog</CmdType><SN>3</

29、SN><DeviceID>62021202102000000001</DeviceID><SumNum>1</SumNum><DeviceList Num="1"><Item> <DeviceID>62021401001310004766</DeviceID>vName>共享镜头 01</Name><Manufacturer>hik</Manufacturer>vModel>1v/Model>vOwner>1v/O

30、wner> vCivilCode>62021202102000000001v/CivilCode>vAddress>1v/Address>vParental>0v/Parental>vCertNum>1v/CertNum>vCertifiable>1v/Certifiable>vErrCode>400v/ErrCode> vParentID>62021202102000000001v/ParentID> vRegisterWay>1v/RegisterWay>vSecrecy>0v/Se

31、crecy>vIPAddress>v/IPAddress>vPort>0v/Port>vLongitude>0.000000v/Longitude>vLatitude>0.000000v/Latitude>vStatus>OFFv/Status>v/Item>v/DeviceList>v/Response>上级->下级SIP/2.0 200 OKVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6058761_661_61989619576009343309F

32、rom: vsip:62021202102000000003>tag=7373_661_6058761To: vsip:62021000002000000002>tag=3437297396Call-ID: cd0cba2fc6dc8baa82738ffdf4f13add3CSeq: 1 NOTIFYUser-Agent: HikvisionContent-Type: application/MANSCDP+XMLContent-Length:171v?xml version="1.0" enc

33、oding="GB2312" ?> vResponse>vCmdType>Catalogv/CmdType>vSN>3v/SN>vDeviceID>62021202102000000001v/DeviceID>vResult>OKv/Result></Response>1.5 实时视频上级平台请求下级共享镜头视频；举例说明：上级->下级INVITE sip: 620212021013100000331:5080 SIP/2.0Via: SIP/2.0/UDP 10.130.14

34、0.82:7100;rport;branch=z9hG4bK1642482264From: <sip:62021000002000000002:7100>tag=3983823828To: <sip:620212021013100000331:5080>Call-ID: 2081113375CSeq: 20 INVITEContact: <sip:62021000002000000002:7100>Content-Type: Application/SDPMax-Forwards: 70

35、User-Agent: HikvisionSubject: 62021202101310000033:0,62021000002000000001:0Content-Length: 220v=0o=62021202101310000033 0 0 IN IP4 2s=Playc=IN IP4 2t=0 0m=video 5400 RTP/AVP 96 97 98a=rtpmap:96 PS/90000a=rtpmap:97 MPEG4/90000a=rtpmap:98 H264/90000 a=recvonlyy=0999999999下级->

36、;上级SIP/2.0 100 TryingTo: <sip:620212021013100000331:5080>Via: SIP/2.0/UDP 2:7100;rport=7100;branch=z9hG4bK1642482264;received=2CSeq: 20 INVITECall-ID: 2081113375From: <sip:62021000002000000002:7100>tag=3983823828 Content-Length: 0下级->上级SI

37、P/2.0 200 OKTo: <sip:620212021013100000331:5080>tag=3222_661_8389915 Via: SIP/2.0/UDP2:7100;rport=7100;branch=z9hG4bK1642482264;received=2 CSeq: 20 INVITECall-ID: 2081113375From: <sip:62021000002000000002:7100>tag=3983823828Contact: <sip:

38、1:5080>Content-Type: application/sdpContent-Length: 277v=0o=huawei 1375083193016081 0 IN IP4 1 s=Playc=IN IP4 1t=0 0m=video 6016 RTP/AVP 96a=rtpmap:96 PS/90000a=sendonlym=audio 6018 RTP/AVP 100 a=rtpmap:100 G711U a=sendonly a=username:admin a=password:123456 y=099999

39、9999 f=v/2/1/0/1/0a/上级->下级ACK sip:1:5080 SIP/2.0Via: SIP/2.0/UDP 2:7100;rport;branch=z9hG4bK825701276From: <sip:62021000002000000002:7100>tag=3983823828To: <sip:620212021013100000331:5080>tag=3222_661_8389915 Call-ID: 2081113375CSeq: 20 ACK

40、Contact: <sip:62021000002000000002:7100>Max-Forwards: 70User-Agent: HikvisionContent-Length: 0上级->下级BYE sip:1:5080 SIP/2.0Via: SIP/2.0/UDP 2:7100;rport;branch=z9hG4bK825701276From: <sip:62021000002000000002:7100>tag=3983823828To: <sip

41、:620212021013100000431:5080>tag=3222_661_8389915 Call-ID: 2081113375CSeq: 21 BYEContact: <sip:62021000002000000002:7100>Max-Forwards: 70User-Agent: HikvisionContent-Length: 01.6 云台控制上级平台向下级平台发送云台控制请求；举例说明：上级->下级MESSAGE sip:620212021013100000331:5080 SIP/2

42、.0Via: SIP/2.0/UDP 2:7100;rport;branch=z9hG4bK2582872259From: <sip:62021000002000000002:7100>tag=3773325418To: <sip:620212021013100000331:5080>Call-ID: 1813198482CSeq: 20 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 70User-Agent: HikvisionC

43、ontent-Length: 298<?xml version="1.0"?><Control><CmdType>DeviceControl</CmdType><SN>8</SN><DeviceID> 62021202101310000033</DeviceID><PTZCmd> a50f4d0000000001 </PTZCmd><Info><ControlPriority>150</ControlPriority>&

44、lt;startX>0</startX><startY>0</startY><endX>0</endX><endY>0</endY></Info></Control>下级->上级SIP/2.0 200 OKTo: <sip:620212021013100000331:5080>tag=5541_661_3619007Via: SIP/2.0/UDP2:7100;rport=7100;branch=z9hG4bK25828

45、72259;received=2CSeq: 20 MESSAGECall-ID: 1813198482From: <sip:62021000002000000002:7100>tag=3773325418Content-Length: 01.7 录像查询上级平台向下级平台查询录像请求；举例说明：上级->下级MESSAGE sip:62021202102000000003:5080 SIP/2.0Via: SIP/2.0/UDP 6:7100;rport;branch=z9hG4bK44

46、2669892From: <sip:62021000002000000000:7100>tag=2630907596To: <sip:62021202102000000003:5080>Call-ID: 3317287086CSeq: 20 MESSAGEContent-Type: Application/MANSCDP+xmlMax-Forwards: 70User-Agent: HikvisionContent-Length: 258<?xml version="1.0"?><Que

47、ry><CmdType> RecordInfo </CmdType><SN>1894</SN><DeviceID> 62021202101310003793</DeviceID><StartTime> 2021-11-07T00:00:00 </StartTime><EndTime> 2021-11-07T23:59:59 </EndTime><Type> all </Type><RecordPos>1</RecordPos&g

48、t;</Query>下级->上级SIP/2.0 200 OKTo: <sip:62021202102000000003:5080>tag=2792_661_3882029Via: SIP/2.0/UDP 6:7100;rport=7100;branch=z9hG4bK442669892;received=2CSeq: 20 MESSAGECall-ID: 3317287086From: <sip:62021000002000000000:7100>tag=2630

49、907596Content-Length: 0下级->上级MESSAGE sip:62021000002000000002:7100 SIP/2.0Call-ID: 8330948e40f07059c8cdccdc02d5aefd3CSeq: 1 MESSAGEFrom: <sip:62021202102000000003>tag=3548_661_3776709To: <sip:62021000002000000002>Max-Forwards: 70Content-T

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

51、DeviceID> 62021202101310003793</DeviceID><Name> 共享镜头 01</Name><SumNum> 2</SumNum><RecordList Num= '1'><Item><DeviceID> 62021202101310003793</DeviceID>vName>共享镜头 01</Name><StartTime>2021-11-06T23:17:32 </StartTime> vEndTime>2021-11-07T00:02:48 v/EndTime>vType>timev/Type>vRecorderID>HWPLATRD-931200007270101-VCURD-ch01_00000000029000000v/RecorderID> v/Item>v/RecordList>v/Response>上级->下