Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Implementieren Sie die AWS.DiscoverDevices Operation

Die Geräteerkennung gleicht die Liste der physischen Geräte, die dem Endbenutzer gehören, mit den digitalen Darstellungen dieser Endbenutzergeräte ab, die in Managed Integrations for verwaltet werden. AWS IoT Device Management Sie wird von einem AWS Kunden auf Geräten durchgeführt, die dem Endbenutzer gehören. Bei OAuth 2.0 erfolgt dies, nachdem die Kontoverknüpfung abgeschlossen ist. Bei der allgemeinen Autorisierung kann dies geschehen, nachdem die Kontozuordnung erstellt wurde.

Die Geräteerkennung ist ein asynchroner Prozess, bei dem Managed Integrations for einen Connector AWS IoT Device Management aufruft, um die Anfrage zur Geräteerkennung zu initiieren. Ein C2C-Connector gibt asynchron eine Liste der erkannten Endbenutzergeräte mit einer Referenz-ID (als bezeichnetdeviceDiscoveryId) zurück, die von Managed Integrations for generiert wurde. AWS IoT Device Management

AWS.DiscoverDevices-Workflow

Das folgende Diagramm veranschaulicht den Ablauf der Geräteerkennung zwischen dem Endbenutzer und Managed Integrations für: AWS IoT Device Management

Workflow-Schritte

Anforderungen an den C2C-Anschluss für die Geräteerkennung

In der folgenden Liste sind die Anforderungen für Ihren C2C-Anschluss aufgeführt, um eine erfolgreiche Geräteerkennung zu ermöglichen:

Prozess zur Geräteerkennung

Schritt 1: Verwaltete Integrationen lösen die Geräteerkennung aus

Senden Sie je nach DiscoverDevices Autorisierungstyp eine POST-Anfrage mit einer der folgenden JSON-Payloads an:

OAuth 2.0-Anfrage:

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

Allgemeine Autorisierungsanfrage:

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

Allgemeine Autorisierungsanfrage:

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

Schritt 2: Der Connector bestätigt die Entdeckung

Der Connector sendet eine Bestätigung mit der folgenden JSON-Antwort:

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

Schritt 3: Connector sendet Geräteerkennungsereignis

Senden Sie eine POST-Anfrage /connector-event/{your_connector_id} mit der folgenden JSON-Nutzlast an:

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

Geben Sie Marke und Modell für die erkannten Geräte ein

Ihr C2C-Anschluss kann optional für jedes Gerät ein DeviceMetadata Objekt enthalten, um DEVICE_DISCOVERY die Marke und das Modell des Geräts zu melden. Diese Werte werden dann in den ListManagedThingsAntworten ListDiscoveredDevicesund zurückgegeben.

Fügen Sie jedem Geräteeintrag und jeder Zuordnung ein DeviceMetadata Objekt hinzu:

Das folgende Beispiel zeigt einen Geräteeintrag mit DeviceMetadata enthalten:

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

Bei beiden Tasten wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie weglassenDeviceMetadata, einen einzelnen Schlüssel weglassen oder einen Wert angeben, der keine Zeichenfolge ist, ist das entsprechende Feld nicht verfügbar, wenn das Gerät abgerufen wird.

Konstruieren Sie ein CapabilityReport für das DISCOVER_DEVICES-Ereignis

Wie aus der oben definierten Ereignisstruktur ersichtlich, benötigt jedes in einem DISCOVER_DEVICES-Ereignis gemeldete Gerät, das als Reaktion auf eine AWS.DiscoverDevices Operation dient, eine, CapbilityReport um die Fähigkeiten des entsprechenden Geräts zu beschreiben. Ein `CapabilityReport` teilt verwalteten Integrationen für AWS IoT Device Management-Gerätefunktionen in einem Matter-konformen Format mit.

Erforderliche Felder in CapabilityReport

Die aktuelle Liste der unterstützten Funktionen und der entsprechenden AWS Implementierungen des Matter-Datenmodells finden Sie in der neuesten Version der Datenmodell-Dokumentation.