在应用程序和服务中使用影子 - AWS IoT Core
在连接到时初始化应用程序或服务 AWS IoT当应用程序或服务连接到时，处理状态会发生变化 AWS IoT检测是否连接了设备

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在应用程序和服务中使用影子

本节介绍应用程序或服务如何与 Dev AWS IoT ice Shadow 服务进行交互。该示例假定应用程序或服务仅与影子进行交互，并通过影子与设备进行交互。该示例不包括任何管理操作，例如创建或删除影子。

此示例使用 Dev AWS IoT ice Shado REST API w 服务与阴影进行交互。与中使用的示例不同在设备中使用影子，后者使用的是的publish/subscribe communications model, this example uses the request/response通信模型RESTAPI。这意味着应用程序或服务必须先发出请求，然后才能收到来自的响应 AWS IoT。但该模型的一个缺点是，它不支持通知。如果您的应用程序或服务需要及时通知设备状态变化，请考虑使用支持发布/订阅通信模式的MQTT或MQTT通过WSS协议，如中所述。在设备中使用影子

重要

确保应用程序或服务使用的影子与设备中的相应实施保持一致，并且该实施支持使用这些影子。例如，考虑如何创建、更新和删除影子，以及如何在设备以及访问影子的应用程序或服务中处理更新。您的设计应明确指定如何更新和报告设备的状态，以及应用程序和服务如何与设备及其影子进行交互。

命名阴影URL的 REST API 's是：

https://endpoint/things/thingName/shadow?name=shadowName

未命名的影子的 REST API URL 为：

https://endpoint/things/thingName/shadow

其中：

端点

CLI命令返回的端点：

aws iot describe-endpoint --endpoint-type IOT:Data-ATS
thingName

影子所属的事物对象的名称

shadowName

命名的影子的名称。该参数不用于未命名的影子。

在连接到时初始化应用程序或服务 AWS IoT

当应用程序首次连接到时 AWS IoT，它应该向其使用的阴影发送HTTPGET请求，以获取其正在使用的阴影的当前状态。URLs这样，它就可以将应用程序或服务同步到影子。

当应用程序或服务连接到时，处理状态会发生变化 AWS IoT

当应用程序或服务连接到时 AWS IoT，它可以通过在其使用的阴影上发送HTTPGET请求来定期查询当前状态。URLs

当最终用户与应用程序或服务交互以更改设备的状态时，该应用程序或服务可以向其用来更新影子desired状态的影子发送HTTPPOST请求。URLs此请求会返回已接受的更改，但您可能需要通过发出HTTPGET请求来轮询影子，直到设备将影子更新为新状态。

检测是否连接了设备

要确定设备当前是否已连接，请在影子文档中包含一个connected属性，然后使用 L MQTT ast Will and Testament (LWT) 消息将该connected属性设置为false如果设备因错误而断开连接。

注意

MQTTLWTDev AWS IoT ice Shadow 服务会忽略发送到 AWS IoT 保留主题（以 $ 开头的主题）的消息。但是，它们由订阅的客户端和 AWS IoT 规则引擎处理，因此您需要创建一条发送到非保留主题的LWT消息，以及一条规则，将该MQTTLWT消息作为影子更新消息重新发布到影子的保留更新主题。ShadowTopicPrefix/update

向 Device Shadow 服务发送LWT消息

  1. 创建一条规则，重新发布有关保留主题的MQTTLWT消息。以下示例规则会侦听关于 my/things/myLightBulb/update 主题的消息并其重新发布到 $aws/things/myLightBulb/shadow/update。

    {
    "rule": {
    "ruleDisabled": false,
    "sql": "SELECT * FROM 'my/things/myLightBulb/update'",
    "description": "Turn my/things/ into $aws/things/",
    "actions": [
        {
        "republish": {
            "topic": "$$aws/things/myLightBulb/shadow/update",
            "roleArn": "arn:aws:iam:123456789012:role/aws_iot_republish"
            }
        }
     ]
   }
}

  2. 当设备连接到时 AWS IoT，它会向非保留主题注册一条LWT消息，以供重新发布规则识别。在此示例中，该主题为 my/things/myLightBulb/update，它将 connected 属性设置为 false。

    {
    "state": {        
        "reported": {
            "connected":"false"
        }
    }
}

  3. 在连接后，设备在其影子更新主题 $aws/things/myLightBulb/shadow/update 上发布消息以报告其当前状态，这包括将其 connected 属性设置为 true。

    {
     "state": {        
        "reported": {
            "connected":"true"
        }
    }
}

  4. 在设备正常断开连接之前，它在其影子更新主题 $aws/things/myLightBulb/shadow/update 上发布消息以报告其最新状态，这包括将其 connected 属性设置为 false。

    {
    "state": {        
        "reported": {
            "connected":"false"
        }
    }
}

  5. 如果设备因错误而断开连接，则 AWS IoT 消息代理将代表设备发布该设备的LWT消息。重新发布规则检测该消息，并发布影子更新消息以更新设备影子的 connected 属性。