如果当前产品不具备物模型的能力,可以通过设备影子将当前设备的最新状态缓存到云端。云端缓存的是一个最新的 JSON 格式数据,需要用户自己根据实际情况做解析。物模型具备更高级的设备影子能力,能根据各个属性、事件、服务做独立展示,并具有所有操作的历史记录。

说明 设备影子相关接口参见设备 IDeviceShadow

数据上行

  • 获取云端设备影子

  • 更新云端设备影子

  • 删除云端设备影子

// 获取设备影子 具体业务可参考 Demo
String data = "{" + "\"method\": \"get\"" + "}";
// 更新设备影子 需要根据获得到的设备影子读取返回的 version值,在更新的时候 {ver} 替换为version+1
// String data = "{" + "\"method\": \"update\"," + "\"state\": {" + "\"reported\": {" +
//            "\"color\": \"red\"" + "}" + "}," + "\"version\": {ver}" + "}";
//删除设备影子 color 属性  {ver}需要替换
// String data = "{" + "\"method\": \"delete\"," + "\"state\": {" + "\"reported\": {" +
//            "\"color\": \"null\"" + "}" + "}," + "\"version\": {ver}" + "}";
LinkKit.getInstance().getDeviceShadow().shadowUpload(data, new IConnectSendListener() {
    @Override
    public void onResponse(ARequest aRequest, AResponse aResponse) {
        // 设备影子更新成功
        // 数据解析参考数据下行或 Demo
    }

    @Override
    public void onFailure(ARequest aRequest, AError aError) {
        // 设备影子更新失败
    }
});
			

数据下行

监听云端设备影子数据更新,一般使用在 APP 去控制设备的时候。APP控制设备的时候,通过云端下发设备影子更新到设备端,设备端拿到云端下行的设备影子之后,根据 desired 的值去执行设备更新。

// 监听云端设备影子更新
LinkKit.getInstance().getDeviceShadow().setShadowChangeListener(new IShadowRRPC() {
    @Override
    public void onSubscribeSuccess(ARequest aRequest) {
        // 订阅设备影子下行数据成功
    }

    @Override
    public void onSubscribeFailed(ARequest aRequest, AError aError) {
        // 订阅设备影子下行数据失败
    }

    @Override
    public void onReceived(ARequest aRequest, AResponse aResponse, IConnectRrpcHandle iConnectRrpcHandle) {
        // 接收到云端数据下行,下行数据在 aResponse 想里面
        try {
            if (aRequest != null) {
                String dataStr = null;
                if (aResponse.data instanceof byte[]) {
                    dataStr = new String((byte[]) aResponse.data, "UTF-8");
                } else if (aResponse.data instanceof String) {
                    dataStr = (String) aResponse.data;
                } else {
                    dataStr = String.valueOf(aResponse.data);
                }
                // Log.d(TAG, "dataStr = " + dataStr);
                // 返回数据示例
                //{"method":"control","payload":{"state":{"desired":{"mode":2,"color":"white"},"reported":{"mode":"1","color":"red"}},"metadata":{"desired":{"mode":{"timestamp":1547642408},"color":{"timestamp":1547642408}},"reported":{"mode":{"timestamp":1547642408},"color":{"timestamp":1547642408}}}},"timestamp":1547642408,"version":12}
                // 仅供参考
                ShadowResponse<String> shadowResponse = JSONObject.parseObject(dataStr, new TypeReference<ShadowResponse<String>>() {
                }.getType());
                if (shadowResponse != null && shadowResponse.version != null && TextUtils.isDigitsOnly(shadowResponse.version)) {
                    version = Long.valueOf(shadowResponse.version);
                }

                AResponse response = new AResponse();
                // TODO 用户实现控制设备
                // 用户控制设备之后 上报影子的值到云端
                // 上报设置之后的值到云端
                // 根据当前实际值上报
                response.data = shadowUpdate.replace("{ver}", String.valueOf(version + 1));
                // 第一个值 replyTopic 有默认值 用户不需要设置
                iConnectRrpcHandle.onRrpcResponse(null, response);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    @Override
    public void onResponseSuccess(ARequest aRequest) {
        // 下行处理之后上报成功
    }

    @Override
    public void onResponseFailed(ARequest aRequest, AError aError) {
        // 下行处理之后上报失败
    }
});