平臺(tái)對(duì)接接口詳解

1、28181平臺(tái)對(duì)接接口詳解1 信令接口1.1 平臺(tái)注冊(cè)l 下級(jí)平臺(tái)主動(dòng)向上級(jí)平臺(tái)注冊(cè)；l 注冊(cè)鑒權(quán)信息（用戶名和密碼）由上級(jí)提供；l 舉例說(shuō)明：下級(jí)->上級(jí)REGISTER sip:62010000002000000001上級(jí)平臺(tái)ID2:7100 SIP/2.0Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 1 REGISTERFrom: <sip:62010201002000000001下級(jí)平臺(tái)ID1:5080>tag=5923_661_2647061To: &l

2、t;sip:62010201002000000001:5080>Max-Forwards: 70Contact: <sip:62010201002000000001:5080>Expires: 3600Via: SIP/2.0/UDP 1:5080;branch=z9hG4bK2647061_661_55795848069639126081Content-Length: 0上級(jí)->下級(jí)SIP/2.0 401 UnauthorizedVia: SIP/2.0/UDP 1:5080;bran

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

4、nce="7104983f5477dd30a65167b28553df65", opaque="f10efb1af3e8a362bcda7465284073ce", algorithm=MD5User-Agent: HikvisionExpires: 3600Content-Length: 0下級(jí)->上級(jí)REGISTER sip:62010000002000000002:7100 SIP/2.0Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 2 REGIS

5、TERFrom: <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: Dig

6、est username="admin"上級(jí)平臺(tái)提供鑒權(quán)信息時(shí)指定的用戶。,realm="1234",nonce="7104983f5477dd30a65167b28553df65",uri="sip:62010000002000000002:7100",response="ceb3a346523335fb0c6d66d24a7e77b5下級(jí)平臺(tái)根據(jù)上級(jí)平臺(tái)返回的挑戰(zhàn)字和上級(jí)平臺(tái)的鑒權(quán)信息，用MD5算法計(jì)算得到。",algorithm=MD5,opaque="

7、f10efb1af3e8a362bcda7465284073ce"Expires: 3600Content-Length: 0上級(jí)->下級(jí)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>tag

8、=300030239Call-ID: c82dee890ea56d9d332fe4a5dbd2772c1CSeq: 2 REGISTERContact: <sip:62010201002000000001:5080>User-Agent: HikvisionDate: 2013-07-27T14:45:39Content-Length: 01.2 平臺(tái)心跳?；頻 下級(jí)平臺(tái)定期向上級(jí)平臺(tái)發(fā)心跳消息；l 定期時(shí)間可配置，上下級(jí)配置一致；l 上級(jí)平臺(tái)連續(xù)三次未收到下級(jí)心跳消息，則認(rèn)為下級(jí)平臺(tái)離線；l 下級(jí)平臺(tái)連續(xù)三次未收到心跳響應(yīng)，則認(rèn)為上級(jí)平臺(tái)

9、離線；l 舉例說(shuō)明： 下級(jí)->上級(jí)MESSAGE sip:62010000002000000002:7100 SIP/2.0Call-ID: 69c20964c5c9a8f0cc6cc5a7381423d53CSeq: 1 MESSAGEFrom: <sip:62010201002000000003>tag=0673_661_2850021To: <sip:62010000002000000002>Max-Forwards: 70Content-Type: applica

10、tion/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下級(jí)平臺(tái)ID</DeviceID><Status>OK<

11、;/Status></Notify>上級(jí)->下級(jí)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: 69c20964c5c9a8f0cc6cc5a738142

