Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mettre en œuvre l' AWS.DiscoverDevices opération

La découverte des appareils aligne la liste des appareils physiques détenus par l'utilisateur final avec les représentations numériques de ces appareils gérés dans Managed Integrations for. AWS IoT Device Management Elle est exécutée par un AWS client sur des appareils appartenant à l'utilisateur final. Pour OAuth 2.0, cela se produit une fois la liaison des comptes terminée. Pour l'autorisation générale, cela peut se produire après la création de l'association de comptes.

La découverte d'appareils est un processus asynchrone dans le cadre duquel Managed Integrations for AWS IoT Device Management appelle un connecteur pour lancer la demande de découverte d'appareils. Un connecteur C2C renvoie une liste des appareils des utilisateurs finaux découverts de manière asynchrone avec un identifiant de référence (appelédeviceDiscoveryId) généré par Managed Integrations for. AWS IoT Device Management

Flux de travail AWS.DiscoverDevices

Le schéma suivant illustre le flux de travail de découverte des appareils entre l'utilisateur final et Managed Integrations pour AWS IoT Device Management :

Étapes du flux de travail

Exigences relatives au connecteur C2C pour Device Discovery

La liste suivante décrit les exigences relatives à votre connecteur C2C afin de faciliter la découverte réussie des appareils :

Processus de découverte des appareils

Étape 1 : Les intégrations gérées déclenchent la découverte des appareils

Envoyez une requête POST à DiscoverDevices avec l'une des charges utiles JSON suivantes, en fonction du type d'autorisation :

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

Demande d'autorisation générale :

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

Demande d'autorisation générale :

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

Étape 2 : Le connecteur confirme la découverte

Le connecteur envoie un accusé de réception avec la réponse JSON suivante :

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

Étape 3 : Le connecteur envoie un événement de découverte du périphérique

Envoyez une requête POST à /connector-event/{your_connector_id} avec la charge utile JSON suivante :

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

Renseignez la marque et le modèle des appareils découverts

Votre connecteur C2C peut éventuellement inclure un DeviceMetadata objet pour chaque appareil afin de DEVICE_DISCOVERY signaler la marque et le modèle de l'appareil. Ces valeurs sont ensuite renvoyées dans les ListManagedThingsréponses ListDiscoveredDeviceset.

Incluez un DeviceMetadata objet dans chaque entrée d'appareil et cartographiez :

L'exemple suivant montre une entrée d'appareil avec la mention « DeviceMetadata inclus » :

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

Les deux touches sont des chaînes distinguant majuscules et minuscules. Si vous omettezDeviceMetadata, omettez une clé individuelle ou fournissez une valeur autre qu'une chaîne, le champ correspondant n'est pas disponible lorsque le périphérique est récupéré.

Construit un CapabilityReport pour l'événement DISCOVER_DEVICES

Comme le montre la structure d'événements définie ci-dessus, chaque appareil signalé dans un événement DISCOVER_DEVICES, servant de réponse à une AWS.DiscoverDevices opération, aura besoin d'un CapbilityReport pour décrire les capacités du périphérique correspondant. Un CapabilityReport `indique les intégrations gérées pour les fonctionnalités des appareils AWS IoT Device Management dans un format compatible avec Matter.

Champs obligatoires dans CapabilityReport

Pour la liste actuelle des fonctionnalités prises en charge et leurs AWS implémentations correspondantes du modèle de données de matière, reportez-vous à la dernière version de la documentation du modèle de données.