Kelola perintah dan acara perangkat IoT

Perintah perangkat memberikan kemampuan untuk mengelola perangkat fisik dari jarak jauh memastikan kontrol penuh atas perangkat selain melakukan pembaruan keamanan, perangkat lunak, dan perangkat keras yang kritis. Dengan armada perangkat yang besar, mengetahui kapan perangkat melakukan perintah memberikan pengawasan atas seluruh implementasi perangkat Anda. Perintah perangkat atau pembaruan otomatis akan memicu perubahan status perangkat, yang pada gilirannya akan membuat acara perangkat baru. Peristiwa perangkat ini akan memicu notifikasi yang dikirim secara otomatis ke tujuan yang dikelola pelanggan.

Perintah perangkat

Permintaan perintah adalah perintah yang dikirim ke perangkat. Permintaan perintah mencakup muatan yang menentukan tindakan yang akan diambil seperti menyalakan bola lampu. Untuk mengirim perintah perangkat, SendManagedThingCommand API dipanggil atas nama pengguna akhir dengan integrasi terkelola dan permintaan perintah dikirim ke perangkat.

Respons terhadap a SendManagedThingCommand adalah traceId dan Anda dapat menggunakan ini traceId untuk melacak pengiriman perintah dan alur kerja respons perintah terkait sedapat mungkin.

Untuk informasi selengkapnya tentang operasi SendManagedThingCommand API, lihat SendManagedThingCommand.

UpdateStateaksi

Untuk memperbarui status perangkat seperti waktu lampu menyala, gunakan UpdateState tindakan saat memanggil SendManagedThingCommand API. Berikan properti model data dan nilai baru yang Anda perbaruiparameters. Contoh di bawah ini menggambarkan permintaan SendManagedThingCommand API yang OnTime memperbarui bola lampu ke5.

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "matter.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "UpdateState",
              "parameters": {
                "OnTime": 5
              }
            }
          ]
        }
      ]
    }
  ]
}

ReadStateaksi

Untuk mendapatkan status terbaru perangkat termasuk nilai saat ini dari semua properti model data, gunakan ReadState tindakan saat memanggil SendManagedThingCommand API. DipropertiesToRead, Anda dapat menggunakan opsi berikut:

• Berikan properti model data tertentu untuk mendapatkan nilai terbaru seperti OnOff menentukan apakah lampu menyala atau mati.

• Gunakan operator wildcard (*) untuk membaca semua properti status perangkat untuk kemampuan.

Contoh di bawah ini menggambarkan kedua skenario untuk permintaan SendManagedThingCommand API menggunakan ReadState tindakan:

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "aws.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "ReadState",
              "parameters": {
                "propertiesToRead": [ "OnOff" ]
              }
            }
          ]
        }
      ]
    }
  ]
}

{
  "Endpoints": [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "aws.OnOff",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "ReadState",
              "parameters": {
                "propertiesToRead": [ "*" ]
              }
            }
          ]
        }
      ]
    }
  ]}

Acara Perangkat

Peristiwa perangkat mencakup status perangkat saat ini. Ini bisa berarti perangkat telah berubah status, atau melaporkan statusnya bahkan jika statusnya tidak berubah. Ini termasuk laporan properti dan peristiwa yang didefinisikan dalam model data. Suatu peristiwa bisa berupa siklus mesin cuci telah selesai atau termostat telah mencapai suhu yang ditargetkan yang ditetapkan oleh pengguna akhir.

Pemberitahuan acara perangkat

Pengguna akhir dapat berlangganan tujuan tertentu yang dikelola pelanggan yang mereka buat untuk pembaruan pada peristiwa perangkat tertentu. Untuk membuat tujuan yang dikelola pelanggan, panggil API. CreateDestination Saat peristiwa perangkat dilaporkan ke integrasi terkelola oleh perangkat, tujuan yang dikelola pelanggan akan diberi tahu jika ada.