视频级联GB28281协议详解-订阅流程解析

订阅流程解析一、前言目录订阅有别与资源检索流程，主要是订阅下级的资源状态，下级在订阅周期内点位或组织发生变化，下级将通过notify报文通知上级，上级进行相应的状态变更。平台级联之间的订阅采用的是域间订阅流程。事件订阅主要应用于移动设备订阅。详情见9.11订阅和通知。二、目录订阅2.1、流程联网系统间采用订阅通知机制实现状态变化的设备信息的传送，用于提供联网系统间设备状态一致性的维护机制。SIP域可通过订阅方式订阅其他SIP域的全部或部分目录的离线、上线、增加、删除、更新等变更信息；被订阅域在目录变更后，应将变更事件通知订阅域。订阅通知消息使用IETFRFC3265规定的SUBSCRIBE、NOTIFY方法实现。某一SIP域可进行其他多个SIP域目录信息的订阅，也可接受其他多个SIP域的订阅。本域保存订阅目录、被订阅目录列表，在本域被订阅目录变更后向订阅域发送通知消息，订阅域接收到通知消息后进行相应更新处理。图2.1订阅流程信令流程如下：A域向B域发送初始订阅消息，开始订阅B域设备状态。Expire头域携带订阅过期时间应可配置，默认600s。B域在过期时间到来时未收到刷新订阅消息则移除A域的订阅状态。为保持两个域间目录状态一致，订阅域在进行初始订阅成功后需默认被订阅对象范围内的目录状态为在线，被订阅域在收到初始订阅消息后，需要通知被订阅对象范围内目录的离线和其他异常状态。a）A域向B域发送订阅消息，订阅参数可以为B域系统ID、B域下级系统ID、B域范围内行政区划编码、B域设备ID、B域上报的业务分组ID、虚拟组织ID。订阅对象为B域系统ID时，B域检测到直属目录和下级域的目录变更事件时应向A域发送通知消息；订阅对象为B域下级系统ID时，B域检测到对应此ID的下级系统范围内的目录变更事件时应向A域发送通知消息；订阅对象为B域范围内行政区划编码时，B域检测到属于此行政区划的目录变更事件时应向A域发送通知消息；订阅对象为B域设备ID时，B域检测到该设备及其下属子设备发生目录变更事件时应向A域发送通知消息；订阅对象为B域上报的业务分组ID、虚拟组织ID时，B域检测到该业务分组、虚拟组织下属虚拟组织、设备发生目录变更事件时应向A域发送通知消息。b）B域在检测到被订阅范围内目录变更事件时应根据接收的订阅者列表，向处于订阅有效期的域发送目录状态通知消息。详情见附录P.2.1相邻域间目录订阅通知2.1.1、刷新订阅A域在初始订阅成功之后，应在过期之前向B域发送刷新订阅消息，进行订阅状态维护。 刷新订阅消息与初始订阅消息属于同一会话，并且Expire头域值大于0。详情见：P.2.1.22.1.2、取消订阅若A域不再订阅B域目录变更，应向B域发送取消订阅请求。取消订阅请求应与初始订阅请求属于同一会话，并且Expire头域值为0。B域收到取消订阅请求后应移除A域的订阅状态，目录变更后不再通知A域。详情见：P.2.12.1.3、命令流程图SEQ图\*ARABIC2.2订阅流程命令流程描述如下订阅域向被订阅域发送初始订阅SUBSCRIBE消息，订阅目的域的目录变更事件，消息头域中使用Event头域描述订阅事件（SUBSCRIBE消息、NOTIFY消息需携带Evnet头域描述订阅事件。Event头域格式为“Catalog;id=num”其中，num为数字取值），消息体中携带订阅的详细参数，使用Expire头域指定订阅过期时间；被订阅域设备收到订阅消息后，向订阅域发送200OK响应；对于初始订阅操作，被订阅域立即发送NOTIFY消息携带离线及其他异常状态设备目录，消息头域中使用Event头域描述订阅事件；订阅域收到NOTIFY消息后回复200OK响应；被订阅域目录变更后，通过NOTIFY消息将变更事件通知订阅域，消息头域中使用Event头域描述订阅事件；订阅域收到NOTIFY消息后回复200OK响应；订阅域在过期之前向被订阅域发送刷新订阅SUBSCRIBE消息，订阅目的域的目录变更事件，消息头域中使用Event头域描述订阅事件，消息体中携带订阅的详细参数，使用Expire头域指定订阅过期时间；被订阅域设备收到订阅消息后，向订阅域发送200OK响应；被订阅域目录变更后，通过NOTIFY消息将变更事件通知订阅域，消息头域中使用Event头域描述订阅事件；订阅域收到NOTIFY消息后回复200OK响应；订阅域向被订阅域发送取消订阅SUBSCRIBE消息，消息头域中使用Event头域描述订阅事件，消息体中携带订阅的详细参数，Expire头域值为0；被订阅域设备收到订阅消息后，向订阅域发送200OK响应，取消向订阅域发送目录变更通知消息。2.2、订阅报文2.2.1、订阅请求<?xmlversion="1.0"?><Query><!--命令类型：目录订阅（必选）--><CmdType>Catalog</CmdType><!--命令序列号（必选）--><SN>命令序列号</SN><!--订阅的系统/行政区划/设备/业务分组/虚拟组织编码（必选）--><DeviceID>订阅编码</DeviceID></Query>详情见：P.4.2.1订阅消息2.2.2、消息通知<?xmlversion="1.0"?><Notify><!--命令类型：目录订阅（必选）--><CmdType>Catalog</CmdType><!--命令序列号（必选）--><SN>命令序列号</SN><!--订阅的系统/行政区划/设备/业务分组/虚拟组织编码（必选）--><DeviceID>订阅编码</DeviceID><!--通知消息中SumNum取值与DeviceList中Num取值相同（必选）--><SumNum>2</SumNum><DeviceListNum=＂2＂><Item> <!--状态改变的系统/设备/行政区划编码（必选）--> <DeviceID>编码1</DeviceID><!--状态改变事件ON：上线，OFF：离线，VLOST：视频丢失，DEFECT：故障，ADD：增加，DEL：删除，UPDATE：更新（必选）--> <Event>OFF</Event></Item><Item> <!--状态改变的系统/设备/行政区划编码（必选）--> <DeviceID>编码n</DeviceID><!--状态改变事件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—表示订阅周期，在此周期内下级有变化的需要通知上来，上级在订阅周期内下发刷新订阅；0表示取消订阅。DeviceID：表示订阅的下级域编码刷新订阅跟第一次订阅怎么看？新订阅是同一个Call-ID。2.2.3.2、目录订阅回复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一致。区别本家对接资源报文与国标报文的区别：本家对接会带有CatalogType（资源类型）、DecodeTag（解码标识）、RecLocation（录像存储位置）、Privilege（控制权限）等私有字段。Notify的五种Event字段：ADD（新增共享）、DEL（取消共享）、UPDATE（更新）、ON（点位在线）、OFF（点位离线）。三、事件订阅目前事件订阅主要分为移动设备订阅和报警订阅，一般我们项目中常用的是移动设备订阅，所以我们就移动设备订阅重点说明。图3.1事件订阅说明详情见国标协议：9.11.1事件订阅3.1、流程3.1.1、订阅请求图3.2事件订阅流程事件订阅流程示意描述如下：事件观察者向事件源发送SUBSCRIBE请求，请求消息体携带订阅参数；事件源应将订阅成功与否的响应消息返回给该事件观察者。详情见国标协议：9.11.1.2命令流程3.1.2、消息通知图3.3事件订阅通知事件通知流程示意描述如下：在订阅事件触发后事件源向事件观察者发送NOTIFY消息，NOTIFY的消息体应携带通知参数；事件源应将通知的响应消息返回给该事件观察者。3.2、移动设备订阅报文3.2.1、订阅请求报文移动设备位置数据查询<!--命令类型：移动设备位置数据查询（必选）--><elementname="CmdType"fixed="MobilePosition"/><!--命令序列号（必选）--><elementname="SN"type="integer"minInclusivevalue="1"/><!--查询移动设备编码（必选）--> <elementname="DeviceID"type="tg:deviceIDType"/><!--移动设备位置信息上报时间间隔，单位：秒，默认值5（可选）--> <elementname="Interval"type="integer"/>详情见：联网系统控制描述协议（MANSCDP）命令集--移动设备位置数据查询3.2.2、消息通知报文<elementname="TargetID"type="tg:deviceIDType"/>移动设备位置数据通知<!--命令类型：移动设备位置数据通知（必选）--><elementname="CmdType"fixed="MobilePosition"/><!--命令序列号（必选）--><elementname="SN"type="integer"minInclusivevalue="1"/><!--产生通知时间（必选）--><elementname="Time"type="dateTime"/><!--经度（必选）--><elementname="Longitude"type="double"/><!--纬度（必选）--><elementname="Latitude"type="double"/><!--速度，单位：km/h（可选）--><elementname="Speed"type="double"/><!--方向，取值为当前摄像头方向与正北方的顺时针夹角，取值范围0-360度，单位：度（可选）--><elementname="Direction"type="double"/><!--海拔高度，单位：m（可选）--><elementname="Altitude"type="tg:deviceIDType"/>详情见：联网系统控制描述协议（MANSCDP）命令集--移动设备位置数据通知3.2.3、报文示例3.2.3.1、移动设备订阅请求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>重点字段：移动设备订阅请求是采用SUBSCRIBE请求，其中CmdType中携带MobilePosition表示移动设备订阅。Expires:1800—表示订阅周期为1800秒。Interval字段表示下级设备如果gps信息有变化，那么每隔6s上报一次。DeviceID：定义里面是表示查询移动设备编码，但是一般在项目中使用的时候是即可以对单个设备进行查询也可以对整个下级域进行查询。3.2.3.2、移动设备订阅回复NOTIFYsip:45010000002000000002@172.17.13.