本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

实施 AWS.DiscoverDevices 操作

设备发现会将最终用户拥有的物理设备列表与托管集成中维护的最终用户设备的数字表示形式保持一致。 AWS IoT Device Management它由 AWS 客户在最终用户拥有的设备上执行。对于 OAuth 2.0，这种情况发生在账户关联完成之后。对于一般授权，这可能发生在创建账户关联之后。

设备发现是一个异步过程，其中托管集成 AWS IoT Device Management 调用连接器来启动设备发现请求。C2C 连接器异步返回已发现的最终用户设备列表，其中包含托管集成为生成的参考标识符（称为deviceDiscoveryId）。 AWS IoT Device Management

AWS.DiscoverDevices 工作流程

下图说明了最终用户与托管集成之间的设备发现工作流程： AWS IoT Device Management

工作流程步骤

设备发现的 C2C 连接器要求

以下列表概述了 C2C 连接器的要求，以便于成功发现设备：

设备发现流程

步骤 1：托管集成触发设备发现

根据授权类型，DiscoverDevices使用以下 JSON 负载之一向发送 POST 请求：

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

一般授权请求：

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

一般授权申请：

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

步骤 2：连接器确认发现

连接器发送带有以下 JSON 响应的确认：

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

步骤 3：连接器发送设备发现事件

使用以下 JSON 负载/connector-event/{your_connector_id}向发送 POST 请求：

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

为已发现的设备填充品牌和型号

您的 C2C 连接器可以选择在DEVICE_DISCOVERY事件中为每台设备添加一个DeviceMetadata对象，以报告设备的品牌和型号。然后，这些值将在ListDiscoveredDevices和ListManagedThings响应中返回。

在每个设备条目和映射中包含一个DeviceMetadata对象：

以下示例显示了DeviceMetadata包含的设备条目：

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

两个键都是区分大小写的字符串。如果您省略DeviceMetadata、省略单个密钥或提供非字符串值，则检索设备时相应的字段不可用。

为 DISCOVER_D CapabilityReport EVICES 事件构造一个

如上面定义的事件结构所示，在 DISCOVER_DEVICES 事件中报告的每台设备作为对AWS.DiscoverDevices操作的响应，都需要 CapbilityReport 来描述相应设备的功能。`CapabilityReport`以符合 Matter 的格式表示 AWS IoT Device Management 设备功能的托管集成。

中的必填字段 CapabilityReport

有关物质数据模型支持的功能及其相应AWS 实现的当前列表，请参阅最新版本的数据模型文档。