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à.

Implementare l' AWS.DiscoverDevices operazione

Device Discovery allinea l'elenco dei dispositivi fisici di proprietà dell'utente finale con le rappresentazioni digitali di tali dispositivi degli utenti finali gestite in Managed Integrations for. AWS IoT Device Management Viene eseguito da un AWS cliente su dispositivi di proprietà dell'utente finale. Per OAuth 2.0, ciò si verifica dopo il completamento del collegamento dell'account. Per l'autorizzazione generale, ciò può verificarsi dopo la creazione dell'associazione dell'account.

Il rilevamento dei dispositivi è un processo asincrono in cui Managed Integrations for AWS IoT Device Management richiama un connettore per avviare la richiesta di rilevamento del dispositivo. Un connettore C2C restituisce un elenco di dispositivi degli utenti finali rilevati in modo asincrono con un identificatore di riferimento (denominato) generato da Managed Integrations for. deviceDiscoveryId AWS IoT Device Management

Flusso di lavoro di AWS.DiscoverDevices

Il diagramma seguente illustra il flusso di lavoro di individuazione dei dispositivi tra l'utente finale e Managed Integrations per: AWS IoT Device Management

Fasi del flusso di lavoro

Requisiti del connettore C2C per Device Discovery

L'elenco seguente descrive i requisiti del connettore C2C per facilitare la corretta individuazione del dispositivo:

Processo di individuazione dei dispositivi

Fase 1: Le integrazioni gestite attivano l'individuazione dei dispositivi

Invia una richiesta POST a DiscoverDevices con uno dei seguenti payload JSON, a seconda del tipo di autorizzazione:

Richiesta OAuth 2.0:

/DiscoverDevices
{
   "header": {
        "auth": {                 
            "token": "ashriu32yr97feqy7afsaf",  
            "type": "OAuth2.0"
        }
   },
   "payload": {
        "operationName": "AWS.DiscoverDevices",
        "operationVersion": "1.0",
        "connectorId": "Your-Connector-Id",
        "deviceDiscoveryId": "12345678",
        "connectorDeviceIdList": []
   }
}

Richiesta di autorizzazione generale:

/DiscoverDevices
{
   "header": {
        "auth": {
            "secretsManager": {
                "arn": "string",
                "versionId": "string"
            },
            "type": "GeneralAuthorization"
        }
   },
   "payload": {
        "operationName": "AWS.DiscoverDevices",
        "operationVersion": "1.0",
        "connectorId": "Your-Connector-Id",
        "deviceDiscoveryId": "12345678",
        "connectorDeviceIdList": []
   }
}

Richiesta di autorizzazione generale:

/DiscoverDevices
{
   "header": {
        "auth": {
            "secretsManager": {
                "arn": "string",
                "versionId": "string"
            },
            "type": "GeneralAuthorization"
        }
   },
   "payload": {
        "operationName": "AWS.DiscoverDevices",
        "operationVersion": "1.0",
        "connectorId": "Your-Connector-Id",
        "deviceDiscoveryId": "12345678",
        "connectorDeviceIdList": []
   }
}

Fase 2: Connector conferma la scoperta

Il connettore invia una conferma con la seguente risposta JSON:

{
     "header": {
          "responseCode":200
     },
     "payload": {
          "responseMessage": "Discovering devices for discovery-job-id '12345678' with connector-id `Your-Connector-Id`"
     }
}

Fase 3: Il connettore invia un evento di rilevamento del dispositivo

Invia una richiesta POST a /connector-event/{your_connector_id} con il seguente payload JSON:

AWS API - /SendConnectorEvent
URI – POST /connector-event/{your_connector_id}
{
   "UserId": "6109342",
   "Operation": "DEVICE_DISCOVERY",
   "OperationVersion": "1.0",
   "StatusCode": 200,
   "DeviceDiscoveryId": "12345678",
   "ConnectorId": "Your_connector_Id",
   "Message": "Device discovery for discovery-job-id '12345678' successful",
   "Devices": [
        {
            "ConnectorDeviceId": "Your_Device_Id_1",
            "ConnectorDeviceName": "Your-Device-Name",
            "CapabilityReport": {
 	      		"nodeId":"1",
 			"version":"1.0.0",
  			"endpoints":[{
 				"id":"1",
 				"deviceTypes":["Camera"],
 				"clusters":[{
 					"id":"0x0006",
 					"revision":1,
 					"attributes":[{
 						"id":"0x0000",
 					}],
 					"commands":["0x00","0x01"],
 					"events":["0x00"]
 				}]
 			}]
 		}
        }
    ]
}

Inserisci marca e modello per i dispositivi rilevati

Il connettore C2C può facoltativamente includere un DeviceMetadata oggetto per ogni dispositivo in DEVICE_DISCOVERY caso di segnalazione della marca e del modello del dispositivo. Questi valori vengono quindi restituiti nelle risposte e. ListDiscoveredDevicesListManagedThings

Includi un DeviceMetadata oggetto in ogni voce e mappa del dispositivo:

L'esempio seguente mostra una voce relativa al dispositivo con DeviceMetadata included:

{
    "ConnectorDeviceId": "Your_Device_Id_1",
    "ConnectorDeviceName": "Your-Device-Name",
    "CapabilityReport": { ... },
    "DeviceMetadata": {
        "Brand": "ExampleBrand",
        "Model": "ExampleModel-X1"
    }
}

Entrambi i tasti fanno distinzione tra maiuscole e minuscole. Se si ometteDeviceMetadata, si omette una singola chiave o si fornisce un valore non di stringa, il campo corrispondente non è disponibile quando il dispositivo viene recuperato.

Costruisci un per l'evento DISCOVER_DEVICES CapabilityReport

Come illustrato nella struttura degli eventi sopra definita, ogni dispositivo segnalato in un evento DISCOVER_DEVICES, che funge da risposta a un'AWS.DiscoverDevicesoperazione, richiederà una CapbilityReport descrizione delle funzionalità del dispositivo corrispondente. Un `CapabilityReport` indica le integrazioni gestite per le funzionalità dei dispositivi AWS IoT Device Management in un formato conforme a Matter.

Campi obbligatori in CapabilityReport

Per l'elenco corrente delle funzionalità supportate e le relative AWS implementazioni del Matter Data Model, fate riferimento all'ultima versione della documentazione del modello di dati.