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 Efek Cahaya Smart Home

action.devices.traits.LightEffects - Sifat ini dimiliki perangkat yang dapat mendukung perintah pencahayaan yang 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 Type 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
Ulang warna secara acak.
sleep
Secara bertahap menurunkan kecerahan 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"
  ]
}

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

Efek cahaya aktif saat ini jika ada. Salah satu dari supportedEffects.

Nilai yang didukung:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Integer

Stempel waktu Unix saat efek diharapkan 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.

{}

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

Meminta perangkat untuk melihat seluruh kumpulan warna.

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

Parameter

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

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

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

Parameter

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

Menghentikan efek cahaya saat ini.

Parameter

Parameter Type Deskripsi

Tidak ada properti

Contoh

Hentikan efek di 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 Type 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 mengimplementasikan fitur Brightness tetapi bukan fitur LightEffects, platform akan mendukung efek "tidur" dan "bangun" yang diemulasikan, tanpa memerlukan kode tambahan. Platform ini mengemulasikan efek dengan mengirimkan serangkaian intent EXECUTE.

Contoh ucapan

de-DE

  • Den Aufwacheffekt der Lampen starten.
  • Einschlafmodus im Schlafzimmer aktivieren.
  • synchronisiere meine Geräte

en-US

  • Begin the sleep effect on my lights .
  • I want you to start wake effect on the lights

es-ES

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

fr-FR

  • Allume doucement les lumières .
  • Éteins progressivement les lumières .

hi-IN

  • बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
  • लाइट को स्लीप मोड में डाल दो

it-IT

  • Accendi le luci gradualmente
  • Avvia le luci per dormire

ja-JP

  • ライト を徐々に明るくなる設定にして
  • 照明 を少しずつ暗くして

ko-KR

  • 안방 전등 기상 모드 시작해
  • 조명 에서 수면 모드 실행

nl-NL

  • Dim de lichten langzaam.
  • Laat mijn lamp langzaam feller worden.

pt-BR

  • Acenda lentamente as luzes do quarto por 1 hora .
  • Ativa as luzes de despertar no quarto dos miudos .
  • Iniciar o modo dormir por 1 hora nas luzes do quarto .
  • Liga a função adormecer das luzes .

sv-SE

  • Starta insomningsläge på lamporna
  • Tänd lamporna långsamt

ERRORS perangkat

Lihat daftar lengkap error dan pengecualian.