視頻級聯(lián)GB28281協(xié)議詳解-訂閱流程解析

訂閱流程解析一、前言目錄訂閱有別與資源檢索流程，主要是訂閱下級的資源狀態(tài)，下級在訂閱周期內(nèi)點位或組織發(fā)生變化，下級將通過notify報文通知上級，上級進行相應(yīng)的狀態(tài)變更。平臺級聯(lián)之間的訂閱采用的是域間訂閱流程。事件訂閱主要應(yīng)用于移動設(shè)備訂閱。詳情見9.11訂閱和通知。二、目錄訂閱2.1、流程聯(lián)網(wǎng)系統(tǒng)間采用訂閱通知機制實現(xiàn)狀態(tài)變化的設(shè)備信息的傳送，用于提供聯(lián)網(wǎng)系統(tǒng)間設(shè)備狀態(tài)一致性的維護機制。SIP域可通過訂閱方式訂閱其他SIP域的全部或部分目錄的離線、上線、增加、刪除、更新等變更信息；被訂閱域在目錄變更后，應(yīng)將變更事件通知訂閱域。訂閱通知消息使用IETFRFC3265規(guī)定的SUBSCRIBE、NOTIFY方法實現(xiàn)。某一SIP域可進行其他多個SIP域目錄信息的訂閱，也可接受其他多個SIP域的訂閱。本域保存訂閱目錄、被訂閱目錄列表，在本域被訂閱目錄變更后向訂閱域發(fā)送通知消息，訂閱域接收到通知消息后進行相應(yīng)更新處理。圖2.1訂閱流程信令流程如下：A域向B域發(fā)送初始訂閱消息，開始訂閱B域設(shè)備狀態(tài)。Expire頭域攜帶訂閱過期時間應(yīng)可配置，默認600s。B域在過期時間到來時未收到刷新訂閱消息則移除A域的訂閱狀態(tài)。為保持兩個域間目錄狀態(tài)一致，訂閱域在進行初始訂閱成功后需默認被訂閱對象范圍內(nèi)的目錄狀態(tài)為在線，被訂閱域在收到初始訂閱消息后，需要通知被訂閱對象范圍內(nèi)目錄的離線和其他異常狀態(tài)。a）A域向B域發(fā)送訂閱消息，訂閱參數(shù)可以為B域系統(tǒng)ID、B域下級系統(tǒng)ID、B域范圍內(nèi)行政區(qū)劃編碼、B域設(shè)備ID、B域上報的業(yè)務(wù)分組ID、虛擬組織ID。訂閱對象為B域系統(tǒng)ID時，B域檢測到直屬目錄和下級域的目錄變更事件時應(yīng)向A域發(fā)送通知消息；訂閱對象為B域下級系統(tǒng)ID時，B域檢測到對應(yīng)此ID的下級系統(tǒng)范圍內(nèi)的目錄變更事件時應(yīng)向A域發(fā)送通知消息；訂閱對象為B域范圍內(nèi)行政區(qū)劃編碼時，B域檢測到屬于此行政區(qū)劃的目錄變更事件時應(yīng)向A域發(fā)送通知消息；訂閱對象為B域設(shè)備ID時，B域檢測到該設(shè)備及其下屬子設(shè)備發(fā)生目錄變更事件時應(yīng)向A域發(fā)送通知消息；訂閱對象為B域上報的業(yè)務(wù)分組ID、虛擬組織ID時，B域檢測到該業(yè)務(wù)分組、虛擬組織下屬虛擬組織、設(shè)備發(fā)生目錄變更事件時應(yīng)向A域發(fā)送通知消息。b）B域在檢測到被訂閱范圍內(nèi)目錄變更事件時應(yīng)根據(jù)接收的訂閱者列表，向處于訂閱有效期的域發(fā)送目錄狀態(tài)通知消息。詳情見附錄P.2.1相鄰域間目錄訂閱通知2.1.1、刷新訂閱A域在初始訂閱成功之后，應(yīng)在過期之前向B域發(fā)送刷新訂閱消息，進行訂閱狀態(tài)維護。 刷新訂閱消息與初始訂閱消息屬于同一會話，并且Expire頭域值大于0。詳情見：P.2.1.22.1.2、取消訂閱若A域不再訂閱B域目錄變更，應(yīng)向B域發(fā)送取消訂閱請求。取消訂閱請求應(yīng)與初始訂閱請求屬于同一會話，并且Expire頭域值為0。B域收到取消訂閱請求后應(yīng)移除A域的訂閱狀態(tài)，目錄變更后不再通知A域。詳情見：P.2.12.1.3、命令流程圖SEQ圖\*ARABIC2.2訂閱流程命令流程描述如下訂閱域向被訂閱域發(fā)送初始訂閱SUBSCRIBE消息，訂閱目的域的目錄變更事件，消息頭域中使用Event頭域描述訂閱事件（SUBSCRIBE消息、NOTIFY消息需攜帶Evnet頭域描述訂閱事件。Event頭域格式為“Catalog;id=num”其中，num為數(shù)字取值），消息體中攜帶訂閱的詳細參數(shù)，使用Expire頭域指定訂閱過期時間；被訂閱域設(shè)備收到訂閱消息后，向訂閱域發(fā)送200OK響應(yīng)；對于初始訂閱操作，被訂閱域立即發(fā)送NOTIFY消息攜帶離線及其他異常狀態(tài)設(shè)備目錄，消息頭域中使用Event頭域描述訂閱事件；訂閱域收到NOTIFY消息后回復(fù)200OK響應(yīng)；被訂閱域目錄變更后，通過NOTIFY消息將變更事件通知訂閱域，消息頭域中使用Event頭域描述訂閱事件；訂閱域收到NOTIFY消息后回復(fù)200OK響應(yīng)；訂閱域在過期之前向被訂閱域發(fā)送刷新訂閱SUBSCRIBE消息，訂閱目的域的目錄變更事件，消息頭域中使用Event頭域描述訂閱事件，消息體中攜帶訂閱的詳細參數(shù)，使用Expire頭域指定訂閱過期時間；被訂閱域設(shè)備收到訂閱消息后，向訂閱域發(fā)送200OK響應(yīng)；被訂閱域目錄變更后，通過NOTIFY消息將變更事件通知訂閱域，消息頭域中使用Event頭域描述訂閱事件；訂閱域收到NOTIFY消息后回復(fù)200OK響應(yīng)；訂閱域向被訂閱域發(fā)送取消訂閱SUBSCRIBE消息，消息頭域中使用Event頭域描述訂閱事件，消息體中攜帶訂閱的詳細參數(shù)，Expire頭域值為0；被訂閱域設(shè)備收到訂閱消息后，向訂閱域發(fā)送200OK響應(yīng)，取消向訂閱域發(fā)送目錄變更通知消息。2.2、訂閱報文2.2.1、訂閱請求<?xmlversion="1.0"?><Query><!--命令類型：目錄訂閱（必選）--><CmdType>Catalog</CmdType><!--命令序列號（必選）--><SN>命令序列號</SN><!--訂閱的系統(tǒng)/行政區(qū)劃/設(shè)備/業(yè)務(wù)分組/虛擬組織編碼（必選）--><DeviceID>訂閱編碼</DeviceID></Query>詳情見：P.4.2.1訂閱消息2.2.2、消息通知<?xmlversion="1.0"?><Notify><!--命令類型：目錄訂閱（必選）--><CmdType>Catalog</CmdType><!--命令序列號（必選）--><SN>命令序列號</SN><!--訂閱的系統(tǒng)/行政區(qū)劃/設(shè)備/業(yè)務(wù)分組/虛擬組織編碼（必選）--><DeviceID>訂閱編碼</DeviceID><!--通知消息中SumNum取值與DeviceList中Num取值相同（必選）--><SumNum>2</SumNum><DeviceListNum=＂2＂><Item> <!--狀態(tài)改變的系統(tǒng)/設(shè)備/行政區(qū)劃編碼（必選）--> <DeviceID>編碼1</DeviceID><!--狀態(tài)改變事件ON：上線，OFF：離線，VLOST：視頻丟失，DEFECT：故障，ADD：增加，DEL：刪除，UPDATE：更新（必選）--> <Event>OFF</Event></Item><Item> <!--狀態(tài)改變的系統(tǒng)/設(shè)備/行政區(qū)劃編碼（必選）--> <DeviceID>編碼n</DeviceID><!--狀態(tài)改變事件ON：上線，OFF：離線，VLOST：視頻丟失，DEFECT：故障，ADD：增加，DEL：刪除，UPDATE：更新（必選）--> <Event>ADD</Event><Name>IPC_天山視頻</Name><Manufacturer>XXX</Manufacturer><Model>1.0</Model><Owner>0</Owner><CivilCode>650102</CivilCode><Address>axy</Address><Parental>0</Parental><RegisterWay>1</RegisterWay><Secrecy>0</Secrecy><Status>ON</Status></Item></DeviceList></Notify>詳情見：P.4.2.2通知消息2.2.3、報文示例2.2.3.1、目錄訂閱請求SUBSCRIBEsip:34012301012000193119@34.11.166.65:7100SIP/2.0Via:SIP/2.0/UDP34.11.165.3:7100;rport;branch=z9hG4bK9087A0C3-49C2-5A45-8C9F-5A9FC0BA95CCFrom:<sip:34012300002000000001@34.11.165.3:7100>;tag=8C565F46-D70C-AC4C-A730-331CB496CFC8To:<sip:34012301012000193119@34.11.166.65:7100>;tag=6F699934-4597-6D4F-8D36-6FF3D20675B6Contact:<sip:34012300002000000001@34.11.165.3:7100>Call-ID:8DADBEE4-DE7F-6A4B-A6F8-3C257F42088AExpires:1800Event:Catalog;id=647CSeq:109771SUBSCRIBEUser-Agent:NCGV3.3.6.15817Content-Length:126Content-Type:Application/MANSCDP+xml<?xmlversion="1.0"?><Query><CmdType>Catalog</CmdType><SN>647</SN><DeviceID>34012301012000193119</DeviceID></Query>重點字段：Expires:1800—表示訂閱周期，在此周期內(nèi)下級有變化的需要通知上來，上級在訂閱周期內(nèi)下發(fā)刷新訂閱；0表示取消訂閱。DeviceID：表示訂閱的下級域編碼刷新訂閱跟第一次訂閱怎么看？新訂閱是同一個Call-ID。2.2.3.2、目錄訂閱回復(fù)NOTIFYsip:34012300002000000001@34.11.165.3:7100SIP/2.0Via:SIP/2.0/UDP34.11.166.65:7100;rport;branch=z9hG4bK405DE57C-72D3-7445-9B10-3646BF4EC445Route:<sip:34012300002000000001@34.11.165.3:7100>From:<sip:34012301012000193119@34.11.166.65:7100>;tag=FC57A020-A7DB-D744-8669-0456F7BF98DBTo:<sip:34012300002000000001@34.11.165.3:7100>Call-ID:BAEE5DAD-8830-744C-A4A0-B7AE830805DACSeq:351028NOTIFYContent-Type:Application/MANSCDP+xmlMax-forwards:70User-agent:NCGV3.3.6.827657Content-Length:762<?xmlversion="1.0"?><Notify><CmdType>Catalog</CmdType><SN>159814</SN><DeviceID>34012301012000193119</DeviceID><SumNum>1</SumNum><DeviceListNum="1"><Item><DeviceID>34012301581314000719</DeviceID><Event>OFF</Event><Name>............</Name><CatalogType>1</CatalogType><DecorderTag>hikvision</DecorderTag><RecLocation>1</RecLocation><OperateType>OFF</OperateType><CivilCode>34012301582160000089</CivilCode><IPAddress>192.1.13.10</IPAddress><Parental>0</Parental><ParentID>34012301582160000089</ParentID><Status>OFF</Status><Longitude>0</Longitude><Latitude>0</Latitude><Privilege>%03%03%00</Privilege><Info><CameraType>0</CameraType><XmlRev>{"disOrder":"6199"}</XmlRev></Info></Item></DeviceList></Notify>重點字段：上級目錄訂閱SUBSCRIBE的call-id與下級目錄通知Notify的call-id一致。區(qū)別本家對接資源報文與國標(biāo)報文的區(qū)別：本家對接會帶有CatalogType（資源類型）、DecodeTag（解碼標(biāo)識）、RecLocation（錄像存儲位置）、Privilege（控制權(quán)限）等私有字段。Notify的五種Event字段：ADD（新增共享）、DEL（取消共享）、UPDATE（更新）、ON（點位在線）、OFF（點位離線）。三、事件訂閱目前事件訂閱主要分為移動設(shè)備訂閱和報警訂閱，一般我們項目中常用的是移動設(shè)備訂閱，所以我們就移動設(shè)備訂閱重點說明。圖3.1事件訂閱說明詳情見國標(biāo)協(xié)議：9.11.1事件訂閱3.1、流程3.1.1、訂閱請求圖3.2事件訂閱流程事件訂閱流程示意描述如下：事件觀察者向事件源發(fā)送SUBSCRIBE請求，請求消息體攜帶訂閱參數(shù)；事件源應(yīng)將訂閱成功與否的響應(yīng)消息返回給該事件觀察者。詳情見國標(biāo)協(xié)議：9.11.1.2命令流程3.1.2、消息通知圖3.3事件訂閱通知事件通知流程示意描述如下：在訂閱事件觸發(fā)后事件源向事件觀察者發(fā)送NOTIFY消息，NOTIFY的消息體應(yīng)攜帶通知參數(shù)；事件源應(yīng)將通知的響應(yīng)消息返回給該事件觀察者。3.2、移動設(shè)備訂閱報文3.2.1、訂閱請求報文移動設(shè)備位置數(shù)據(jù)查詢<!--命令類型：移動設(shè)備位置數(shù)據(jù)查詢（必選）--><elementname="CmdType"fixed="MobilePosition"/><!--命令序列號（必選）--><elementname="SN"type="integer"minInclusivevalue="1"/><!--查詢移動設(shè)備編碼（必選）--> <elementname="DeviceID"type="tg:deviceIDType"/><!--移動設(shè)備位置信息上報時間間隔，單位：秒，默認值5（可選）--> <elementname="Interval"type="integer"/>詳情見：聯(lián)網(wǎng)系統(tǒng)控制描述協(xié)議（MANSCDP）命令集--移動設(shè)備位置數(shù)據(jù)查詢3.2.2、消息通知報文<elementname="TargetID"type="tg:deviceIDType"/>移動設(shè)備位置數(shù)據(jù)通知<!--命令類型：移動設(shè)備位置數(shù)據(jù)通知（必選）--><elementname="CmdType"fixed="MobilePosition"/><!--命令序列號（必選）--><elementname="SN"type="integer"minInclusivevalue="1"/><!--產(chǎn)生通知時間（必選）--><elementname="Time"type="dateTime"/><!--經(jīng)度（必選）--><elementname="Longitude"type="double"/><!--緯度（必選）--><elementname="Latitude"type="double"/><!--速度，單位：km/h（可選）--><elementname="Speed"type="double"/><!--方向，取值為當(dāng)前攝像頭方向與正北方的順時針夾角，取值范圍0-360度，單位：度（可選）--><elementname="Direction"type="double"/><!--海拔高度，單位：m（可選）--><elementname="Altitude"type="tg:deviceIDType"/>詳情見：聯(lián)網(wǎng)系統(tǒng)控制描述協(xié)議（MANSCDP）命令集--移動設(shè)備位置數(shù)據(jù)通知3.2.3、報文示例3.2.3.1、移動設(shè)備訂閱請求SUBSCRIBEsip:45010000002000000999@172.17.7.219:7100SIP/2.0Call-ID:7f52ebf84b2c93643e776523ec9fea0a@172.17.13.15CSeq:1SUBSCRIBEFrom:<sip:45010000002000000002@172.17.13.15:5061>;tag=07759692_5b7dabbe_699e6df5_68117d4e-4344-4e57-984d-6576976c86e7To:<sip:45010000002000000999@172.17.7.219:7100>Max-Forwards:70User-Agent:MobicentsSipServlets3.0.0-SNAPSHOTContact:<sip:45010000002000000002@172.17.13.15:5061>Via:SIP/2.0/UDP172.17.13.15:5061;branch=z9hG4bK68117d4e-4344-4e57-984d-6576976c86e7_699e6df5_6e032e9c-c3a2-4e62-9dcb-f77e71e10b09Event:Catalog;id=5048Expires:1800Content-Type:Application/MANSCDP+xmlContent-Length:157<?xmlversion="1.0"?><Query><CmdType>MobilePosition</CmdType><SN>5048</SN><DeviceID>45990100581314000037</DeviceID><Interval>6</Interval></Query>重點字段：移動設(shè)備訂閱請求是采用SUBSCRIBE請求，其中CmdType中攜帶MobilePosition表示移動設(shè)備訂閱。Expires:1800—表示訂閱周期為1800秒。Interval字段表示下級設(shè)備如果gps信息有變化，那么每隔6s上報一次。DeviceID：定義里面是表示查詢移動設(shè)備編碼，但是一般在項目中使用的時候是即可以對單個設(shè)備進行查詢也可以對整個下級域進行查詢。3.2.3.2、移動設(shè)備訂閱回復(fù)NOTIFYsip:45010000002000000002@172.17.13.