Schema del tratto Light Home di Smart Home

action.devices.traits.LightEffects: questa caratteristica appartiene ai dispositivi che supportano comandi di illuminazione complessi per cambiare stato, ad esempio in loop tra vari colori.

ATTRIBUTE dispositivo

I dispositivi con questo trattino potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta la sezione fulfillment di 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	Array	Obbligatorio. Elenco degli effetti supportati dal dispositivo.
[item, ...]	Stringa	Effetto supportato. Valori supportati: colorLoop Puoi scorrere vari colori in modo casuale. sleep Riduce gradualmente la luminosità e, facoltativamente, regola la temperatura di colore in un determinato periodo di tempo. wake Aumenta gradualmente la luminosità e, facoltativamente, regola la temperatura del colore in un determinato periodo di tempo.

Esempi

Dispositivo che supporta l'effetto loop di colori.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo che supporta gli effetti sonno/veglia.

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

STATO dispositivo

Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY, Per saperne di più sulla gestione degli intent QUERY, consulta la sezione fulfillment di intent.

Stati	Tipo	Descrizione
activeLightEffect	Stringa	Effetto luce attualmente attivo, se presente. Una tra supportedEffects. Valori supportati: colorLoop sleep wake
lightEffectEndUnixTimestampSec	Intero	Timestamp Unix quando è previsto che l'effetto termini da solo, se l'effetto termina da solo.

Esempi

Qual è l'effetto attuale sul mio dispositivo?

{
  "activeLightEffect": "colorLoop"
}

Qual è l'effetto attuale sul mio dispositivo?

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

Nessun effetto luce attualmente attivo.

{}

COMANDI dispositivo

I dispositivi con questo trattino potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta la sezione fulfillment di intent.

action.devices.commands.ColorLoop

Richiedere al dispositivo di scorrere una serie di colori.

Questo comando richiede i seguenti attributi:

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parametri

Parametri	Tipo	Descrizione
duration	Intero	Durata del comando del loop di colori, espressa in secondi.

Esempi

Applica colori alle 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 del 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 addormentare le luci per 60 minuti.

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

action.devices.commands.StopEffect

Interrompi l'effetto luce corrente.

Parametri

Parametri	Tipo	Descrizione
Nessuna proprietà

Esempi

Interrompi l'effetto sulla luce.

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

action.devices.commands.Wake

Aumenta gradualmente la luminosità del dispositivo e, se necessario, regola la temperatura del 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 attivazione, in secondi.

Esempi

Fai svegliare le mie luci per 60 minuti.

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

Emulazione effetti della luce

Se il tuo dispositivo implementa il tratto Brightness, ma non il tratto LightEffects, la piattaforma supporta gli effetti emulati "sleep" e "wake", senza dover aggiungere altro codice. 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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.