FogCloud MQTT topic说明文档（V3.1）

V3.1

格式说明

目前topic分为两类，自定义topic和物影子topic，两种topic的格式如下：

• 自定义topic
  

  
  
  

• 物影子topic

$baidu/iot/shadow/{device_id}/operate_type/+

topic使用规则

APP下发指令和设备接收指令

说明：

• 使用自定义topic
• App需要控制设备时，使用该规则，如，开关灯等；

topic:

• $baidu/iot/define/device_id/product_id/control/json

消息格式:

{
    "":[],
    "": {
        "":""
    }
}

设备上报实时数据和App接收设备实时数据

说明：

• 使用物影子topic
• 设备正常上报实时数据使用该topic规则

设备上报实时数据topic:

• $baidu/iot/shadow/{device_id}/update：向该topic中pub数据，会更新百度物影子中的数据

消息格式:

{
    "requestId": "123",
    "reported": {
        "ColorMode": 1,
        "Switch": 0,
        "Color": "255,255,255",
        "Brightness": 100,
        "Scene": 1,
        "DelayCloseExecute": 1,
        "RememberStatus": 0
    }
}

字段说明：

• requestId为请求的唯一标识符，每一个请求的requestId是唯一的，可随机生成;
  
  • reported为数据字段，代表物影子中设备上报的最新状态。服务端能通过MQTT或HTTP从reported字段中拿到物影子的最新状态；

App实时接收设备数据topic:

• $baidu/iot/shadow/{device_id}/update/snapshot：订阅该topic后，只要设备更新物影子数据，就可以实时收到该部分数据

消息格式:

{
    "requestId":"123",
    "profileVersion":8,
    "reported":{
        "ColorMode":1,
        "Switch":0,
        "Color":"255,255,255",
        "Brightness":100,
        "Scene":1,
        "DelayCloseExecute":3,
        "RememberStatus":0
    },
    "lastUpdatedTime":{
        "reported":{
            "ColorMode":1519888552623,
            "Switch":1519888552623,
            "Color":1519888552623,
            "Brightness":1519888552623,
            "Scene":1519888552623,
            "DelayCloseExecute":1519888552623,
            "RememberStatus":1519888552623
        }
    }
}

字段说明：

• reported: 解析该字段，获取设备数据

App主动获取设备数据

说明：

• 使用物影子topic
• 当app需要主动获取设备数据时（比如，进入控制页面时），使用下述topic规则；

topic
- $baidu/iot/shadow/{device_id}/get：向该topic pub如下格式的数据：

{
    "requestId": "{requestId}"
}

• $baidu/iot/shadow/{device_id}/get/accepted：sub该topic接收物影子数据;收到消息的格式如下：

{
    "requestId":"1234",
    "reported":{
        "ColorMode":1,
        "Switch":0,
        "Color":"255,255,255",
        "Brightness":100,
        "Scene":1,
        "DelayCloseExecute":3,
        "RememberStatus":0
    },
    "desired":{
        "ColorMode":1,
        "Switch":0,
        "Color":"255,255,255",
        "Brightness":10
    },
    "lastUpdatedTime":{
        "reported":{
            "ColorMode":1519888552623,
            "Switch":1519888552623,
            "Color":1519888552623,
            "Brightness":1519888552623,
            "Scene":1519888552623,
            "DelayCloseExecute":1519888552623,
            "RememberStatus":1519888552623
        },
        "desired":{
            "ColorMode":1519887873874,
            "Switch":1519887873874,
            "Color":1519887873874,
            "Brightness":1519887873874
        }
    },
    "profileVersion":8
}

• reported: 解析该字段，获取设备数据