Mengirim peristiwa perangkat dengan SendConnectorEvent API

Ikhtisar peristiwa yang dimulai perangkat

Meskipun SendConnectorEvent API digunakan untuk merespons AWS.SendCommand dan AWS.DiscoverDevices operasi secara asinkron, API juga digunakan untuk memberi tahu integrasi terkelola dari setiap peristiwa yang dimulai perangkat. Peristiwa yang dimulai perangkat dapat didefinisikan sebagai peristiwa apa pun yang dihasilkan oleh perangkat tanpa perintah yang dimulai pengguna. Peristiwa perangkat ini mungkin termasuk, tetapi tidak terbatas pada, perubahan status perangkat, deteksi gerakan, tingkat baterai, dan banyak lagi. Anda dapat mengirim peristiwa ini kembali ke integrasi terkelola menggunakan SendConnectorEvent API dengan operasi DEVICE_EVENT.

Bagian berikut menggunakan kamera pintar yang dipasang di rumah sebagai contoh untuk menjelaskan lebih lanjut alur kerja dari peristiwa ini:

Alur kerja acara perangkat

1. Kamera Anda mendeteksi gerakan yang menghasilkan peristiwa yang dikirim ke server sumber daya Anda.

2. Server sumber daya Anda memproses acara dan mengirimkannya ke konektor C2C Anda.

3. Konektor Anda menerjemahkan peristiwa ini ke integrasi terkelola untuk antarmuka AWS IoT Device Management. DEVICE_EVENT

4. Konektor C2C Anda mengirimkan peristiwa perangkat ini ke integrasi terkelola menggunakan SendConnectorEvent API dengan Operasi disetel ke “DEVICE_EVENT”.

5. Integrasi terkelola mengidentifikasi pelanggan yang relevan, dan menyampaikan acara ini kembali ke pelanggan.

6. Pelanggan menerima acara ini dan menampilkannya kepada pengguna melalui pengenal pengguna.

Untuk informasi selengkapnya tentang operasi SendConnectorEvent API, lihat SendConnectorEvent di integrasi terkelola untuk Panduan Referensi API AWS IoT Device Management.

Persyaratan acara yang dimulai perangkat

Berikut ini adalah beberapa persyaratan untuk acara yang dimulai perangkat.

• Sumber daya konektor C2C Anda harus dapat menerima peristiwa perangkat asinkron dari server sumber daya Anda

• Sumber daya konektor C2C Anda harus dapat memanggil integrasi terkelola untuk API layanan AWS IoT Device Management melalui SigV4 AWS menggunakan kredensil yang digunakan untuk mendaftarkan konektor C2C. Akun AWS

Contoh berikut menunjukkan konektor yang mengirimkan peristiwa yang berasal dari perangkat melalui API: SendConnectorEvent

AWS-API: /SendConnectorEvent
URI: POST /connector-event/{Your-Connector-Id}

{
   "UserId": "Your-End-User-ID",
   "Operation": "DEVICE_EVENT",
   "OperationVersion": "1.0",
   "StatusCode": 200,
   "Message": None,
   "ConnectorDeviceId": "Your_Device_Id",
   "MatterEndpoint": {
        "id": "1",    
        "clusters": [{
            "id": "0x0202",
            "attributes": [
                {
                    "0x0000": "3"
                }
            ]
        }]
    }]
}

Dari contoh berikut, kita melihat yang berikut:

• Ini berasal dari titik akhir perangkat dengan ID sama dengan 1.

• Kemampuan perangkat yang terkait dengan acara ini memiliki ID cluster 0x0202, yang berkaitan dengan cluster materi Kontrol Kipas.

• Atribut yang telah berubah memiliki ID 0x000, yang berkaitan dengan Fan Mode Enum dalam cluster. Ini telah diperbarui ke nilai 3, berkaitan dengan nilai Tinggi.

• Karena connectorId merupakan parameter yang dikembalikan oleh layanan cloud saat pembuatan, Konektor harus melakukan kueri menggunakan GetCloudConnector dan memfilter berdasarkanlambdaARN. Lambda sendiri ARN ditanyakan menggunakan Lambda.get_function_url_config API. Hal ini memungkinkan CloudConnectorId untuk diakses secara dinamis di lambda, dan tidak dikonfigurasi secara statis seperti sebelumnya.