Schema dell'attributo LightEffects per la smart home

action.devices.traits.LightEffects: questa caratteristica appartiene ai dispositivi che possono supportare comandi di illuminazione complessi per cambiare stato, ad esempio il passaggio da un colore all'altro.

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Adempimento degli intent.

Esempi

Dispositivo che supporta l'effetto di ciclo di colori.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo che supporta gli effetti di sospensione/risveglio.

{
  "defaultSleepDuration": 300,
  "defaultWakeDuration": 600,
  "supportedEffects": [
    "sleep",
    "wake"
  ]
}

STATI del dispositivo

Le entità con questo attributo possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Adempimento degli intent.

Esempi

Qual è l'effetto attuale sul mio dispositivo?

{
  "activeLightEffect": "colorLoop"
}

Qual è l'effetto attuale sul mio dispositivo?

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

Nessun effetto luminoso attualmente attivo.

{}

COMANDI del dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Adempimento degli intent.

action.devices.commands.ColorLoop

Chiedi al dispositivo di scorrere una serie di colori.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parametri

Esempi

Colorloop le mie luci per 60 minuti.

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

action.devices.commands.Sleep

Abbassa gradualmente la luminosità del dispositivo e, facoltativamente, regola la temperatura di colore per un determinato periodo di tempo.

{
  "supportedEffects": [
    "sleep"
  ]
}

Parametri

Esempi

Fai in modo che le mie luci entrino in modalità Sospensione per 60 minuti.

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

action.devices.commands.StopEffect

Interrompi l'effetto luce corrente.

Parametri

Esempi

Interrompi l'effetto sulla mia luce.

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

action.devices.commands.Wake

Aumenta gradualmente la luminosità del dispositivo e, facoltativamente, regola la temperatura di colore per un determinato periodo di tempo.

{
  "supportedEffects": [
    "wake"
  ]
}

Parametri

Esempi

Fai in modo che le mie luci si accendano per 60 minuti.

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

Emulazione di effetti luce

Se il tuo dispositivo implementa l'attributo Brightness, ma non l'attributo LightEffects, la piattaforma supporta gli effetti "sospensione" ed "risveglio" emulati, senza bisogno di codice aggiuntivo. La piattaforma emula gli effetti inviando una serie di intenti EXECUTE.

Frasi di esempio

ERRORI del dispositivo