订阅LINK设备的通知消息
概述
ROMA Connect提供设备变更通知服务,当订阅的设备状态发生变化,如设备上线、下线、删除等,ROMA Connect会发送消息到对应的消息集成Topic,方便实时获取设备最新状态信息。
前提条件
已有可用的Topic,且Topic与设备在同一应用下,用于接收消息,否则请提前创建Topic。
订阅设备通知消息
- 登录ROMA Connect控制台,在左侧导航栏选择“资源管理”,在实例页面单击实例,进入实例控制台。
- 在左侧的导航栏选择“设备集成 LINK > 订阅管理”。
- 在订阅管理页面中,选择要接收通知消息的Topic所属的集成应用。
- 在要订阅的消息通知类型下,选择要接收通知消息单独Topic,然后启用通知。
- 通知的启用与关闭,最长的生效时间为30秒。
- 设备变更包含以下操作时,触发消息通知。
- 设备类型变更(例如普通设备修改为网关子设备)。
- 设备名称变更。
- 设备状态变更。
- 设备描述变更。
- 通知消息示例请参见设备通知报文示例。
设备通知报文示例
- 消息属性
{ "deviceIdentifier":"iottest2", // 设备标识 "eventTime":"1588843914884", // 消息时间 "gatewayIdentifier":"null", // 网关设备标识 "deviceId":"D114VKx7a", // 设备ID "gatewayId":"null", // 网关设备ID "TAGS":"null" // 消息标签 }
- 普通设备/网关设备时,gatewayId和gatewayIdentifier的值设置为null。
- 网关子设备时,gatewayId和gatewayIdentifier分别为其网关设备的deviceId和deviceIdentifier。
- 消息内容
- 设备添加
{ 'deviceType':'Default', // 设备类型 'instanceOid':'40', // 实例Oid 'manufacturerName':'iotcompro1',// 厂商名称 'productOid':'1', // 产品Oid 'manufacturerId':'iotcompro1', // 厂商ID 'remark':'', // 设备描述 'deviceId':'D114VKx7a', // 设备ID 'deviceName':'iottest2', // 设备名称 'productName':'iotcompro1', // 产品名称 'notifyType':'deviceAdded', // 消息类型 'deviceIdentifier':'iottest2', // 设备标识 'deviceOid':'14', // 设备Oid 'createdBy':'admin', // 创建者 'eventTime':'1588843914884', // 消息时间 'model':'iotcompro1', // 产品模型 'productType':'0', // 产品类型 1-网关产品 0-普通产品 'status':'0', // 设备状态 0-启用 1-禁用 'parentDeviceOid':'null' // 父设备Oid } - 设备删除
{ 'notifyType':'deviceDeleted', // 消息类型 'deviceIdentifier':'iottest2', // 设备标识 'eventTime':'1588843914884', // 消息时间 'deviceId':'D114VKx7a' // 设备ID } - 设备上线
{ 'notifyType':'deviceOnline', // 消息类型-设备上线 'deviceIdentifier':'iottest2', // 设备标识 'eventTime':'1588843914884', // 消息时间 'deviceId':'D114VKx7a' // 设备ID } - 设备下线
{ 'notifyType':'deviceOffline', // 消息类型 'deviceIdentifier':'iottest2', // 设备标识 'eventTime':'1588843914884', // 消息时间 'deviceId':'D114VKx7a' // 设备ID } - 设备类型变更
{ 'instanceOid':'40', // 实例Oid 'productOid':'1', // 产品Oid 'remark':'', // 设备描述 'deviceId':'D114VKx7a', // 设备ID 'deviceName':'iottest1', // 设备名称 'notifyType':'deviceChange', // 消息类型 'deviceIdentifier':'iottest1', // 设备标识 'deviceOid':'1', // 设备Oid 'createdBy':'admin', // 创建者 'eventTime':'1588843914884', // 消息时间 'status':'0', // 设备状态 0-启用 1-禁用 'parentDeviceOid':'null' // 父设备Oid }
- 设备添加