# 设备影子 JSON 格式解析

设备影子 JSON 格式示例:

{
    "state": {
        "desired": {
            "power": "ON", 
            "light": [
                "RED", 
                "50", 
                "0xfa349g"
            ]
        }, 
        "reported": {
            "power": "CLOSE"
        }
    }, 
    "metadata": {
        "desired": {
            "color": {
                "timestamp": 1629082191
            }, 
            "sequence": {
                "timestamp": 1629082191
            }
        }, 
        "reported": {
            "color": {
                "timestamp": 1629082191
            }
        }
    }, 
    "timestamp": 1629082191, 
    "version": 1
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
参数说明
desired设备的预期状态。
应用程序设置设备的 desired 状态,该状态将保存在设备影子中。
repoted设备最近一次上报的状态。
应用程序可以通过读取该参数值,获取设备的状态
metadata当应用程序更新 desired 或者设备上报状态后,设备影子服务会自动更新 metadata 的值。
设备状态的元数据的信息包含间每个状态的时间戳
timestamp设备影子的最新更新时间
version应用程序更新 desired 时,设备影子会检查请求中的 version 值是否大于当前版本号。
如果大于当前版本号,则更新设备影子,反之则会拒绝更新设备影子。
version参数为 int64 型。为防止参数溢出,您可以手动传入-1将版本号重置为0

注: 设备状态支持更新数组类型的值,但更新数组类型的值,必须全量更新,不能只更新其中一部分。设备影子对同一状态的更新策略为全量覆盖
例如:

  • 初始状态

{
"reported" : { "temps" : ["23.5", "24.1", "22.9" ] }
}
1
2
3
4
  • 更新

{
"reported" : { "temps" : ["24.2", "23.9" ] }
}
1
2
3
4
  • 最终状态

{
"reported" : { "temps" : ["24.2", "23.9" ] }
}
1
2
3
4