什么是Topic

产品Topic类

为了方便海量设备基于海量Topic进行通信，简化授权操作，物联网平台增加了产品Topic类的概念。Topic类是一类Topic的集合。例如，产品的自定义Topic类/${YourProductKey}/${YourDeviceName}/user/update是具体Topic/${YourProductKey}/device1/user/update、/${YourProductKey}/device2/user/update等的集合。

您创建设备后，产品的所有Topic类会自动映射到设备上。您无需单独为每个设备创建Topic。

在物联网平台控制台，选择设备管理 > 产品，单击产品对应的查看，进入产品详情页，单击Topic类列表页签，可以在基础通信Topic、物模型通信Topic、自定义Topic页签查看相应的Topic类。关于这三类Topic的说明，请参见Topic分类。

Topic类列表中：

• Topic类以正斜线（/）进行分层，区分每个类目。其中，有两个类目为既定类目：${YourProductKey}表示产品的标识符ProductKey；${YourDeviceName}表示设备名称。
• 操作权限：
  • 发布表示设备可以往该Topic发布消息。
  • 订阅表示设备可以订阅该Topic获取消息。

    订阅（SUB）和取消订阅（UNSUB）指令都需由设备发起。设备发送SUB指令订阅某个Topic后，该订阅永久生效；仅在设备发起UNSUB指令取消订阅该Topic后，订阅才会被取消。

  如果您需要管控单个设备的消息收发，请在控制台的设备列表页或服务端调用DisableThing接口，禁用该设备；或在业务上管控发送给设备的消息。

设备Topic

产品的Topic类不用于通信，只是定义Topic。用于消息通信的是具体的设备Topic。

创建设备后，从产品Topic类映射出设备Topic。设备Topic格式和产品Topic类格式一致，区别在于Topic类中的变量${YourDeviceName}，在Topic中是具体的设备名称（DeviceName）。

设备Topic只能被该设备用于消息通信。例如，Topic：/${YourProductKey}/device1/user/update归属于设备device1，所以只能被设备device1用于发布或订阅消息，而不能被设备device2用于发布或订阅消息。

设备发送SUB指令订阅某个Topic后，在物联网平台控制台，选择设备管理 > 设备，单击设备对应的查看，进入设备详情页，单击Topic列表页签，已订阅Topic列表展示了设备订阅成功的所有Topic。云端系统可以通过其中的Topic发送下行消息。

单击列表中的自定义Topic对应的发布消息，可指定一条消息，发布到设备端。使用通配符的自定义Topic除外，详情请参见带通配符的自定义Topic。

设备可以通过UNSUB指令取消与指定Topic的订阅关系，取消成功后，该Topic从已订阅Topic列表中删除。

Topic分类

物联网平台将Topic分为三类。