Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Sifat LightEffect Smart Home

action.devices.traits.LightEffects - Sifat ini dimiliki perangkat yang dapat mendukung perintah pencahayaan kompleks untuk mengubah status, seperti mengulang berbagai warna.

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
defaultColorLoopDuration Integer

(Default: 1800)

Durasi default, dalam detik, untuk efek yang dipicu oleh perintah action.devices.commands.ColorLoop.

defaultSleepDuration Integer

(Default: 1800)

Durasi default, dalam detik, untuk efek yang dipicu oleh perintah action.devices.commands.Sleep.

defaultWakeDuration Integer

(Default: 1800)

Durasi default, dalam detik, untuk efek yang dipicu oleh perintah action.devices.commands.Wake.

supportedEffects Array

Wajib.

Daftar efek yang didukung perangkat.

[item, ...] String

Efek yang didukung.

Nilai yang didukung:

colorLoop
Mengulang-ulang berbagai warna secara acak.
sleep
Mengurangi kecerahan secara bertahap dan, secara opsional, menyesuaikan suhu warna selama jangka waktu tertentu.
wake
Secara bertahap meningkatkan kecerahan dan, secara opsional, menyesuaikan suhu warna selama jangka waktu tertentu.

Contoh

Perangkat yang mendukung efek loop warna.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Perangkat yang mendukung efek tidur/bangun.

{
  "defaultSleepDuration": 300,
  "defaultWakeDuration": 600,
  "supportedEffects": [
    "sleep",
    "wake"
  ]
}

STATUS Perangkat

Perangkat 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
activeLightEffect String

Saat ini efek cahaya aktif jika ada. Salah satu dari supportedEffects.

Nilai yang didukung:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Integer

Stempel waktu Unix saat efek diharapkan untuk berakhir, jika efek berakhir dengan sendirinya.

Contoh

Apa efek perangkat saya saat ini?

{
  "activeLightEffect": "colorLoop"
}

Apa efek perangkat saya saat ini?

{
  "activeLightEffect": "sleep",
  "lightEffectEndUnixTimestampSec": 1595286869
}

Tidak ada efek cahaya yang saat ini aktif.

{}

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.ColorLoop

Meminta perangkat untuk melihat seluruh rangkaian warna.

Perintah ini memerlukan atribut berikut:
{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parameter

Parameter Jenis Deskripsi
duration Integer

Durasi untuk perintah loop warna, dalam detik.

Contoh

Colorloop lampu saya selama 60 menit.

{
  "command": "action.devices.commands.ColorLoop",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.Sleep

Secara bertahap turunkan kecerahan perangkat dan, secara opsional, sesuaikan suhu warna selama durasi waktu tertentu.

Perintah ini memerlukan atribut berikut:
{
  "supportedEffects": [
    "sleep"
  ]
}

Parameter

Parameter Jenis Deskripsi
duration Integer

Durasi untuk perintah tidur, dalam detik.

Contoh

Buat lampu saya tidur selama 60 menit.

{
  "command": "action.devices.commands.Sleep",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.StopEffect

Hentikan efek cahaya saat ini.

Parameter

Parameter Jenis Deskripsi

Tidak ada properti

Contoh

Hentikan efek lampu saya.

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

action.devices.commands.Wake

Tingkatkan kecerahan perangkat secara bertahap dan, secara opsional, sesuaikan suhu warna selama durasi waktu tertentu.

Perintah ini memerlukan atribut berikut:
{
  "supportedEffects": [
    "wake"
  ]
}

Parameter

Parameter Jenis Deskripsi
duration Integer

Durasi untuk perintah bangun, dalam detik.

Contoh

Nyalakan lampu saya selama 60 menit.

{
  "command": "action.devices.commands.Wake",
  "params": {
    "duration": 3600
  }
}

Emulasi efek cahaya

Jika perangkat Anda menerapkan fitur Brightness tetapi tidak fitur LightEffects, platform mendukung efek "tidur" dan "bangun" yang diemulasi, tanpa memerlukan kode tambahan. Platform mengemulasikan efek dengan mengirimkan serangkaian intent EXECUTE.

Contoh ucapan

de-DE

  • Den Aufwacheffekt der Lampen dimulai.
  • Einschlafmodus im Schlafzimmer aktivieren.
  • Synchronisiere meine Geräte

en-US

  • Mulai efek tidur di lampu saya .
  • saya ingin kamu mulai efek bangun di lampu

es-ES

  • pon la luz de despertarse lentamente durante 45 menit
  • pon las luces de dormir

fr-FR

  • Dominasi total les lumières .
  • Progresif Éteins les lumières .

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.