Skema Atribut LightEffects Smart Home

action.devices.traits.LightEffects - Sifat ini milik perangkat yang dapat mendukung perintah pencahayaan yang kompleks untuk mengubah status, seperti melakukan loop 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.

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.

Contoh

Apa pengaruhnya saat ini terhadap perangkat saya?

{
  "activeLightEffect": "colorLoop"
}

Apa efek saat ini pada perangkat saya?

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

Tidak ada efek cahaya yang saat ini aktif.

{}

Perintah Perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari lebih lanjut cara menangani intent EXECUTE, lihat Fulfillment intent.

action.devices.commands.ColorLoop

Minta perangkat untuk beralih melalui kumpulan warna.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parameter

Contoh

Colorloop lampu saya selama 60 menit.

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

action.devices.commands.Sleep

Menurunkan kecerahan perangkat secara bertahap dan, secara opsional, menyesuaikan suhu warna selama durasi waktu tertentu.

{
  "supportedEffects": [
    "sleep"
  ]
}

Parameter

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

Contoh

Hentikan efek pada lampu saya.

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

action.devices.commands.Wake

Secara bertahap meningkatkan kecerahan perangkat dan, secara opsional, menyesuaikan suhu warna selama durasi waktu tertentu.

{
  "supportedEffects": [
    "wake"
  ]
}

Parameter

Contoh

Buat lampu saya menyala selama 60 menit.

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

Emulasi efek cahaya

Jika perangkat Anda menerapkan karakteristik Brightness, tetapi tidak menerapkan karakteristik LightEffects, platform akan mendukung efek "sleep" dan "wake" yang diemulasi, tanpa memerlukan kode tambahan. Platform mengemulasi efek dengan mengirimkan serangkaian intent EXECUTE.

Contoh ucapan

Perangkat ERRORS