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

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

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.