《第三方报警统一接入协议(共9页).docx》由会员分享,可在线阅读,更多相关《第三方报警统一接入协议(共9页).docx(9页珍藏版)》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、精选优质文档-倾情为你奉上注意保密第三方报警统一接入协议一、协议规则1、采用TCP长连接,海康报警服务器在60006 端口上监听。2、 客户端必须要有重连机制,在断开连接后,需要自动重连。3、 客户端需要每隔30s向服务器发送心跳包保活,若超过30s没发,服务器会自动关闭该连接。4、 防止粘包,每个消息(客户端请求和服务器响应)必须包含:二进制包头、包内容、二进制包尾。5、 为保证海康报警服务器的安全性,客户端必须根据海康提供的认证信息(用户名、密码)组成认证报文,进行登录认证,服务器返回认证结果报文,若通过认证,可以与服务器进行正常交互,否则,服务器断开连接。二、消息组成每个消息必须包含:二
2、进制包头、包内容、二进制包尾。总长度为 20 + N + 4 = 24+N 字节。1、整个消息的格式如下:头标志报文长度报文类型公司编号报文版本加密类型预留位包内容尾标志2、二进制包头(共20字节)格式如下:头标志报文长度报文类型公司编号报文版本加密类型预留位头标志 : 4字节, 值固定为 0X7B7B7B7B (即: )报文长度 : 4字节, 采用网络字节序 ,是包含头标志和尾标志在内的整个报文长度。报文类型 : 1字节, 值固定为 0X01,代表 “包内容” 为 XML格式。根据需要可适配其它格式,默认采用XML格式。 公司编号 : 1字节, 值为 0X01 至 0XFF,根据需要分配,默
3、认填 0X01。用于区分不同厂家。报文版本 : 1字节, 值为 0X01 至 0XFF,根据需要分配,默认填 0X01。加密类型 : 1字节,值为 0X01 至 0XFF,确定后,根据需要分配,其中0XFF表示不加密。如果加密,那么只是对包内容进行加密,默认不加密,填充 0XFF。加密类型(或编码类型)根据具体的类型编号确定。预留位 : 8字节, 8个字节全部填充 0XFF。其中,报文长度必须采用网络字节序,报文类型、公司编号、报文版本、加密类型根据实际情况双方协商。“包内容”默认采用XML格式,特殊情况可以双方协商格式。下文均以XML格式叙述。3、包内容包内容为XML格式。具体参见后面的 基
4、本XML格式规范。4、二进制包尾(4字节):二进制包尾仅含一个尾标志。尾标志: 4字节,值固定为0X7D7D7D7D(即: )三、基本XML格式规范XML信息包含: XML数据包头 和 XML包体 两部分。1、基本格式如下: 2、包头格式样例:Hikvision 1.0 123 Request Alarm Reserve 3、包体格式样例:3.1 登陆认证信息包体格式样例:3.1.1 客户端请求包体格式样例:admin 12345 Reserve 3.1.2 服务器响应登陆认证包体:SUCCESS 登录认证成功 Reserve 3.2 报警信息包体格式样例:3.2.1 客户端发送报警包体 1
5、2014-5-20 17:50:00 *公司 ?用户是指什么?需要和天维尔确认。 辽阳市*/用户地址 /用户主机电话 /用户账号 1 *商铺门口 100 控制器事件Start 张三 单位负责人电话 派出所名称 报警点X坐标 报警点Y坐标 区县标志 NONE Reserve 不能提供的字段设置为空。AlarmStatus: 代表报警状态,若报警有开始和结束状态,那么客户端在某个报警发生时,发送Start,代表该报警已经发生,当报警结束时,发送Stop ,代表报警停止,如果报警持续时间大于10秒,那么每隔10秒,发送一次脉冲Pulse,防止客户端关闭时没有发送Stop ,导致服务器始终认为该报警一
6、直在发生。若报警没有开始和结束状态,属于一次性报警,那么发送Once。即若是有开始、结束状态的报警,一般发送过程是:StartPulse -PulseStop 或StartStop若是一次性(瞬时)报警则是: Once 3.2.2服务器响应报警包体:SUCCESS Reserve AlarmId说明:如果设备在报警的同时会产生视频或图片,为保证报警不延迟则先向报警服务器发送一条没有URL的报警信息。服务端会向客户端返回一个带有的响应包。当客户端上传图片完成之后再向服务器发送一条报警。包含AlarmId和URL。如果设备在报警时没有产生图片或视频,则只上传一条即可,可不用填AlarmId和URL
7、。3.3心跳包体格式样例:3.3.1 客户端心跳包体Heartbeat Reserve 3.3.2服务器回复心跳包体SUCCESS Reserve 3.5 具体XML样例3.5.1客户端请求登陆认证整体XML报文样例 Hikvision 1.0123RequestLogin Reserveadmin 12345 Reserve 3.5.2服务器响应登陆认证报文整体XML样例 Hikvision 1.0123 Reponse Login ReserveFAIL 密码错误 Reserve 3.5.3报警信息整体XML样例 Hikvision 1.0123RequestAlarm Reserve 2
8、014-5-20 17:50:00 枫叶 辽阳市* 1 *商铺 100 控制器事件Start 张三 单位负责人电话 派出所名称 报警点X坐标 报警点Y坐标 区县标志 NONE Reserve 3.5.4报警信息响应整体XML样例 Hikvision 1.0123 Reponse Alarm ReserveSUCCESS Reserve 3.5.5 心跳整体XML样例 Hikvision 1.0123RequestHeartbeat ReserveHeartbeatReserve3.5.5 心跳响应整体XML样例 Hikvision 1.0123 Reponse Heartbeat ReserveSUCCESS Reserve 四、第三方提供信息1、第三方公司应该提供上传的 报警类型 和 报警名称 对应表。格式如下:AlarmType(报警类型)AlarmName(报警名称)10002移动侦测报警2、第三方公司的现场实施人员必须告知海康的现场技术人员相关设备的的编号及对应的防区数目信息。格式如下:设备编号防区数目8专心-专注-专业