前端系统上报的设备资源信息采用SIP的NO TIFY消息,消息体应采用XML进行封装。前端系统在上报资源信息时,应按照逐级发送的方式,发送的资源信息记录建议组合成小于MTU尺寸的封包进行上报,也允许单个分批的发送方式(分批次NOTIFY上去)。
资源上报属于数据接口。
接口流程
主要功能流程如下:
a) F1:注册成功后,前端系统向其注册平台首次发送上报资源信息的 SIP 消息。
b) F2:平台确认,发送 200 OK 响应。
c) F3:前端系统向其注册平台第二次发送上报资源信息的 SIP 消息。
d) F4:平台确认,发送 200 OK 响应。
接口参数
重要的SIP头字段如下:
SIP响应返回码:
XML S ch e ma 参数定义:
消息示例
上报前端系统的资源
NOT IFY s ip: 前端系统所属平台地址编码@前端系统所属平台域名或IP地址 SIP/2.0
Fr om: <sip: 前端系统地址编码@前端系统所属平台域名或IP地址>;tag=f2161243
To: <sip: 前端系统所属平台地址编码@前端系统所属平台域名或IP地址>
Con tact: <sip: 前端系统地址编码@前端系统所属平台域名或IP地址>
Ca ll-ID: c47e42
Via: SIP/2.0/UDP 前端系统所属平台IP地址;branch=z9hG4bK
CS eq: 1 NOTIFY
Con tent-type: applica tion/xml
Cont ent-Length: 消息体的长度
<?xml versi on="1.0" encodi ng="UTF-8"?>
<SIP_XML EventT ype=Push_R esourse>
<Code>父节点(平台、场所、前端设备)地址编码</Code>
<Sub List Su bNum=2>
<!-- 场地、前端设备、摄像机的地址编码 -->
<I tem Code=”设备地址编码” Name=”名称” St atus=1 Deco derTag=解码插件标签 Longi tude=”经
度值” Lat itude=”纬度值” Su bNum=”包含的字节点数目”/>
<Item Co de=”设备地址编码” Na me=”名称” S tatus=0 Deco derTag=解码插件标签 Longi tude=”经
度值” Lati tude=”纬度值” SubN um=”包含的字节点数目”/>
</SubList>
</SIP_XML>
响应消息
SIP/2.0 200 OK
Fr om: <sip: 前端系统地址编码@前端系统所属平台域名或IP地址>;tag=f2161243
To: <sip: 前端系统所属平台地址编码@前端系统所属平台域名或IP地址>;tag=2c10390
Con tact: <sip: 前端系统所属平台地址编码@前端系统所属平台域名或IP地址>
以上是国网B接口资源上报(Push_Re sourse)接口描述和消息示例,国网B接口的资源上报,有点类似于GB28181的设备目录查询(Cat alog),只是GB28181的Catalog是平台端发起,然后接入端响应并上报的,感兴趣的开发者,可以对照GB/T28181-2016相关规范看看。