Envoyer des événements liés à un appareil avec l' SendConnectorEventAPI

Vue d'ensemble des événements déclenchés par un

Bien que l'SendConnectorEventAPI soit utilisée pour répondre AWS.SendCommand et effectuer des AWS.DiscoverDevices opérations de manière asynchrone, elle est également utilisée pour informer les intégrations gérées de tout événement initié par l'appareil. Les événements initiés par un appareil peuvent être définis comme tout événement généré par un appareil sans commande initiée par l'utilisateur. Ces événements peuvent inclure, sans toutefois s'y limiter, les changements d'état de l'appareil, la détection de mouvements, le niveau de charge de la batterie, etc. Vous pouvez renvoyer ces événements aux intégrations gérées à l'aide de l'SendConnectorEventAPI avec l'opération DEVICE_EVENT.

La section suivante utilise une caméra intelligente installée dans une maison comme exemple pour expliquer plus en détail le déroulement de ces événements :

Flux de travail lié aux événements liés

1. Votre caméra détecte un mouvement pour lequel elle génère un événement qui est envoyé à votre serveur de ressources.

2. Votre serveur de ressources traite l'événement et l'envoie à votre connecteur C2C.

3. Votre connecteur traduit cet événement en intégrations gérées pour l'DEVICE_EVENTinterface AWS IoT Device Management.

4. Votre connecteur C2C envoie cet événement d'appareil aux intégrations gérées à l'aide de l'SendConnectorEventAPI avec l'opération définie sur « DEVICE_EVENT ».

5. Les intégrations gérées identifient le client concerné et lui transmettent cet événement.

6. Le client reçoit cet événement et l'affiche à l'utilisateur via un identifiant utilisateur.

Pour plus d'informations sur le fonctionnement de l'SendConnectorEventAPI, consultez SendConnectorEvent le guide de référence de l'API sur les intégrations gérées pour AWS IoT Device Management.

Exigences relatives aux événements déclenchés par l'appareil

Voici quelques exigences relatives aux événements déclenchés par l'appareil.

• Votre ressource de connecteur C2C doit être en mesure de recevoir des événements de périphérique asynchrones depuis votre serveur de ressources

• Votre ressource de connecteur C2C doit être en mesure d'appeler des intégrations gérées pour les API du service AWS IoT Device Management via SigV4 en utilisant les AWS informations d'identification Compte AWS utilisées pour enregistrer le connecteur C2C.

L'exemple suivant illustre un connecteur qui envoie un événement provenant d'un appareil via l' SendConnectorEvent API :

AWS-API: /SendConnectorEvent
URI: POST /connector-event/{Your-Connector-Id}

{
   "UserId": "Your-End-User-ID",
   "Operation": "DEVICE_EVENT",
   "OperationVersion": "1.0",
   "StatusCode": 200,
   "Message": None,
   "ConnectorDeviceId": "Your_Device_Id",
   "MatterEndpoint": {
        "id": "1",    
        "clusters": [{
            "id": "0x0202",
            "attributes": [
                {
                    "0x0000": "3"
                }
            ]
        }]
    }]
}

Dans l'exemple suivant, nous voyons ce qui suit :

• Cela provient du point de terminaison de l'appareil dont l'ID est égal à 1.

• La capacité du périphérique à laquelle cet événement se rapporte possède un ID de cluster 0x0202, appartenant au cluster de sujets Fan Control.

• L'attribut qui a changé a l'ID 0x000, correspondant à l'énumération du mode ventilateur au sein du cluster. Il a été mis à jour à la valeur 3, correspondant à la valeur de High.

• Comme connectorId il s'agit d'un paramètre renvoyé par le service cloud lors de sa création, les connecteurs doivent effectuer des requêtes à l'aide GetCloudConnector et filtrer parlambdaARN. Le propre lambda ARN est interrogé à l'aide de l'API. Lambda.get_function_url_config Cela permet d'CloudConnectorIdy accéder dynamiquement dans le lambda, et non de le configurer statiquement comme précédemment.