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 dell'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 dell'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 dell'intent.

action.devices.commands.ColorLoop

Chiedi al dispositivo di scorrere una serie di colori.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parametri

Esempi

Colorloop my lights for 60 minutes. (Cicla i colori delle 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

Avvia le luci per dormire 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 accendano 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 espressioni

ERRORI del dispositivo