本文介绍如何为产品自定义Topic类。自定义Topic类将自动映射到该产品下的所有设备中。

背景信息

物联网平台Topic定义和使用说明，请参见什么是Topic。

添加自定义Topic

  1. 登录物联网平台控制台。
  2. 在实例概览页面，找到对应的实例，单击实例进入实例详情页面。
    实例概览
  3. 在左侧导航栏，选择设备管理 > 产品。
  4. 在产品页面，找到需要自定义Topic类的产品，并单击对应操作栏中的查看按钮。
  5. 在产品详情页面，单击Topic类列表 > 自定义Topic > 定义Topic类。
  6. 配置参数，单击确认。
    自定义Topic
    参数 描述
    设备操作权限 设备对该Topic的操作权限，可设置为发布、订阅、发布和订阅。
    Topic类 将Topic类填充完整。类目命名只能包含字母、数字和下划线（_），每级类目不能为空。
    说明 只有设备操作权限为订阅时，才可以使用通配符+和#自定义Topic类，以便设备实现批量订阅Topic。通配符使用方法请参见带通配符的自定义Topic 。
    描述 可输入文字，描述该Topic类，用于区分不同Topic的功能。

带通配符的自定义Topic

物联网平台支持在设备操作权限为订阅的自定义Topic中，使用两种通配符，以便设备实现批量订阅Topic。

通配符 描述
# #只能出现在Topic的最后一个类目，代表本级及下级所有类目。

例如：自定义Topic/a1aycMA****/${deviceName}/user/#。设备device1订阅/a1aycMA****/device1/user/#，表示订阅以/a1aycMA****/device1/user/为开头的全部Topic，包含/a1aycMA****/device1/user/update、/a1aycMA****/device1/user/update/error等Topic。

+ 代表本级所有类目。

例如：自定义Topic/a1aycMA****/${deviceName}/user/+/error。设备device1订阅/a1aycMA****/device1/user/+/error，表示订阅/a1aycMA****/device1/user/get/error、/a1aycMA****/device1/user/update/error等Topic。

由于带通配符的Topic实质为一组Topic的集合，因此带通配符的Topic不支持在设备的Topic列表页面执行发布消息操作，将消息发布到已订阅该Topic的设备。

使用自定义Topic通信

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

使用自定义Topic通信的示例，请参见使用自定义Topic进行通信。