Skema Fitur Timer Smart Home

action.devices.traits.Timer - Fitur Timer mewakili timer di perangkat.

Misalnya, pengontrol penyiram smart atau sakelar lampu smart mungkin memiliki timer bawaan. Trait ini dapat digunakan untuk mengontrol timer bawaan di perangkat, seperti memulai timer baru serta menjeda dan membatalkan timer yang sedang berjalan, dan menanyakan sisa waktu.

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani intent SYNC, lihat Fulfillment intent.

Atribut Jenis Deskripsi
maxTimerLimitSec Bilangan Bulat

Wajib.

Menunjukkan setelan timer terlama yang tersedia di perangkat, diukur dalam detik.

Nilai minimum: 1.
commandOnlyTimer Boolean

(Default: false)

Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke benar (true) jika perangkat tidak dapat merespons intent QUERY atau Report State untuk karakteristik ini.

Contoh

Perangkat dengan batas timer dua jam.

{
  "maxTimerLimitSec": 7200
}

STATUS Perangkat

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

Negara bagian Jenis Deskripsi
timerRemainingSec Bilangan Bulat

Wajib.

Waktu saat ini yang tersisa dalam detik, -1, atau [0, maxTimerLimitSec]. Setel ke -1 untuk menunjukkan bahwa tidak ada timer yang berjalan.
timerPaused Boolean

Benar jika ada timer aktif, tetapi saat ini dijeda.

Contoh

Berapa sisa waktu di timer perangkat? (tidak berjalan).

{
  "timerRemainingSec": -1
}

Berapa sisa waktu di timer perangkat? (berjalan).

{
  "timerRemainingSec": 60
}

Berapa sisa waktu di timer perangkat? (dijeda).

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

PERINTAH perangkat

Perangkat dengan trait ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari lebih lanjut cara menangani intent EXECUTE, lihat Fulfillment intent.

action.devices.commands.TimerStart

Mulai timer baru.

Parameter

Parameter Jenis Deskripsi
timerTimeSec Bilangan Bulat

Wajib.

Durasi timer dalam detik; harus dalam [1, maxTimerLimitSec].

Nilai minimum: 1.

Contoh

Jalankan timer perangkat selama lima menit.

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

Terjadi error saat memulai timer.

Nilai yang didukung:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Sesuaikan durasi timer.

Parameter

Parameter Jenis Deskripsi
timerTimeSec Bilangan Bulat

Wajib.

Penyesuaian timer positif atau negatif dalam detik; harus dalam [-maxTimerLimitSec, maxTimerLimitSec].

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

Terjadi error saat menyesuaikan timer.

Nilai yang didukung:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

Jeda timer.

Parameter

Parameter Jenis Deskripsi

Tidak ada properti

Contoh

Menjeda timer perangkat.

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

Terjadi error saat menjeda timer.

Nilai yang didukung:

noTimerExists

action.devices.commands.TimerResume

Lanjutkan timer.

Parameter

Parameter Jenis Deskripsi

Tidak ada properti

Contoh

Lanjutkan timer perangkat.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

Terjadi error saat melanjutkan penghitung waktu.

Nilai yang didukung:

noTimerExists

action.devices.commands.TimerCancel

Membatalkan timer.

Parameter

Parameter Jenis Deskripsi

Tidak ada properti

Contoh

Hentikan timer perangkat.

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

Terjadi error saat menghentikan timer.

Nilai yang didukung:

noTimerExists

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.