Skema Fitur Timer Smart Home

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

Misalnya, pengontrol smart sprinkler atau tombol smart mungkin memiliki timer bawaan. Fitur ini dapat digunakan untuk mengontrol timer bawaan di perangkat, seperti memulai timer baru serta menjeda dan membatalkan timer yang berjalan, serta menanyakan sisa waktu.

ATRIBUT Perangkat

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

Atribut	Jenis	Deskripsi
maxTimerLimitSec	Integer	Wajib. Menunjukkan setelan timer terlama yang tersedia di perangkat, diukur dalam detik.
commandOnlyTimer	Boolean	(Default: false) Menunjukkan apakah perangkat mendukung penggunaan komunikasi satu arah (benar) atau dua arah (salah). Tetapkan atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk fitur 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.

Negara bagian	Jenis	Deskripsi
timerRemainingSec	Integer	Wajib. Waktu saat ini yang tersisa dalam detik, -1, atau [0, maxTimerLimitSec]. Setel ke -1 untuk mengindikasikan tidak ada timer yang berjalan.
timerPaused	Boolean	Benar jika ada timer yang aktif, 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
}

COMMAND Perangkat

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	Jenis	Deskripsi
timerTimeSec	Integer	Wajib. Durasi timer dalam detik; harus dalam [1, maxTimerLimitSec].

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	Jenis	Deskripsi
timerTimeSec	Integer	Wajib. Penyesuaian timer positif atau negatif dalam hitungan 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
  }
}

Error terkait

Terjadi error saat menyesuaikan timer.

Nilai yang didukung:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerPause

Menjeda timer.

Parameter

Parameter	Jenis	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

Melanjutkan timer.

Parameter

Parameter	Jenis	Deskripsi
Tidak ada properti

Contoh

Melanjutkan 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	Jenis	Deskripsi
Tidak ada properti

Contoh

Menghentikan timer perangkat.

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

Error terkait

Terjadi error saat menghentikan timer.

Nilai yang didukung:

noTimerExists

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.