12、3d53CSeq: 1 MESSAGEContent-Length: 01.3 平臺(tái)設(shè)備共享l 下級(jí)平臺(tái)將設(shè)備共享給上級(jí)平臺(tái)，共享關(guān)系臨時(shí)保存在本地?cái)?shù)據(jù)庫(kù)；l 下級(jí)平臺(tái)收到上級(jí)平臺(tái)的目錄查詢消息時(shí)，返回共享給該上級(jí)平臺(tái)的所有共享設(shè)備信息；l 上級(jí)平臺(tái)收到目錄查詢響應(yīng)結(jié)果后，根據(jù)設(shè)備編碼或自定義方式給設(shè)備建立目錄；l 上級(jí)平臺(tái)最好支持定期查詢目錄和手動(dòng)查詢目錄功能，以便及時(shí)獲取到下級(jí)平臺(tái)新共享的設(shè)備；l 舉例說(shuō)明 上級(jí)->下級(jí)上級(jí)向下級(jí)發(fā)送目錄查詢請(qǐng)求MESSAGE sip:62010201002000000003:5080 SIP/2.0Via:

13、 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-Leng

14、th: 127<?xml version="1.0"?><Query><CmdType>Catalog</CmdType><SN>8903查詢消息的序號(hào)，下級(jí)平臺(tái)返回的查詢響應(yīng)消息的序號(hào)必須和該序號(hào)一致，以便標(biāo)識(shí)是該查詢的響應(yīng)。</SN><DeviceID>62010201002000000001下級(jí)平臺(tái)ID（上級(jí)平臺(tái)查詢下級(jí)平臺(tái)共享設(shè)備）</DeviceID></Query>下級(jí)->上級(jí)SIP/2.0 200 OKTo: <sip:62010201002

15、000000003: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下級(jí)->上級(jí)下級(jí)向上級(jí)返回目錄查詢響應(yīng)MESSAGE sip:620100

16、00002000000002: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 10.12

17、9.4.13:5080;branch=z9hG4bK6058761_661_61989619576009343309Content-Length: 746<?xml version="1.0" encoding="UTF-8" ?><Response><CmdType>Catalog</CmdType><SN>8903和查詢請(qǐng)求的序號(hào)相同</SN><DeviceID>62010201002000000001下級(jí)平臺(tái)ID</DeviceID><SumNum

18、>2下級(jí)平臺(tái)共享設(shè)備的總數(shù)</SumNum><DeviceList Num="1標(biāo)識(shí)當(dāng)前響應(yīng)消息里包括的共享設(shè)備信息的數(shù)量（由于SIP消息長(zhǎng)度不能超過(guò)1500字節(jié)，建議一次只返回一個(gè)共享設(shè)備信息）"><Item><DeviceID>62010401001310004766共享設(shè)備01的ID</DeviceID><Name>共享鏡頭01</Name><Manufacturer>hik</Manufacturer><Owner>1</Owner&g

19、t;<Model>1</Model><CivilCode>62010201002000000001</CivilCode><Address>1</Address><Parental>0</Parental><CertNum>1</CertNum><Certifiable>1</Certifiable><ErrCode>400</ErrCode><ParentID>62010201002000000001下級(jí)平臺(tái)ID&

20、lt;/ParentID><RegisterWay>1</RegisterWay><Secrecy>0</Secrecy><IPAddress></IPAddress><Port>0</Port><Longitude>0.000000</Longitude><Latitude>0.000000</Latitude><Status>ON共享設(shè)備01的狀態(tài)，ON： 鏡頭上線OFF：鏡頭下線</Status></Item&

21、gt;</DeviceList></Response>上級(jí)->下級(jí)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: 3c2375ee902cdef0c

22、10aa9fe2001e4f93CSeq: 1 MESSAGEUser-Agent: HikvisionContent-Length: 0下級(jí)->上級(jí)下級(jí)向上級(jí)返回目錄查詢響應(yīng)。MESSAGE sip:62010000002000000002:7100 SIP/2.0Call-ID: 7e4db4fa734be13c979511f6a8e84df63CSeq: 1 MESSAGEFrom: <sip:62010201002000000003>tag=5183_661_6342350To:

23、<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>Catalog

