Schema dei tratti degli effetti di luce per la smart home

action.devices.traits.LightEffects. Questa caratteristica appartiene ai dispositivi in grado di supportare comandi di illuminazione complessi per cambiare stato, ad esempio riprodurre in loop vari colori.

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi Tipo Descrizione
defaultColorLoopDuration Intero

(Valore predefinito: 1800)

La durata predefinita, in secondi, dell'effetto attivato dal comando action.devices.commands.ColorLoop.

defaultSleepDuration Intero

(Valore predefinito: 1800)

La durata predefinita, in secondi, dell'effetto attivato dal comando action.devices.commands.Sleep.

defaultWakeDuration Intero

(Valore predefinito: 1800)

La durata predefinita, in secondi, dell'effetto attivato dal comando action.devices.commands.Wake.

supportedEffects Matrice

Obbligatorio.

Elenco degli effetti supportati dal dispositivo.

[item, ...] String

Effetto supportato.

Valori supportati:

colorLoop
Crea loop di vari colori in modo casuale.
sleep
Riduce gradualmente la luminosità e, facoltativamente, regola la temperatura di colore per un determinato periodo di tempo.
wake
Aumenta gradualmente la luminosità e, facoltativamente, regola la temperatura di colore per un determinato periodo di tempo.

Esempi

Dispositivo che supporta l'effetto loop di colori.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo che supporta gli effetti di sonno/veglia.

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

Dispositivo STATES

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

Stati Tipo Descrizione
activeLightEffect String

Effetto della luce attualmente attivo, se presente. Uno di supportedEffects.

Valori supportati:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Intero

Timestamp Unix del punto in cui è previsto il termine dell'effetto, se quest'ultimo termina automaticamente.

Esempi

Qual è l'effetto corrente sul mio dispositivo?

{
  "activeLightEffect": "colorLoop"
}

Qual è l'effetto corrente sul mio dispositivo?

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

Nessun effetto luce attualmente attivo.

{}

COMMANDS dispositivo

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

action.devices.commands.ColorLoop

Richiedi al dispositivo di scorrere tra una serie di colori.

Questo comando richiede i seguenti attributi:
{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parametri

Parametri Tipo Descrizione
duration Intero

Durata del comando color loop, in secondi.

Esempi

Esegui il colorloop delle 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.

Questo comando richiede i seguenti attributi:
{
  "supportedEffects": [
    "sleep"
  ]
}

Parametri

Parametri Tipo Descrizione
duration Intero

Durata del comando di sospensione, in secondi.

Esempi

Fai dormire le luci per 60 minuti.

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

action.devices.commands.StopEffect

Interrompi l'effetto di luce corrente.

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

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.

Questo comando richiede i seguenti attributi:
{
  "supportedEffects": [
    "wake"
  ]
}

Parametri

Parametri Tipo Descrizione
duration Intero

Durata del comando di riattivazione, in secondi.

Esempi

Fai in modo che le luci si attivino per 60 minuti.

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

Emulazione di effetti di luce

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

Espressioni di esempio

de-DE

  • Den Aufwacheffekt der Lampen starten.
  • Einschlafmodus im Schlafzimmer aktivieren.
  • synchronisiere meine Geräte

en-US

  • Begin the sleep effect on my lights .
  • I want you to start wake effect on the lights

es-ES

  • pon la luz de despertarse lentamente durante 45 minutos
  • pon las luces de dormir

fr-FR

  • Allume doucement les lumières .
  • Éteins progressivement les lumières .

hi-IN

  • बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
  • लाइट को स्लीप मोड में डाल दो

it-IT

  • Accendi le luci gradualmente
  • Avvia le luci per dormire

ja-JP

  • ライト を徐々に明るくなる設定にして
  • 照明 を少しずつ暗くして

ko-KR

  • 안방 전등 기상 모드 시작해
  • 조명 에서 수면 모드 실행

nl-NL

  • Dim de lichten langzaam.
  • Laat mijn lamp langzaam feller worden.

pt-BR

  • Acenda lentamente as luzes do quarto por 1 hora .
  • Ativa as luzes de despertar no quarto dos miudos .
  • Iniciar o modo dormir por 1 hora nas luzes do quarto .
  • Liga a função adormecer das luzes .

sv-SE

  • Starta insomningsläge på lamporna
  • Tänd lamporna långsamt

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.