在设备中使用影子

本部分介绍了设备使用 MQTT 消息与影子进行通信，这是设备与 AWS IoT Device Shadow 服务进行通信的首选方法。

影子通信使用 MQTT 的发布/订阅通信模型以模拟请求/响应模型。每个影子操作包含请求主题、成功的响应主题 (accepted) 和错误响应主题 (rejected)。

如果您希望应用程序和服务能够确定是否连接了设备，请参阅检测是否连接了设备。

本部分中的示例使用主题的缩写形式，其中 ShadowTopicPrefix 可以表示命名或未命名的影子，如该表中所述。

影子可以是命名或未命名（经典）的。每个影子使用的主题仅在主题前缀上有所不同。下表显示每种影子类型使用的主题前缀。

要创建完整的主题，请为要表示的影子类型选择 ShadowTopicPrefix，将 thingName 和 shadowName（如果适用）替换为相应的值，然后在其后面附加主题存根，如下表中所示。请记住，主题区分大小写。

有关影子的保留主题的更多信息，请参阅 影子主题。

首次连接到 AWS IoT 时初始化设备

在 AWS IoT 中注册设备后，它应该为支持的影子订阅这些 MQTT 消息。

在为每个影子订阅上表中的消息后，设备应进行测试，以确定是否已将 /get 主题发布到它支持的每个影子以创建这些影子。如果收到 /get/accepted 消息，则消息正文包含影子文档，设备可以使用该文档初始化其状态。如果收到 /get/rejected 消息，应发布具有当前设备状态的 /update 消息以创建影子。

例如，假设您有事物 My_IoT_Thing，但其没有任何经典或命名影子。如果现在发布关于预留主题 $aws/things/My_IoT_Thing/shadow/get 的 /get 请求，其会在 $aws/things/My_IoT_Thing/shadow/get/rejected 主题返回一条错误，因为该事物没有任何影子。要想解决此错误，请先使用含当前设备状态（例如以下有效负载）的 $aws/things/My_IoT_Thing/shadow/update 主题发布一条 /update 消息。

{
	"state": {
		"reported": {
			"welcome": "aws-iot",
			"color": "yellow"
		}
	}
}

现在为该事物创建了经典影子，消息将发布到 $aws/things/My_IoT_Thing/shadow/update/accepted 主题。如果发布到 $aws/things/My_IoT_Thing/shadow/get 主题，其会将含设备状态的响应返回到 $aws/things/My_IoT_Thing/shadow/get/accepted 主题。

对于命名影子，必须先创建命名影子或发布含影子名称的更新，才能使用 get 请求。例如，要创建命名影子 namedShadow1，首先将设备状态信息发布到 $aws/things/My_IoT_Thing/shadow/name/namedShadow1/update 主题。若要检索状态信息，请将 /get 请求用于命名影子 $aws/things/My_IoT_Thing/shadow/name/namedShadow1/get。

在设备连接到 AWS IoT 后处理消息

在设备连接到 AWS IoT 后，它可以接收 /update/delta 消息，并且应按以下方式将设备状态与其影子更改保持匹配：

在连接设备后，它应在出现指示时发布这些消息。

在设备重新连接到 AWS IoT 时处理消息

在具有一个或多个影子的设备连接到 AWS IoT 时，它应按以下方式将其状态与它支持的所有影子的状态进行同步：