24、</CmdType><SN>8903和查詢請(qǐng)求的序號(hào)相同</SN><DeviceID>62010201002000000001</DeviceID><SumNum>2</SumNum><DeviceList Num="1"><Item><DeviceID>62010501001310005076共享設(shè)備02的ID</DeviceID><Name>共享鏡頭02</Name><Manufacturer>hik&l

25、t;/Manufacturer><Owner>1</Owner><Model>1</Model><CivilCode>62010201002000000001</CivilCode><Address>1</Address><Parental>0</Parental><CertNum>1</CertNum><Certifiable>1</Certifiable><ErrCode>400</ErrCode&g

26、t;<ParentID>62010201002000000001</ParentID><RegisterWay>1</RegisterWay><Secrecy>0</Secrecy><IPAddress></IPAddress><Port>0</Port><Longitude>0.000000</Longitude><Latitude>0.000000</Latitude><Status>ON</Status&

27、gt;</Item></DeviceList></Response>上級(jí)->下級(jí)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: 7e4d

28、b4fa734be13c979511f6a8e84df63CSeq: 1 MESSAGEUser-Agent: HikvisionContent-Length: 0備注：上級(jí)平臺(tái)收到下級(jí)平臺(tái)目錄查詢響應(yīng)消息后，根據(jù)SumNum字段確定共享設(shè)備數(shù)量，并累計(jì)DeviceList的Item數(shù)量，當(dāng)累計(jì)數(shù)量和SumNum字段值相等時(shí)，則說(shuō)明查詢結(jié)束。1.4 共享設(shè)備狀態(tài)變更通知l 下級(jí)平臺(tái)共享設(shè)備狀態(tài)變更時(shí)通知給上級(jí)平臺(tái)；l 舉例說(shuō)明： 下級(jí)->上級(jí)NOTIFY sip:62010000002000000002:7100 SIP/2.0Call-ID

29、: 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_6198961957

30、6009343309Content-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</Parental>

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

33、gitude>0.000000</Longitude><Latitude>0.000000</Latitude><Status>OFF“共享設(shè)備01“下線</Status></Item></DeviceList></Response>上級(jí)->下級(jí)SIP/2.0 200 OKVia: SIP/2.0/UDP 3:5080;branch=z9hG4bK6058761_661_61989619576009343309From: <sip:620102010020000

34、00003>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="GB2312

35、" ?><Response><CmdType>Catalog</CmdType><SN>3</SN><DeviceID>62010201002000000001</DeviceID><Result>OK</Result></Response>1.5 實(shí)時(shí)視頻l 上級(jí)平臺(tái)請(qǐng)求下級(jí)共享鏡頭視頻；l 舉例說(shuō)明： 上級(jí)->下級(jí)INVITE sip:62010201001310000033請(qǐng)求視頻的共享鏡頭ID1:5080 SIP/2.0Via

36、: 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: Applicat

37、ion/SDPMax-Forwards: 70User-Agent: HikvisionSubject: 62010201001310000033請(qǐng)求視頻的共享鏡頭ID:0,62010000002000000001:0Content-Length: 220v=0o=62010201001310000033 0 0 IN IP4 2s=Play視頻請(qǐng)求方式：Play： 實(shí)時(shí)視頻Playback： 錄像回放Download： 錄像下載c=IN IP4 2上級(jí)平臺(tái)的媒體服務(wù)器IPt=0 0m=video 5400上級(jí)平臺(tái)接受視頻流的端口 RTP/AVP

38、媒體傳輸方式：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下級(jí)->上級(jí)SIP/2.0 100 TryingTo: <sip:620102010013100000331:5080>Via: SIP/2.0/UDP 2:7100;rport=7100;branch=z9hG4bK16424822

39、64;received=2CSeq: 20 INVITECall-ID: 2081113375From: <sip:62010000002000000002:7100>tag=3983823828Content-Length: 0下級(jí)->上級(jí)SIP/2.0 200 OKTo: <sip:620102010013100000331:5080>tag=3222_661_8389915Via: SIP/2.0/UDP 2:7100;rport=7100;branch=z9hG4

