Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Melaksanakan AWS.DiscoverDevices operasi

Penemuan perangkat menyelaraskan daftar perangkat fisik yang dimiliki oleh pengguna akhir dengan representasi digital dari perangkat pengguna akhir yang dikelola dalam Integrasi Terkelola untuk. AWS IoT Device Management Ini dilakukan oleh AWS pelanggan pada perangkat yang dimiliki oleh pengguna akhir. Untuk OAuth 2.0, ini terjadi setelah penautan akun selesai. Untuk Otorisasi Umum, ini dapat terjadi setelah asosiasi akun dibuat.

Penemuan perangkat adalah proses asinkron di mana Integrasi Terkelola untuk AWS IoT Device Management memanggil konektor untuk memulai permintaan penemuan perangkat. Konektor C2C mengembalikan daftar perangkat pengguna akhir yang ditemukan secara asinkron dengan pengidentifikasi referensi (disebut sebagaideviceDiscoveryId) yang dihasilkan oleh Integrasi Terkelola untuk. AWS IoT Device Management

Alur kerja AWS.DiscoverDevices

Diagram berikut mengilustrasikan alur kerja penemuan perangkat antara pengguna akhir dan Integrasi Terkelola untuk: AWS IoT Device Management

Langkah Alur Kerja

Persyaratan konektor C2C untuk Penemuan Perangkat

Daftar berikut menguraikan persyaratan untuk konektor C2C Anda untuk memfasilitasi penemuan perangkat yang sukses:

Proses Penemuan Perangkat

Langkah 1: Integrasi Terkelola Memicu Penemuan Perangkat

Kirim permintaan POST ke DiscoverDevices dengan salah satu muatan JSON berikut, tergantung pada jenis otorisasi:

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

Permintaan Otorisasi Umum:

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

Permintaan Otorisasi Umum:

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

Langkah 2: Konektor Mengakui Penemuan

Konektor mengirimkan pengakuan dengan respons JSON berikut:

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

Langkah 3: Konektor Mengirim Acara Penemuan Perangkat

Kirim permintaan POST ke /connector-event/{your_connector_id} dengan muatan JSON berikut:

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

Isi Merek dan Model untuk perangkat yang ditemukan

Konektor C2C Anda secara opsional dapat menyertakan DeviceMetadata objek untuk setiap perangkat DEVICE_DISCOVERY jika melaporkan merek dan model perangkat. Nilai-nilai ini kemudian dikembalikan dalam ListDiscoveredDevicesdan ListManagedThingstanggapan.

Sertakan DeviceMetadata objek di setiap entri dan peta perangkat:

Contoh berikut menunjukkan entri perangkat dengan DeviceMetadata disertakan:

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

Kedua kunci adalah string case-sensitive. Jika Anda menghilangkanDeviceMetadata, menghilangkan kunci individual, atau memberikan nilai non-string, bidang yang sesuai tidak tersedia saat perangkat diambil.

Membangun sebuah CapabilityReport untuk acara DISCOVER_DEVICES

Seperti yang terlihat dalam struktur peristiwa yang didefinisikan di atas, setiap perangkat yang dilaporkan dalam peristiwa DISCOVER_DEVICES, yang berfungsi sebagai respons terhadap AWS.DiscoverDevices operasi, akan memerlukan a CapbilityReport untuk menggambarkan kemampuan perangkat yang sesuai. A `CapabilityReport` memberi tahu integrasi terkelola untuk kemampuan perangkat AWS IoT Device Management dalam format yang sesuai dengan Matter.

Bidang yang Diperlukan di CapabilityReport

Untuk daftar kemampuan yang didukung saat ini dan AWS implementasi yang sesuai dari Model Data Matter, lihat rilis terbaru dari dokumentasi Model Data.