As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Implemente a AWS.DiscoverDevices operação

A descoberta de dispositivos alinha a lista de dispositivos físicos de propriedade do usuário final com as representações digitais desses dispositivos de usuário final mantidas em Integrações gerenciadas para. AWS IoT Device Management Ela é executada por um AWS cliente em dispositivos pertencentes ao usuário final. Para o OAuth 2.0, isso ocorre após a conclusão da vinculação da conta. Para a Autorização Geral, isso pode ocorrer após a criação da associação da conta.

A descoberta de dispositivos é um processo assíncrono em que as integrações gerenciadas AWS IoT Device Management chamam um conector para iniciar a solicitação de descoberta do dispositivo. Um conector C2C retorna uma lista de dispositivos de usuário final descobertos de forma assíncrona com um identificador de referência (chamado dedeviceDiscoveryId) gerado pelo Managed Integrations for. AWS IoT Device Management

Fluxo de trabalho do AWS.DiscoverDevices

O diagrama a seguir ilustra o fluxo de trabalho de descoberta de dispositivos entre o usuário final e as integrações gerenciadas para: AWS IoT Device Management

Etapas do fluxo de trabalho

Requisitos do conector C2C para descoberta de dispositivos

A lista a seguir descreve os requisitos do seu conector C2C para facilitar a descoberta bem-sucedida do dispositivo:

Processo de descoberta de dispositivos

Etapa 1: integrações gerenciadas acionam a descoberta de dispositivos

Envie uma solicitação POST para DiscoverDevices com uma das seguintes cargas JSON, dependendo do tipo de autorização:

Solicitação do 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": []
   }
}

Solicitação de autorização geral:

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

Solicitação de autorização geral:

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

Etapa 2: O conector confirma a descoberta

O conector envia uma confirmação com a seguinte resposta JSON:

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

Etapa 3: O conector envia o evento de descoberta do dispositivo

Envie uma solicitação POST para /connector-event/{your_connector_id} com a seguinte carga 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"]
 				}]
 			}]
 		}
        }
    ]
}

Preencha a marca e o modelo dos dispositivos descobertos

Seu conector C2C pode, opcionalmente, incluir um DeviceMetadata objeto para cada dispositivo no DEVICE_DISCOVERY evento para relatar a marca e o modelo do dispositivo. Esses valores são então retornados nas ListManagedThingsrespostas ListDiscoveredDevicese.

Inclua um DeviceMetadata objeto em cada entrada e mapa do dispositivo:

O exemplo a seguir mostra uma entrada de dispositivo DeviceMetadata incluída:

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

Ambas as teclas fazem distinção entre maiúsculas e minúsculas. Se você omitirDeviceMetadata, omitir uma chave individual ou fornecer um valor que não seja uma string, o campo correspondente não estará disponível quando o dispositivo for recuperado.

Construa um CapabilityReport para o evento DISCOVER_DEVICES

Conforme visto na estrutura de eventos definida acima, cada dispositivo relatado em um evento DISCOVER_DEVICES, servindo como resposta a uma AWS.DiscoverDevices operação, exigirá CapbilityReport a descrição dos recursos do dispositivo correspondente. Um `CapabilityReport` indica integrações gerenciadas para os recursos do dispositivo AWS IoT Device Management em um formato compatível com Matter.

Campos obrigatórios em CapabilityReport

Para obter a lista atual de recursos suportados e suas AWS implementações correspondentes do Matter Data Model, consulte a versão mais recente da documentação do Data Model.