FogCloud设备接入物影子说明文档（V3.1）

V3.1

云端操作

1. WEB前端在建立产品的时候，在百度物模型创建对应模型，模型中包含该产品需要的属性；
2. 设备激活时，激活接口使用新版物管理创建设备的接口，接口中传入第一步中的模型ID，此时模型属性将复制到该设备的属性中；

设备端操作

更新影子

1. 将信息推送到主题'$baidu/iot/shadow/{device_id}/update'，可实现将设备状态更新到设备影子；数据格式如下:

   {
   "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字段中拿到物影子的最新状态；

2. 订阅主题'$baidu/iot/shadow/{device_id}/update/accepted'获取物影子更新成功后的结果;

3. 订阅主题'$baidu/iot/shadow/{device_id}/update/rejected'获取物影子更新失败的信息;

接收控制数据

• 订阅主题'$baidu/iot/shadow/{device_id}/delta'获取控制端发来的控制指令，格式如下：

{
    "requestId":"1234",
    "desired":{
        "Brightness":10
    }
}

App端操作

App主动获取设备数据

• 发送请求到主题'$baidu/iot/shadow/{device_id}/get'，可以获取该设备在设备影子中的所有状态信息;格式如下：

{
    "requestId": "{requestId}"
}

• 订阅主题'$baidu/iot/shadow/{device_id}/get/accepted'获取物影子数据;格式如下：

{
    "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: 解析该字段，获取设备数据

App接收设备变更的数据

• 订阅"$baidu/iot/shadow/{device_id}/update/snapshot"主题，当设备状态变更时，可以实时接收到设备数据；数据格式如下：

{
    "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: 解析该字段，获取设备数据