Invia gli eventi del dispositivo con l'API SendConnectorEvent

Panoramica degli eventi avviati dal dispositivo

Sebbene l'SendConnectorEventAPI venga utilizzata per rispondere in modo asincrono alle AWS.DiscoverDevices operazioni AWS.SendCommand e alle operazioni, viene anche utilizzata per notificare alle integrazioni gestite eventuali eventi avviati dal dispositivo. Gli eventi avviati dal dispositivo possono essere definiti come qualsiasi evento generato da un dispositivo senza un comando avviato dall'utente. Questi eventi del dispositivo possono includere, a titolo esemplificativo, modifiche dello stato del dispositivo, rilevamento del movimento, livelli della batteria e altro ancora. Puoi inviare questi eventi alle integrazioni gestite utilizzando l'SendConnectorEventAPI con l'operazione DEVICE_EVENT.

La sezione seguente utilizza una telecamera intelligente installata in una casa come esempio per spiegare ulteriormente il flusso di lavoro di questi eventi:

Workflow degli eventi del dispositivo

1. La videocamera rileva un movimento per il quale genera un evento che viene inviato al server di risorse.

2. Il server di risorse elabora l'evento e lo invia al connettore C2C.

3. Il connettore traduce questo evento nelle integrazioni gestite per l'interfaccia AWS IoT Device ManagementDEVICE_EVENT.

4. Il connettore C2C invia questo evento del dispositivo alle integrazioni gestite utilizzando l'SendConnectorEventAPI con Operation impostata su «DEVICE_EVENT».

5. Le integrazioni gestite identificano il cliente interessato e trasmettono questo evento al cliente.

6. Il cliente riceve questo evento e lo visualizza all'utente tramite un identificatore utente.

Per ulteriori informazioni sul funzionamento delle SendConnectorEvent API, consulta SendConnectorEvent la Guida di riferimento alle integrazioni gestite per l'API AWS IoT Device Management.

Requisiti per gli eventi avviati dal dispositivo

Di seguito sono riportati alcuni requisiti per gli eventi avviati dal dispositivo.

• La risorsa del connettore C2C dovrebbe essere in grado di ricevere eventi asincroni del dispositivo dal server di risorse

• La risorsa del connettore C2C dovrebbe essere in grado di richiamare integrazioni gestite per le API del servizio AWS IoT Device Management tramite SigV4 utilizzando AWS le credenziali Account AWS utilizzate per la registrazione del connettore C2C.

L'esempio seguente mostra un connettore che invia un evento originato dal dispositivo tramite l'API: SendConnectorEvent

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"
                }
            ]
        }]
    }]
}

Dall'esempio seguente, vediamo quanto segue:

• Proviene dall'endpoint del dispositivo con ID uguale a 1.

• La funzionalità del dispositivo a cui si riferisce questo evento ha un ID cluster di 0x0202, relativo al cluster Fan Control matter.

• L'attributo che è stato modificato ha l'ID 0x000, relativo al Fan Mode Enum all'interno del cluster. È stato aggiornato al valore 3, relativo al valore High.

• Poiché connectorId è un parametro restituito dal servizio cloud al momento della creazione, i connettori devono eseguire query utilizzando GetCloudConnector e filtrare perlambdaARN. Il file di lambda ARN viene interrogato tramite l'API. Lambda.get_function_url_config Ciò consente l'CloudConnectorIdaccesso dinamico in lambda e non la configurazione statica come in precedenza.