IoT视频云

  • IoT视频云 > 产品手册 > 应用管理 >自定义Topic

    自定义Topic

    最近更新时间:2019-12-19 12:14:06

    什么是Topic

    IoT视频云平台中服务端和设备端通过Topic来实现消息通信,消息流转Topic分为自定义Topic和系统Topic,应用下的Topic会自动映射到应用下的所有设备中,自动填入设备对应的appid和device信息生成用于消息通信的具体设备Topic。

    自定义Topic

    自定义Topic有三种权限: 发布权限, 订阅权限和发布订阅权限, 发布权限表示设备可以往该Topic发布消息, 订阅权限表示设备可以订阅该Topic获取消息,发布订阅权限表示设备可以同时订阅Topic消息和往Topic发布消息。
    说明:

    • 用户在IoT视频云平台中对应的应用下添加的Topic会自动映射到该应用下的所有设备上,您无需单独为每个设备创建Topic。
    • 用户定义新的topic需要设备端同步更新,故需要替换新的SDK。

    服务端订阅Topic示例

    • 如果希望订阅应用下所有设备的数据, 订阅的Topic中device字段请使用通配符+, 如:
      udf/linking/v1/3nm4x087b30o3/+/status/
    • 如果希望订阅单个设备的数据, 订阅的Topic中请使用base64安全编码的设备名称, 如:
      udf/linking/v1/3nm4x087b30o3/SVBDLTA1RDY=/status/

    设备端订阅Topic示例

    • 设备端订阅Topic时,appid、devicename均为通配符, 如:
      udf/linking/v1/${appid}/${device}/bind/

      系统Topic

      系统Topic为IoT视频云平台预定义的Topic, 用户无需单独创建;系统Topic均以linking/v1/${appid}/${device}/ 作为前缀, 以/为结尾。其中, ${appid}, ${device}为系统占位符, IoT视频云平台会自动填入设备对应的appid和device信息。
      系统Topic具体功能请参考下述表格:
    Topic 权限 功能说明
    linking/v1/${appid}/${device}/rpc/request/+/ 订阅 ⽤于设备订阅RPC请求
    linking/v1/${appid}/${device}/rpc/response/+/ 发布 ⽤于设备响应RPC请求
    linking/v1/${appid}/${device}/result/accepted/ 订阅 用于设备获取设备影子更新成功的最新消息
    linking/v1/${appid}/${device}/result/rejected/ 订阅 用于获取设备影子更新失败的最新消息
    linking/v1/${appid}/${device}/result/control/ 订阅 用于设备影子反控设备
    linking/v1/${appid}/${device}/shadow/update/ 发布 用于设备端发布消息后将消息的状态更新到设备影子中

    创建Topic

    操作说明

    1.登录七牛开发者平台

    2.选择IoT视频云产品,进入产品控制台,选择我的应用进入应用列表。
    3.选择需要创建topic的应用,点击配置进入应用配置页面。
    4.选择自定义Topic,点击创建Topic进行添加,输入Topic名称设备操作权限,点击确定完成添加。

    配置项说明

    配置项 说明
    Topic名称 Topic名称只能由 1-56 位字母数字下划线组成
    设备操作权限 设备对该Topic的操作权限,可设置为发布、订阅、发布和订阅
    以上内容是否对您有帮助?
  • Icon free helper
    Close