Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Invia eventi del dispositivo con l' SendConnectorEvent API
## Panoramica degli eventi avviati dal dispositivo
Sebbene l'`SendConnectorEvent`API 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'`SendConnectorEvent`API 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.
1. Il server di risorse elabora l'evento e lo invia al connettore C2C.
1. Il connettore traduce questo evento nelle integrazioni gestite per l'interfaccia AWS IoT Device Management`DEVICE_EVENT`.
1. Il connettore C2C invia questo evento del dispositivo a Managed Integrations utilizzando l'`SendConnectorEvent`API con Operation impostata su «DEVICE\_EVENT».
1. Managed Integrations identifica il cliente pertinente e trasmette questo evento al cliente.
1. 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 per`lambdaARN`. Il file di lambda `ARN` viene interrogato tramite l'API. `Lambda.get_function_url_config` Ciò consente l'`CloudConnectorId`accesso dinamico in lambda e non la configurazione statica come in precedenza.