Selamat datang di Pusat Developer Google Home, tempat baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.

Skema Trait Timer Smart Home

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

Misalnya, pengontrol smart sprinkler atau tombol lampu smart mungkin memiliki timer bawaan. Sifat ini dapat digunakan untuk mengontrol timer bawaan di perangkat, seperti memulai timer baru serta menjeda dan membatalkan timer yang sedang berjalan, dan menanyakan berapa banyak waktu yang tersisa.

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 Type 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). Setel atribut ini ke true jika perangkat tidak dapat merespons intent QUERY atau Status Laporan untuk karakteristik ini.

Contoh

Perangkat dengan batas timer dua jam.

{
  "maxTimerLimitSec": 7200
}

STATE 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 Type Deskripsi
timerRemainingSec Integer

Wajib.

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

timerPaused Boolean

True jika timer aktif ada, tetapi saat ini dijeda.

Contoh

Berapa lama waktu yang tersisa di timer perangkat? (tidak berjalan).

{
  "timerRemainingSec": -1
}

Berapa lama waktu yang tersisa di timer perangkat? (berjalan).

{
  "timerRemainingSec": 60
}

Berapa lama waktu yang tersisa di timer perangkat? (dijeda).

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

PERMINTAAN 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 Type Deskripsi
timerTimeSec Integer

Wajib.

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

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 Type Deskripsi
timerTimeSec Integer

Wajib.

Penyesuaian positif atau negatif timer dalam hitungan detik; harus berada 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

Menjeda timer.

Parameter

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

Melanjutkan timer.

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Lanjutkan timer perangkat.

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

Terjadi error saat melanjutkan timer.

Nilai yang didukung:

noTimerExists

action.devices.commands.TimerCancel

Membatalkan timer.

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Menghentikan timer perangkat.

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

Terjadi error saat menghentikan timer.

Nilai yang didukung:

noTimerExists

ERRORS perangkat

Lihat daftar lengkap error dan pengecualian.