Skema Trait Timer Smart Home
action.devices.traits.Timer
- Fitur Timer mewakili timer di perangkat.
Misalnya, pengontrol sprinkler smart atau tombol lampu smart mungkin memiliki timer bawaan. Ciri ini dapat digunakan untuk mengontrol timer bawaan pada perangkat, seperti memulai timer baru serta menjeda dan membatalkan timer yang berjalan, serta menanyakan berapa banyak waktu yang tersisa.
ATTRIBUTE Perangkat
Perangkat dengan ciri ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari
penanganan intent SYNC
lebih lanjut, lihat
Fulfillment intent.
Atribut | Type | Deskripsi |
---|---|---|
maxTimerLimitSec |
Bilangan Bulat |
Wajib. Menunjukkan setelan timer terlama yang tersedia pada perangkat, diukur dalam detik. |
commandOnlyTimer |
Boolean |
(Default: Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Setel atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini. |
Contoh
Perangkat dengan batas timer dua jam.
{ "maxTimerLimitSec": 7200 }
STATUS Perangkat
Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY
. Untuk mempelajari
penanganan intent QUERY
lebih lanjut, lihat
Fulfillment intent.
Status | Type | Deskripsi |
---|---|---|
timerRemainingSec |
Bilangan Bulat |
Wajib. Waktu saat ini tersisa dalam detik, -1, atau [0, |
timerPaused |
Boolean |
True jika timer aktif ada, tetapi saat ini dijeda. |
Contoh
Berapa banyak waktu yang tersisa di timer perangkat? (tidak berjalan).
{ "timerRemainingSec": -1 }
Berapa banyak waktu yang tersisa di timer perangkat? (berjalan).
{ "timerRemainingSec": 60 }
Berapa banyak waktu yang tersisa di timer perangkat? (dijeda).
{ "timerRemainingSec": 30, "timerPaused": true }
Perangkat COMMAND
Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE
. Untuk mempelajari
penanganan intent EXECUTE
lebih lanjut, lihat
Fulfillment intent.
action.devices.commands.TimerStart
Mulai timer baru.
Parameter
Parameter | Type | Deskripsi |
---|---|---|
timerTimeSec |
Bilangan Bulat |
Wajib. Durasi timer dalam detik; harus dalam waktu [1, |
Contoh
Jalankan timer perangkat selama lima menit.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
Error terkait
Terjadi error saat memulai timer.
Nilai yang didukung:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
Sesuaikan durasi timer.
Parameter
Parameter | Type | Deskripsi |
---|---|---|
timerTimeSec |
Bilangan Bulat |
Wajib. Penyesuaian timer positif atau negatif dalam detik; harus dalam waktu [ |
Contoh
Tambahkan satu menit ke timer perangkat.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": 60 } }
Mengurangi 30 detik dari timer perangkat.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -30 } }
Error terkait
Terjadi error saat menyesuaikan timer.
Nilai yang didukung:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerPause
Jeda timer.
Parameter
Parameter | Type | Deskripsi |
---|---|---|
Tidak ada properti |
Contoh
Menjeda timer perangkat.
{ "command": "action.devices.commands.TimerPause", "params": {} }
Error terkait
Terjadi error saat menjeda timer.
Nilai yang didukung:
noTimerExists
action.devices.commands.TimerResume
Lanjutkan timer.
Parameter
Parameter | Type | Deskripsi |
---|---|---|
Tidak ada properti |
Contoh
Lanjutkan timer perangkat.
{ "command": "action.devices.commands.TimerResume", "params": {} }
Error terkait
Terjadi error saat melanjutkan timer.
Nilai yang didukung:
noTimerExists
action.devices.commands.TimerCancel
Membatalkan timer.
Parameter
Parameter | Type | Deskripsi |
---|---|---|
Tidak ada properti |
Contoh
Hentikan timer perangkat.
{ "command": "action.devices.commands.TimerCancel", "params": {} }
Error terkait
Terjadi error saat menghentikan penghitung waktu.
Nilai yang didukung:
noTimerExists