Skema Atribut LightEffects Smart Home

action.devices.traits.LightEffects - Sifat ini dimiliki oleh perangkat yang dapat mendukung perintah pencahayaan kompleks untuk mengubah status, seperti melakukan loop 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 karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani intent QUERY, lihat Fulfillment intent.

Contoh

Apa pengaruhnya saat ini terhadap perangkat saya?

{
  "activeLightEffect": "colorLoop"
}

Apa pengaruhnya saat ini terhadap 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

Buat lampu saya berganti warna 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 mengemulasikan efek dengan mengirimkan serangkaian intent EXECUTE.

Contoh ucapan

ERROR Perangkat