使用自定义Topic通信

应用场景

• 服务端下发消息到设备端

  服务端调用Pub，可向指定的自定义Topic发布消息。设备通过订阅该Topic，接收来自服务端的消息。

• 设备端发送消息到服务端

  设备端向自定义Topic发布消息，服务端可通过物联网平台的AMQP订阅或云产品流转功能，接收来自设备端的消息。

• 设备与设备通信

  设备端向自定义Topic发布消息，可通过物联网平台的云产品流转或Topic消息路由，将消息转发到另一个设备的Topic。

添加自定义Topic类

1. 登录物联网平台控制台。

2. 在实例概览页签的全部环境下，找到对应的实例，单击实例卡片。

3. 在左侧导航栏，选择设备管理 > 产品。

4. 在产品页面，找到需要自定义Topic类的产品，并单击对应操作列中的查看。

5. 在产品详情页面，单击Topic类列表 > 自定义Topic > 定义Topic类。

6. 配置参数，单击确认。

   参数	描述
   设备操作权限	设备对该Topic的操作权限，可设置为： 发布：设备可以将消息通过该Topic发送到物联网平台。 订阅：设备订阅该Topic后，当服务端应用发送消息到该Topic时，物联网平台会把消息发送到设备。 发布和订阅：具备订阅和发布两个功能，即设备可以将消息通过该Topic发送到物联网平台，同时也可以通过该Topic接收消息。
   Topic类	Topic格式必须以/进行分层，区分每个类目。类目命名只能包含字母、数字和下划线（_），每级类目不能为空。 对于云网关产品，Topic类完全由用户自定义输入。支持使用通配符+和#，支持使用${deviceName}通配DeviceName。 对于非云网关产品： 只有设备操作权限为订阅时，才可以使用通配符+和#，以便设备实现批量订阅Topic。 自定义Topic类前三个类目已固定为/${productKey}/${deviceName}/user/，需将Topic类填充完整。 说明 通配符使用方法，请参见本文下方的带通配符的自定义Topic说明。
   是否开启代理订阅	设备操作权限为订阅或发布和订阅，可开启代理订阅。 开启代理订阅后，设备与物联网平台建连时，物联网平台查询已开启代理订阅的Topic，帮助设备完成订阅。
   是否开启压缩或解压缩	尊享型企业版实例下，可开启自定义Topic数据压缩或解压缩。数据压缩功能，请参见数据压缩。
   描述	可输入文字，描述该Topic类，用于区分不同Topic类的功能。

管理Topic类

您可在自定义Topic的Topic类列表中，找到对应自定义Topic类，执行以下操作。

编辑Topic类

1. 单击Topic类对应操作列的编辑。

2. 在定义Topic类对话框，修改描述、设备操作权限和Topic类。

3. 单击确认。

设置是否开启代理订阅

找到操作权限为订阅或发布和订阅的Topic类，单击是否开启代理订阅开关或。

删除Topic类

1. 单击Topic类对应操作列的删除。

2. 单击确认。

带通配符的自定义Topic说明

物联网平台支持自定义Topic类时，使用以下通配符。

自定义Topic通信示例

• 服务端与设备端通信：

  • 服务端下发指令给设备

  • 设备发送消息到服务端

• 设备与设备通信：

  • 基于消息转发的M2M设备间通信

  • 基于Topic消息路由的M2M设备间通信

存储自定义Topic通信数据

自定义Topic中数据可流转到热数据存储空间进行存储。您可单击Topic列表上方的点击配置，跳转到数据服务>数据存储页面的热数据存储页签，配置热数据存储规则。具体内容，请参见配置自定义Topic数据存储。

相关API

相关文档

物联网平台要求设备上报消息的数据格式要求为Alink JSON，如果设备的消息格式不是Alink JSON，必须使用消息解析将设备上报的自定义Topic数据解析为Alink JSON格式，通过自定义Topic下发设备的数据格式没有限制。消息解析的概念和使用步骤，请参见什么是消息解析。

常见问题

• 通过接口Pub下发消息成功后，设备没有收到消息为什么？

• 自定义Topic通信数据的标准JSON格式是什么？

• 真实的设备接入需要与产品中的设备保持同一个Topic吗？

• 如何设置和修改通信Topic的操作权限？

• 两个设备之间能通信吗？

• 物联网平台是否会保存消息？

• 物联网平台的设备数据，在不转储的情况下，数据保留多长时间？

• 设备上报数据能导出吗？