更新时间:2025-12-29 GMT+08:00
分享

订阅LINK设备的通知消息

概述

ROMA Connect提供设备变更通知服务,当订阅的设备状态发生变化,如设备上线、下线、删除等,ROMA Connect会发送消息到对应的消息集成Topic,方便实时获取设备最新状态信息。

前提条件

已有可用的Topic,且Topic与设备在同一应用下,用于接收消息,否则请提前创建Topic

订阅设备通知消息

  1. 登录ROMA Connect控制台,在左侧导航栏选择“资源管理”,在实例页面单击实例,进入实例控制台。
  2. 在左侧的导航栏选择“设备集成 LINK > 订阅管理”。
  3. 在订阅管理页面中,选择要接收通知消息的Topic所属的集成应用。
  4. 在要订阅的消息通知类型下,选择要接收通知消息单独Topic,然后启用通知。
    • 通知的启用与关闭,最长的生效时间为30秒。
    • 设备变更包含以下操作时,触发消息通知。
      • 设备类型变更(例如普通设备修改为网关子设备)。
      • 设备名称变更。
      • 设备状态变更。
      • 设备描述变更。
    • 通知消息示例请参见设备通知报文示例

设备通知报文示例

以普通设备为例介绍订阅管理中MQS各报文示例。
  • 消息属性
    {
    	"deviceIdentifier":"iottest2", // 设备标识
    	"eventTime":"1588843914884",   // 消息时间
    	"gatewayIdentifier":"null",  // 网关设备标识
    	"deviceId":"D114VKx7a",        // 设备ID
    	"gatewayId":"null",           // 网关设备ID
    	"TAGS":"null"                  // 消息标签
    }
    • 普通设备/网关设备时,gatewayId和gatewayIdentifier的值设置为null。
    • 网关子设备时,gatewayId和gatewayIdentifier分别为其网关设备的deviceId和deviceIdentifier。
  • 消息内容
    1. 设备添加
      {
      	'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
      }
    2. 设备删除
      {
      	'notifyType':'deviceDeleted',	// 消息类型
      	'deviceIdentifier':'iottest2',	// 设备标识
      	'eventTime':'1588843914884',	// 消息时间
      	'deviceId':'D114VKx7a'	        // 设备ID
      }
    3. 设备上线
      {
          'notifyType':'deviceOnline',    // 消息类型-设备上线
          'deviceIdentifier':'iottest2',  // 设备标识
          'eventTime':'1588843914884',    // 消息时间
          'deviceId':'D114VKx7a'          // 设备ID
      }
    4. 设备下线
      {
          'notifyType':'deviceOffline',   // 消息类型
          'deviceIdentifier':'iottest2',  // 设备标识
          'eventTime':'1588843914884',    // 消息时间
          'deviceId':'D114VKx7a'          // 设备ID
      }
    5. 设备类型变更
      {
      	'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
      }

相关文档