Schema del tratto Effetti di luce per la smart home

action.devices.traits.LightEffects: questo tratto appartiene ai dispositivi che possono supportare comandi di illuminazione complessi per cambiare stato, ad esempio scorrere vari colori.

ATTRIBUTI dispositivo

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

Esempi

Dispositivo che supporta l'effetto ciclo di colori.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo che supporta gli effetti di sospensione/riattivazione.

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

Stati del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento 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 di luce attualmente attivo.

{}

COMANDI del dispositivo

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

action.devices.commands.ColorLoop

Chiedi al dispositivo di scorrere una serie di colori.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parametri

Esempi

Colorloop my lights for 60 minutes. (Ciclo di colori per 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, se vuoi, regola la temperatura di colore per un determinato periodo di tempo.

{
  "supportedEffects": [
    "sleep"
  ]
}

Parametri

Esempi

Fai in modo che le mie luci si spengano 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, se vuoi, regola la temperatura di colore per un determinato periodo di tempo.

{
  "supportedEffects": [
    "wake"
  ]
}

Parametri

Esempi

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

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

Emulazione degli effetti luce

Se il tuo dispositivo implementa il tratto Brightness, ma non il tratto LightEffects, la piattaforma supporta gli effetti "sleep" e "wake" emulati, senza la necessità di codice aggiuntivo. La piattaforma emula gli effetti inviando una serie di intent EXECUTE.

Esempi di frasi

ERRORI del dispositivo