Befehle und Ereignisse für IoT-Geräte verwalten

Gerätebefehle bieten die Möglichkeit, ein physisches Gerät aus der Ferne zu verwalten und so die vollständige Kontrolle über das Gerät zu gewährleisten. Außerdem können wichtige Sicherheits-, Software- und Hardwareupdates durchgeführt werden. Bei einer großen Geräteflotte erhalten Sie einen Überblick über Ihre gesamte Geräteimplementierung, wenn Sie wissen, wann ein Gerät einen Befehl ausführt. Ein Gerätebefehl oder ein automatisches Update löst eine Änderung des Gerätestatus aus, wodurch wiederum ein neues Geräteereignis ausgelöst wird. Dieses Geräteereignis löst eine Benachrichtigung aus, die automatisch an ein vom Kunden verwaltetes Ziel gesendet wird.

Gerätebefehle

Eine Befehlsanforderung ist der Befehl, der an das Gerät gesendet wird. Eine Befehlsanforderung enthält eine Nutzlast, die die auszuführende Aktion spezifiziert, z. B. das Einschalten der Glühbirne. Um einen Gerätebefehl zu senden, wird die SendManagedThingCommand API im Namen des Endbenutzers von verwalteten Integrationen aufgerufen und die Befehlsanforderung wird an das Gerät gesendet.

Die Antwort auf a SendManagedThingCommand ist ein, traceId und Sie können traceId damit die Befehlsübermittlung und alle damit verbundenen Befehlsantwort-Workflows verfolgen, wo immer dies möglich ist.

Weitere Informationen zum SendManagedThingCommand API-Vorgang finden Sie unter SendManagedThingCommand.

Aktion UpdateState

Um den Status eines Geräts zu aktualisieren, z. B. die Uhrzeit, zu der ein Licht aufleuchtet, verwenden Sie die UpdateState Aktion beim Aufrufen der SendManagedThingCommand API. Geben Sie die Datenmodelleigenschaft und den neuen Wert an, den Sie aktualisieren möchtenparameters. Das folgende Beispiel zeigt eine SendManagedThingCommand API-Anfrage, auf OnTime die eine Glühbirne aktualisiert wird5.

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "matter.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "UpdateState",
              "parameters": {
                "OnTime": 5
              }
            }
          ]
        }
      ]
    }
  ]
}

Aktion ReadState

Um den neuesten Status eines Geräts einschließlich der aktuellen Werte aller Datenmodelleigenschaften abzurufen, verwenden Sie die ReadState Aktion beim Aufrufen der SendManagedThingCommand API. propertiesToReadIn können Sie die folgenden Optionen verwenden:

• Geben Sie eine bestimmte Datenmodelleigenschaft an, um den aktuellen Wert abzurufen, z. B. um OnOff festzustellen, ob ein Licht an oder aus ist.

• Verwenden Sie den Platzhalteroperator (*), um alle Gerätestatuseigenschaften für eine Funktion zu lesen.

Die folgenden Beispiele veranschaulichen beide Szenarien für eine SendManagedThingCommand API-Anfrage, bei der die ReadState Aktion verwendet wird:

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "aws.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "ReadState",
              "parameters": {
                "propertiesToRead": [ "OnOff" ]
              }
            }
          ]
        }
      ]
    }
  ]
}

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "aws.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "ReadState",
              "parameters": {
                "propertiesToRead": [ "*" ]
              }
            }
          ]
        }
      ]
    }
  ]}

Geräteereignisse

Ein Geräteereignis beinhaltet den aktuellen Status des Geräts. Dies kann bedeuten, dass das Gerät seinen Status geändert hat oder seinen Status meldet, auch wenn sich der Status nicht geändert hat. Dazu gehören Eigenschaftsberichte und Ereignisse, die im Datenmodell definiert sind. Ein Ereignis könnte sein, dass ein Waschmaschinenzyklus abgeschlossen wurde oder der Thermostat die vom Endbenutzer eingestellte Zieltemperatur erreicht hat.

Benachrichtigungen über Geräteereignisse

Ein Endbenutzer kann bestimmte, vom Kunden verwaltete Ziele abonnieren, die er für Updates zu bestimmten Geräteereignissen erstellt. Rufen Sie die API auf, um ein vom Kunden verwaltetes Ziel zu erstellen. CreateDestination Wenn das Gerät ein Geräteereignis an verwaltete Integrationen meldet, wird das vom Kunden verwaltete Ziel benachrichtigt, falls eines existiert.