Skema Trait Efek Cahaya Rumah Smart

action.devices.traits.LightEffects - Trait ini milik perangkat yang dapat mendukung perintah pencahayaan kompleks untuk mengubah status, seperti melakukan loop melalui berbagai warna.

ATTRIBUTE Perangkat

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

Atribut Type Deskripsi
defaultColorLoopDuration Bilangan Bulat

(Default: 1800)

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

defaultSleepDuration Bilangan Bulat

(Default: 1800)

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

defaultWakeDuration Bilangan Bulat

(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 berbagai warna secara acak.
sleep
Menurunkan kecerahan secara bertahap dan, secara opsional, menyesuaikan suhu warna selama jangka waktu tertentu.
wake
Meningkatkan kecerahan secara bertahap dan, secara opsional, menyesuaikan suhu warna selama jangka waktu tertentu.

Contoh

Efek loop warna pendukung perangkat.

{
  "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.

Status Type Deskripsi
activeLightEffect String

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

Nilai yang didukung:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Bilangan Bulat

Stempel waktu Unix saat efek diperkirakan berakhir, jika efek berakhir dengan sendirinya.

Contoh

Apa efek saat ini pada perangkat saya?

{
  "activeLightEffect": "colorLoop"
}

Apa efek saat ini pada perangkat saya?

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

Tidak ada efek cahaya yang saat ini aktif.

{}

Perangkat COMMAND

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

Minta perangkat untuk menelusuri serangkaian warna.

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

Parameter

Parameter Type Deskripsi
duration Bilangan Bulat

Durasi untuk perintah loop warna, dalam detik.

Contoh

Warnai 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 Bilangan Bulat

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

Durasi untuk perintah bangun, dalam detik.

Contoh

Buat lampu saya bangun selama 60 menit.

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

Emulasi efek cahaya

Jika perangkat Anda mengimplementasikan trait Brightness, tetapi bukan trait LightEffects, platform akan mendukung efek "sleep" dan "wake" yang diemulasikan, tanpa memerlukan kode tambahan. Platform ini mengemulasi 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.