消息
该章节主要用于描述平台设备产生的消息格式和如何将消息推送给开发者。平台产生的消息主要分五类:异常报警相关消息、设备状态相关消息、智能报警消息、级联推送消息、观看时间消息、4G卡套餐消息。具体说明如下:
异常报警相关消息:移动侦测告警、人形检测告警、遮挡告警、周界入侵告警、存储类告警等。
设备状态相关消息:设备上线消息、设备下线消息、设备名称变更消息、通道名称变更消息、通道状态变更消息。
智能报警消息:人脸识别消息、客流量消息、电瓶车检测消息、高抛检测消息等。
级联推送消息(无需开通,默认推送):平台登录消息、平台登出消息、平台名称变更消息、平台组织相关消息、平台设备相关消息、平台资源相关消息等。
观看时间消息:包含视频观看开始时间和结束时间的消息。
4G卡套餐消息:包含4G卡套餐到期,4G卡套餐余量不足,4G卡套餐充值成功等消息。
平台消息推送的到达率取决于开发者的服务稳定性及处理能力,消息推送失败后平台会重试3次,但是时效性会降低。平台不存储任何消息,消息丢失后不可再获得。
开发者需先在平台中进行开通消息推送操作,并选择消息推送方式和消息类型。平台中提供两种方式将消息推送给开发者:
- 第一种:提供消息SDK,开发者集成SDK后便可收到消息。
- 第二种:通过消息回调,开发者提供httpServer接口,平台产生消息后调用开发者提供的回调接口,将消息推送给开发者。两种推送方式只一种生效,请根据具体情况选择。
两种消息推送方式有什么异同?
- 相同点:两种方式都能正常接收平台产生的所有类型消息。
- 不同点:消息回调对接方式简单,适用于设备接入量较小,消息较少的情况下快速对接,需要设置消息回调地址;sdk对接方式需要集成平台提供的sdk及证书,适用于设备接入较大,消息较多的情况,当前SDK只提供java版本。
具体消息格式,开通方式和两种推送方式见子章节。