简介

设备消息通道是设备消息上行的通道, 用户基于消息通道可以收到设备上报的消息.如果需要接受设备产生的移动侦测、人脸抓拍、人形检测、区域检测及告警网管的告警信息，可以下载消息通道SDK进行集成；
设备消息通道具有高可用分布式集群技术,具备高吞吐、消息堆积、可靠重试等特性，不易产生漏传

开通设备消息通道有如下注意事项:

1. 设备消息通道是企业版服务，个人版无法开通
2. 开通消息通道的账号被标识为企业账户，将无法登录萤石云视频与萤石工作室
3. 设备消息通道开通后，在消息列表接口中将无法获取
4. 获取到的消息需要用户自己保存到服务器，再由用户自己实现管理分发
5. 请仔细阅读上述注意事项
6. 开通设备消息通道请前往工单(需先登录)

点击此处 下载SDK包

快速使用，请查阅设备消息通道SDK及使用方法

核心概念

• Topic：消息主题，一个用户对应一个topic，用户之间隔离, 生产者向其发送消息。
• 生产者：也称为消息发布者，负责生产并发送消息至 Topic。一般理解为设备本身或平台作为设备消息的转发方
• 消费者：也称为消息订阅者，负责从 Topic 接收并消费消息，消费者如果30s内没有消费消息，会自动断开，建议将消费消息间隔控制在30s内
• 消息：生产者向 Topic 发送并最终传送给消费者的数据和（可选）属性的组合。
• 消息属性：生产者可以为消息定义的属性，包含 Message Key 和 Tag。
• Group：一类消费者，组与组之间是隔离的，一个group中只能有一个消费者可以进行消费

消息收发模型

消息生产者应用 将消息发送到 Topic。消费者应用(租户应用)创建对 Topic 的订阅以便从其接收消息。租户可通过多个组重复消费消息。

具体通信如下图所示。

• 生产者集群 : 用来表示发送消息应用,一个生产者集群可以发送多个 Topic 消息。
• 消费者集群：用来表示消费消息应用，一个消费者集群下包含多个消费者实例，消费者集群就是用户应用。 一个消费者集群对应一个 Group ID，比如: group1.

产品功能

协议接入

目前消息通道支持HTTP协议接入,采用 RESTful 风格，方便易用，快速接入，跨网络能力强。
开放平台提供封装完毕功能完善的java sdk及对应demo：SDK及说明

消息类型

目前消息通道支持多种消息类型, 包括: 萤石设备告警消息，海康行业设备消息提醒, 设备上下线, 布撤防等.

附录:消息字段返回字段

type为ys.alarm即表示萤石云告警消息，以下是告警消息结构体：

type为ys.onoffline即表示萤石云上下线消息，以下是上下线消息结构体：

附录:萤石设备告警消息类型

注：除特殊注明的告警类型以外，其他告警类型都受1分钟最小告警间隔限制,即一分钟最大收到一条告警消息，萤石告警消息仅限于萤石设备产生的特定消息类型，以下消息为穷举类型，不一定具备实际能力，仅供参考