Skema Karakteristik LightEffects Smart Home

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

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani intent SYNC, 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 sifat ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani intent QUERY, lihat Fulfillment intent.

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 aktif saat ini.

{}

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

Meminta perangkat untuk berganti-ganti melalui serangkaian warna.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parameter

Contoh

Ubah warna 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 jangka waktu tertentu.

{
  "supportedEffects": [
    "sleep"
  ]
}

Parameter

Contoh

Setel lampu saya ke mode tidur selama 60 menit.

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

action.devices.commands.StopEffect

Hentikan efek cahaya saat ini.

Parameter

Contoh

Hentikan efek pada lampu saya.

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

action.devices.commands.Wake

Menaikkan kecerahan perangkat secara bertahap dan, secara opsional, menyesuaikan suhu warna selama jangka waktu tertentu.

{
  "supportedEffects": [
    "wake"
  ]
}

Parameter

Contoh

Make my lights wake for 60 minutes. (Buat lampu saya menyala selama 60 menit).

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

Emulasi efek cahaya

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

Contoh ucapan

ERROR Perangkat