Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per scoprire come sviluppare azioni per la smart home. Nota: continuerai a creare azioni nella console di Actions.

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.