40、bK1642482264;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 1下

41、級(jí)平臺(tái)的媒體服務(wù)器IPt=0 0m=video 6016 下級(jí)平臺(tái)發(fā)送視頻流的端口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/上級(jí)->下級(jí)ACK sip:1:5080 SIP/2.0Via: SIP/2.

42、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-Forwards:

43、70User-Agent: HikvisionContent-Length: 0上級(jí)->下級(jí)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: 208

44、1113375CSeq: 21 BYEContact: <sip:62010000002000000002:7100>Max-Forwards: 70User-Agent: HikvisionContent-Length: 01.6 云臺(tái)控制l 上級(jí)平臺(tái)向下級(jí)平臺(tái)發(fā)送云臺(tái)控制請(qǐng)求；l 舉例說(shuō)明： 上級(jí)->下級(jí)MESSAGE sip:620102010013100000331:5080 SIP/2.0Via: SIP/2.0/UDP 2:7100;rport;branch=z9hG4bK2582872259F

45、rom: <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"?><Control>

46、;<CmdType>DeviceControl</CmdType><SN>8</SN><DeviceID>62010201001310000033云臺(tái)控制的設(shè)備ID</DeviceID><PTZCmd>a50f4d0000000001云臺(tái)控制命令，詳細(xì)參考28181規(guī)范的附錄A.3</PTZCmd><Info><ControlPriority>150</ControlPriority><startX>0</startX><startY

47、>0</startY><endX>0</endX><endY>0</endY></Info></Control>下級(jí)->上級(jí)SIP/2.0 200 OKTo: <sip:620102010013100000331:5080>tag=5541_661_3619007Via: SIP/2.0/UDP 2:7100;rport=7100;branch=z9hG4bK2582872259;received=2CSeq: 20 M

48、ESSAGECall-ID: 1813198482From: <sip:62010000002000000002:7100>tag=3773325418Content-Length: 01.7 錄像查詢l 上級(jí)平臺(tái)向下級(jí)平臺(tái)查詢錄像請(qǐng)求；l 舉例說(shuō)明： 上級(jí)->下級(jí)錄像查詢請(qǐng)求MESSAGE sip:62010201002000000003:5080 SIP/2.0Via: SIP/2.0/UDP 6:7100;rport;branch=z9hG4bK442669892From: <sip:620100

49、00002000000000: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>Record

50、Info</CmdType><SN>1894查詢請(qǐng)求序號(hào)</SN><DeviceID>62010201001310003793查詢的鏡頭ID</DeviceID><StartTime>2013-11-07T00:00:00開(kāi)始時(shí)間</StartTime><EndTime>2013-11-07T23:59:59結(jié)束時(shí)間</EndTime><Type>all查詢錄像類型</Type><RecordPos>1</RecordPos></Qu

51、ery>下級(jí)->上級(jí)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=2630907596Con

52、tent-Length: 0下級(jí)->上級(jí)錄像查詢響應(yīng)MESSAGE sip:62010000002000000002:7100 SIP/2.0Call-ID: 8330948e40f07059c8cdccdc02d5aefd3CSeq: 1 MESSAGEFrom: <sip:62010201002000000003>tag=3548_661_3776709To: <sip:62010000002000000002>Max-Forwards: 70Content-Type

53、: 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><DeviceI

54、D>62010201001310003793</DeviceID><Name>共享鏡頭01</Name><SumNum>2錄像總數(shù)量</SumNum><RecordList Num='1'當(dāng)前響應(yīng)消息里的錄像Item數(shù)量><Item><DeviceID>62010201001310003793</DeviceID><Name>共享鏡頭01</Name><StartTime>2013-11-06T23:17:32錄像的開(kāi)始時(shí)間</StartTime><EndTime>2013-11-07T00:02:48錄像的結(jié)束時(shí)間</EndTime><Type>time錄像類型</Type><RecorderID>HWPLATRD-931200007270101-VCURD-ch01_00000000029000000</RecorderID&