Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden von Schatten in Geräten

In diesem Abschnitt wird die Gerätekommunikation mit Shadows mithilfe von MQTT Nachrichten beschrieben. Dies ist die bevorzugte Methode für Geräte zur Kommunikation mit dem AWS IoT Device Shadow-Dienst.

Shadow-Kommunikation emuliert ein request/response model using the publish/subscribe Kommunikationsmodell von. MQTT Jede Schattenaktion besteht aus einem Anforderungsthema, einem Thema für erfolgreiche Antworten (accepted) und einem Thema für Fehlerantworten (rejected).

Informationen dazu, ob Apps und Services feststellen können, ob ein Gerät verbunden ist, finden Sie unter Erkennen, dass ein Gerät verbunden ist.

Die Beispiele in diesem Abschnitt verwenden eine verkürzte Form des Themas, wobei sich der Begriff entweder auf einen benannten oder einen unbenannten Schatten beziehen ShadowTopicPrefix kann, wie in dieser Tabelle beschrieben.

Schatten können benannt oder unbenannt sein (klassisch). Die jeweils verwendeten Themen unterscheiden sich nur durch das Themenpräfix. In dieser Tabelle wird das Themenpräfix angezeigt, das von jedem Schattentyp verwendet wird.

Um ein vollständiges Thema zu erstellen, wählen Sie ShadowTopicPrefix als Schattentyp aus, auf den Sie verweisen möchten. Ersetzen Sie thingName und shadowName mit den entsprechenden Werten, wenn zutreffend. Fügen Sie anschließend den Themen-Stub an wie in der folgenden Tabelle dargestellt. Denken Sie daran, dass bei Themen zwischen Groß- und Kleinschreibung unterschieden wird.

Weitere Informationen zu den reservierten Themen für Schatten finden Sie unter Schatten-Themen.

Initialisierung des Geräts bei der ersten Verbindung zu AWS IoT

Nachdem sich ein Gerät bei registriert hat AWS IoT, sollte es diese MQTT Nachrichten für die Shadows abonnieren, die es unterstützt.

Nach dem Abonnieren der Nachrichten in der obigen Tabelle für jeden Schatten sollte das Gerät testen, ob die Schatten, die es unterstützt, bereits erstellt wurden, indem es ein /get-Thema in jedem Schatten veröffentlicht. Wenn eine /get/accepted-Nachricht empfangen wird, enthält der Nachrichtentext das Schattendokument, mit dem das Gerät seinen Status initialisieren kann. Wenn eine /get/rejected-Nachricht empfangen wird, sollte der Schatten erstellt werden, indem eine /update-Nachricht mit dem aktuellen Gerätestatus veröffentlicht wird.

Nehmen wir zum Beispiel an, Sie haben ein Objekt My_IoT_Thing, das keine klassischen oder benannten Schatten hat. Wenn Sie jetzt eine /get-Anfrage zum reservierten Thema $aws/things/My_IoT_Thing/shadow/get veröffentlichen, erhält das $aws/things/My_IoT_Thing/shadow/get/rejected Thema einen Fehler, da das Objekt keine Schatten hat. Um diesen Fehler zu beheben, veröffentlichen Sie zunächst eine /update-Nachricht, indem Sie das $aws/things/My_IoT_Thing/shadow/update Thema mit dem aktuellen Gerätestatus verwenden, z. B. die folgende Payload.

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

Für das Objekt wird jetzt ein klassischer Schatten erstellt, und die Nachricht wird auf dem $aws/things/My_IoT_Thing/shadow/update/accepted-Thema veröffentlicht. Wenn Sie zu dem Thema $aws/things/My_IoT_Thing/shadow/get veröffentlichen, wird eine Antwort auf das $aws/things/My_IoT_Thing/shadow/get/accepted-Thema mit dem Gerätestatus zurückgegeben.

Bei benannten Schatten müssen Sie zuerst den benannten Schatten erstellen oder ein Update mit dem Schatten-Namen veröffentlichen, bevor Sie die GET-Anfrage verwenden können. Um beispielsweise einen benannten Schatten namedShadow1 zu erstellen, müssen Sie zunächst die Informationen zum Gerätestatus für das Thema veröffentlichen$aws/things/My_IoT_Thing/shadow/name/namedShadow1/update. Um die Statusinformationen abzurufen, verwenden Sie die /get-Anfrage für den benannten Schatten, $aws/things/My_IoT_Thing/shadow/name/namedShadow1/get.

Nachrichten werden verarbeitet, während das Gerät angeschlossen ist AWS IoT

Solange ein Gerät verbunden ist AWS IoT, kann es /update/delta-Meldungen empfangen und sollte den Gerätestatus an die Änderungen in seinem Schatten anpassen, indem es:

Solange ein Gerät angeschlossen ist, sollte es diese Meldungen veröffentlichen, wenn angezeigt.

Nachrichten werden verarbeitet, wenn das Gerät wieder eine Verbindung herstellt mit AWS IoT

Wenn ein Gerät mit einem oder mehreren Schatten eine Verbindung herstellt AWS IoT, sollte es seinen Status mit dem aller Schatten synchronisieren, die es unterstützt, und zwar wie folgt: