设备影子

SDK提供的设备影子主要保存接入设备的在线状态与配置信息，配置信息包括云端的期望配置与接入设备的实际配置。

接入设备认证

边缘节点上线时会通过代理应用获取H3C物联网平台添加的接入设备信息，之后不管节点在线还是离线，都能与SDK应用进行交互，处理SDK应用发送的接入设备上下线请求。

接入设备上线

接入设备上线，需要通过SDK应用向边缘节点的代理应用发送topic请求消息，代理应用接收到请求消息后，会响应topic消息以告知SDK应用接入设备的上线请求结果。

接入设备上线请求

主题：{srcApp}/request/oasis/online
消息：

{
    "deviceInfo":[
        {
            "productKey":"xxxxxxxxxx",
            "deviceID":"xxxxxxxxxx"
        }
    ],
    "token":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "timestamp":"2020-01-01T00:00:00Z"
}

接入设备上线响应

主题：oasis/response/{destApp}/online
消息：

{
    "deviceInfo":[
        {
            "productKey":"xxxxxxxxxx",
            "deviceID":"xxxxxxxxxx",
            "state":"online"
        }
    ],
    "token":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "timestamp":"2020-01-01T00:00:00Z"
}

接入设备下线

接入设备下线，需要通过SDK应用向边缘节点的代理应用发送topic请求消息，代理应用接收到请求消息后，会响应topic消息以告知SDK应用接入设备的下线请求结果。

接入设备下线请求

主题：{srcApp}/request/oasis/offline
消息：

{
    "deviceInfo":[
        {
            "productKey":"xxxxxxxxxx",
            "deviceID":"xxxxxxxxxx"
        }
    ],
    "token":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "timestamp":"2020-01-01T00:00:00Z"
}

接入设备下线响应

主题：oasis/response/{destApp}/offline
消息：

{
    "deviceInfo":[
        {
            "productKey":"xxxxxxxxxx",
            "deviceID":"xxxxxxxxxx",
            "state":"offline"
        }
    ],
    "token":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "timestamp":"2020-01-01T00:00:00Z"
}

接入设备在线保活

接入设备在线时，需要通过SDK应用向边缘节点的代理应用发送topic保活消息，代理应用接收到请求消息后，会响应topic消息以告知SDK应用接入设备的保活请求结果。

接入设备在线保活请求

主题：{srcApp}/request/oasis/keepalive
消息：

{
    "deviceInfo":[
        {
            "productKey":"xxxxxxxxxx",
            "deviceID":"xxxxxxxxxx"
        }
    ],
    "token":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "timestamp":"2020-01-01T00:00:00Z"
}

接入设备在线保活响应

主题：oasis/response/{destApp}/keepalive
消息：

{
    "deviceInfo":[
        {
            "productKey":"xxxxxxxxxx",
            "deviceID":"xxxxxxxxxx",
            "state":"online"
        }
    ],
    "token":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "timestamp":"2020-01-01T00:00:00Z"
}

参数说明

接入设备配置

更新接入设备的期望配置

接入设备上线成功后，边缘节点的代理应用会主动发送topic消息，将节点存储的云端期望配置及时更新到接入设备上。

更新接入设备的期望配置通知消息

主题：oasis/notify/{destApp}/updateShadow
消息：

{
    "productKey":"xxxxxxxxxx",
    "deviceID":"xxxxxxxxxx",
    "state":{
        "desired":{
            "attribute1":"xxxxxxxxxx"
        }
    },
    "metadata":{
        "desired":{
            "attribute1":{
                "timestamp":1579181557363
            }
        }
    },
    "token":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "timestamp":"2020-01-01T00:00:00Z"
}

当边缘节点上线时，代理应用会获取云端的接入设备期望配置信息并保存；当云端通过在线的边缘节点更新接入设备的配置信息时，代理应用也会更新存储的接入设备配置信息。当代理应用发现存储的在线接入设备的期望配置信息发生变化时，也会发送上述Topic消息，以更新接入设备的期望配置信息。

接入设备的实际配置上报请求

当SDK应用收到更新期望配置的通知消息或者接入设备的实际配置信息发生变化时，SDK应用需要发送topic消息告知代理应用更新接入设备的实际配置信息，代理应用接收到更新接入设备的实际配置消息后，会响应topic消息以告知SDK应用存储的设备影子更新结果。

主题：{srcApp}/request/oasis/updateShadow
消息：

{
    "productKey":"xxxxxxxxxx",
    "deviceID":"xxxxxxxxxx",
    "state":{
        "reported":{
            "attribute1":"xxxxxxxxxx"
        }
    },
    "metadata":{
        "reported":{
            "attribute1":{
                "timestamp":1579181557363
            }
        }
    },
    "token":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "timestamp":"2020-01-01T00:00:00Z"
}

接入设备的实际配置上报响应

当接入设备的实际配置信息发生变化时，SDK应用需要发送topic消息告知代理应用更新接入设备的实际配置信息，代理应用接收到更新接入设备的实际配置消息后，会响应topic消息以告知SDK应用存储的设备影子更新结果。

主题：oasis/response/{destApp}/updateShadow
消息：

{
    "productKey":"xxxxxxxxxx",
    "deviceID":"xxxxxxxxxx",
    "statusCode":200,
    "statusStr":"OK",
    "timestamp":"2020-01-01T00:00:00Z",
    "token":"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "version":1
}

参数说明

API接口