影子服务

5.1 背景

在影子服务投入使用前，用户进行一次设备查询的时候会发起1次透传查询。

进行一次设备控制的时候会发起1次透传查询和1次透传控制。

#5.2 影子服务

影子服务即缓存设备状态的服务，原理是将设备状态保存一份到云端，能够减少1次透传查询。

#5.3 影子服务中设备状态来源

设备进行状态上报后，通过物模型1.0中配置的事件对指令进行解析，

#5.4 设备等级

只有部分满足及时上报状态的设备才能接入影子服务，根据设备上报情况，对设备进行分级。

设备等级共分为五级，等级被评定为四级和五级的设备被认为存在云端的设备状态是可靠的，影子服务中会保存该设备的全部状态，即支持影子状态。

注意

设备等级为四级以下的设备上报状态是不可靠的，不能支持影子状态。

#5.5 半影子

设备等级评定为3级的设备，其部分属性能满足及时上报要求，这种情况称之为半影子。

可以在平台上配置半影子属性，配置完成后影子服务会保存这部分信息提供影子能力，这些属性当作影子状态用于业务场景。

如图：

#5.6 影子补偿

设备等级满足4级和5级的可以开启影子补偿，该功能主要解决当设备由于物理环境（网络等情况）不稳定的情况下，上报延迟导致影响影子状态同步不及时。避免用户操作过程中出现控端显示与设备状态不一致的情况。

原理：把操作返回的状态解析为输出属性后，更新到影子状态。

注意

设备等级只支持半影子的情况，影子补偿功能只会对部分属性进行处理，该部分属性指的是半影子属性和操作输出属性的交集。

配置方式可以参考：

#5.7 影子状态的准确性要求

如果影子等级不正确的情况下，使用物模型1.0进行操作时，但凡涉及设备状态的动作，都有概率出现影子状态与设备实际状态不一致的情况，准确要使用影子中的属性有4点要求 1、配置事件匹配消息类型为状态上报，且其解码中配置该属性的解码 2、设备上报的指令触发该事件 3、该指令能及时进行状态上报（及时即断线重连、断电重连、状态改变的5s内能上报） 4、设备/影子等级高于3级