设备影子

什么是设备影子

设备影子是一个JSON文档，用于存储设备上报状态数据和应用程序期望状态信息。
每个设备有且只有一个设备影子，设备可以通过MQTT获取和设置设备影子来同步状态，该同步可以是影子同步给设备，也可以是设备同步给影子。

设备影子应用场景

1. 网络不稳定，设备频繁上下线，应用程序通过MQTT协议无法正常获取状态。

由于网络不稳定，设备频繁上下线。应用程序发出需要获取当前的设备状态请求时，设备掉线，无法获取设备状态，但下一秒设备又连接成功，应用程序无法正确发起请求。使用设备影子机制存储设备最新状态，一旦设备状态产生变化，设备会将状态同步到设备影子。应用程序在请求设备当前状态时，只需要获取影子中的状态即可，不需要关心设备是否在线。

2. 网络稳定，但应用程序MQTT请求太多，超过了设备可以处理的请求次数。

如果设备网络稳定，很多应用程序请求获取设备状态，设备需要根据请求响应多次，即使响应的结果是一样的，设备本身处理能力有限，无法负载被请求多次的情况。使用设备影子机制，设备只需要主动同步状态给设备影子一次，多个应用程序请求设备影子获取设备状态，即可获取设备最新状态，做到应用程序和设备的解耦。

3. 网络不稳定，应用程序的控制命令无法下达到设备。

应用程序发送控制指令给设备时设备网络不稳定，导致设备频繁上下线，应用程序发送控制指令给设备时设备掉线，指令无法下达到设备。设备再上线时，设备影子功能通过期望值和时间戳的模式，保证设备能够收到应用程序的控制命令，并自行判断是否执行过期指令。

操作步骤

1 - 前置条件

• 已注册并登录云鲸AIoT开发者平台账号，并具备功能菜单的权限。
• 您至少拥有一个产品的授权。
• 设备/设备的服务已接入设备影子。

2 - 进入设备详情页面

1. 登录 云鲸AIoT开发者平台，点击 设备运营 > 设备列表。

2. 在搜索框内 选择产品 或 DeviceId 或 设备SN 或 在线状态，点击 查询 按钮。

3. 点击 查看详情，进入 设备详情页。
   

3 - 查询设备影子文档

1. 点击 设备影子文档，即可查看该设备/设备服务上报的设备影子文档。

2. 点击 刷新影子，可重新刷新影子文档页面。