Skema Atribut RunCycle Smart Home

action.devices.traits.RunCycle - Ciri ini mewakili perangkat apa pun yang memiliki durasi berkelanjutan untuk operasinya yang dapat dikueri.

Perangkat seperti ini akan melaporkan jumlah total siklusnya pada awal operasi, dan setiap siklus yang sedang dijalankan perangkat saat ini. Hal ini memungkinkan pengguna membuat kueri, seperti berikut:

• Siklus apa yang sedang digunakan pengering saya?
• Berapa siklus yang tersisa di mesin pencuci piring?
• Apa yang dilakukan pengering?
• Kapan pencucian akan dilakukan?

Perangkat tertentu menyertakan durasi dalam format non-siklik. Setiap perangkat yang berjalan selama jangka waktu tertentu dapat melaporkan waktu yang tersisa, tanpa siklus. Hal ini juga menangani kasus saat siklus mungkin tidak konsisten (misalnya, penyedot debu mungkin tidak selalu menggunakan semua siklus). Misalnya, pengguna dapat bertanya, Berapa lama lagi penyedot debu saya akan berjalan? yang akan menampilkan jumlah waktu dalam unit yang sebanding dengan waktu yang tersisa. Hal ini juga berlaku untuk perangkat yang tercantum di atas; Berapa lama lagi pakaian saya akan kering? akan menampilkan durasi dalam hitungan menit.

Perangkat dapat menampilkan apa yang diketahuinya, dan respons TTS Asisten akan membentuk jawaban terbaik dengan data yang tersedia (misalnya, Mesin pencuci piring sedang berjalan dan akan selesai dalam waktu sekitar 20 menit.)

RunCycle saat ini merupakan karakteristik hanya baca - tidak memiliki perintah, hanya status untuk kueri. Di masa mendatang, mungkin ada mekanisme untuk menjalankan ulang siklus atau melewati siklus (baik untuk sprinkler, buruk untuk mesin cuci).

ATRIBUT Perangkat

Tidak ada.

Status PERANGKAT

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani intent QUERY, lihat Fulfillment intent.

Contoh

Perangkat masih dalam proses pembilasan selama 5 menit lagi, dan akan selesai dalam 20 menit.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

Perangkat akan dibilas selama 5 menit lagi, sebelum beralih ke putaran.

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

Perintah Perangkat

Tidak ada.

NOTIFIKASI Perangkat

Perangkat dengan karakteristik ini dapat menampilkan payload notifikasi berikut sebagai bagian dari perubahan status perangkat. Untuk mempelajari penerapan notifikasi lebih lanjut, lihat Notifikasi untuk Action smart home.

Contoh

Perangkat telah selesai dijalankan.

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

Terjadi error saat menyelesaikan siklus saat ini.

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

ERROR Perangkat