Gérez les commandes et les événements des appareils IoT

Les commandes de l'appareil permettent de gérer à distance un appareil physique en garantissant un contrôle total sur celui-ci, en plus d'effectuer des mises à jour critiques de sécurité, logicielles et matérielles. Avec un vaste parc d'appareils, le fait de savoir quand un appareil exécute une commande permet de superviser l'ensemble de la mise en œuvre de votre appareil. Une commande de l'appareil ou une mise à jour automatique déclenchera un changement d'état de l'appareil, qui à son tour créera un nouvel événement sur l'appareil. Cet événement lié à l'appareil déclenchera l'envoi automatique d'une notification à une destination gérée par le client.

Commandes de l'appareil

Une demande de commande est la commande envoyée à l'appareil. Une demande de commande inclut une charge utile qui spécifie l'action à effectuer, telle que l'allumage de l'ampoule. Pour envoyer une commande d'appareil, l'SendManagedThingCommandAPI est appelée au nom de l'utilisateur final par des intégrations gérées et la demande de commande est envoyée à l'appareil.

La réponse à a SendManagedThingCommand est un traceId et vous pouvez l'utiliser traceId pour suivre la livraison des commandes et tous les flux de travail de réponse aux commandes associés dans la mesure du possible.

Pour plus d'informations sur le fonctionnement de l'SendManagedThingCommandAPI, consultez SendManagedThingCommand.

Action UpdateState

Pour mettre à jour l'état d'un appareil, par exemple l'heure à laquelle une lumière s'allume, utilisez l'UpdateStateaction lorsque vous appelez l'SendManagedThingCommandAPI. Indiquez la propriété du modèle de données et la nouvelle valeur dans laquelle vous effectuez la mise à jourparameters. L'exemple ci-dessous illustre une demande d'SendManagedThingCommandAPI mettant à jour le nom OnTime d'une ampoule en5.

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

Action ReadState

Pour obtenir l'état le plus récent d'un appareil, y compris les valeurs actuelles de toutes les propriétés du modèle de données, utilisez l'ReadStateaction lorsque vous appelez l'SendManagedThingCommandAPI. DanspropertiesToRead, vous pouvez utiliser les options suivantes :

• Fournissez une propriété de modèle de données spécifique pour obtenir la dernière valeur, par exemple OnOff pour déterminer si un voyant est allumé ou éteint.

• Utilisez l'opérateur générique (*) pour lire toutes les propriétés d'état du périphérique associées à une fonctionnalité.

Les exemples ci-dessous illustrent les deux scénarios d'une demande d'SendManagedThingCommandAPI utilisant l'ReadStateaction :

{
  "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": [ "*" ]
              }
            }
          ]
        }
      ]
    }
  ]}

Événements liés à l'appareil

Un événement de dispositif inclut l'état actuel de l'appareil. Cela peut signifier que l'appareil a changé d'état ou qu'il signale son état même s'il n'a pas changé. Il inclut les rapports de propriétés et les événements définis dans le modèle de données. Un événement peut être dû au fait que le cycle du lave-linge est terminé ou que le thermostat a atteint la température cible définie par l'utilisateur final.

Notifications d'événements liés à

Un utilisateur final peut s'abonner à des destinations spécifiques gérées par le client qu'il crée pour recevoir des mises à jour sur des événements spécifiques liés à un appareil. Pour créer une destination gérée par le client, appelez l'CreateDestinationAPI. Lorsqu'un événement lié à un appareil est signalé aux intégrations gérées par l'appareil, la destination gérée par le client est avertie s'il en existe une.