Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Schema della luminosità della smart home

action.devices.traits.Brightness: questa caratteristica spiega come controllare la luminosità di un dispositivo.

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi Tipo Descrizione
commandOnlyBrightness Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica.

Esempi

Dispositivo che supporta i comandi di luminosità, indica la query e i report.

{}

Dispositivo che supporta solo i comandi di luminosità.

{
  "commandOnlyBrightness": true
}

STATEs dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Soddisfazione degli intent.

Stati Tipo Descrizione
brightness Intero

Livello di luminosità corrente del dispositivo.

Esempi

Qual è il livello di luminosità della luce?

{
  "brightness": 65
}

comandi del dispositivo

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

action.devices.commands.BrightnessAbsolute

Regola la luminosità assoluta del dispositivo.

Parametri

Parametri Tipo Descrizione
brightness Intero

Obbligatorio.

Nuova percentuale di luminosità assoluta.

Esempi

Regola la luce al 65% di luminosità.

{
  "command": "action.devices.commands.BrightnessAbsolute",
  "params": {
    "brightness": 65
  }
}

action.devices.commands.BrightnessRelative

Regola la luminosità relativa del dispositivo.

Questo comando richiede i seguenti attributi:
{
  "commandOnlyBrightness": true
}

Parametri

Il payload contiene uno dei seguenti valori:

Aggiustamento relativo percentuale.

Parametri Tipo Descrizione
brightnessRelativePercent Intero

Obbligatorio.

La percentuale esatta di luminosità da modificare.

Aggiustamento relativo della ponderazione.

Parametri Tipo Descrizione
brightnessRelativeWeight Intero

Obbligatorio.

Indica la quantità ambigua della variazione della luminosità. Da piccole a grandi, questo parametro verrà ridimensionato a numeri interi da 0 a 5, con il segno che indica la direzione.

Esempi

Aumenta l'intensità della luce del 20%.

{
  "command": "action.devices.commands.BrightnessRelative",
  "params": {
    "brightnessRelativePercent": 20
  }
}

Abbassa un po' la luce.

{
  "command": "action.devices.commands.BrightnessRelative",
  "params": {
    "brightnessRelativeWeight": -1
  }
}

Esempi di frasi

de-DE

  • Bitte mach das Licht ein bisschen dunkler
  • Bitte stell das Flurlicht auf ein Drittel
  • Die Küche ein wenig heller stellen
  • Erhöhe die Helligkeit
  • Erhöhe die Helligkeit um 20%
  • Helligkeit der Leselampe auf 5 %
  • Helligkeit im Wohnzimmer auf 10% starn
  • Mach das Licht bitte 20% Dunkler
  • Mach das Licht bitte 20% heller
  • Mach das Licht sehr dillo
  • Mach das Schlafzimmer ein bisschen dunkler
  • Mach das Wohnzimmer dunkler
  • Stell das Licht auf 50 % ein.
  • Stelle das Licht bitte auf maximale Helligkeit
  • Stelle die Beleuchtung heller
  • Verringere die Helligkeit der Beleuchtung
  • Verringere die Helligkeit in der Küche um 20%

en-US

  • aumenta la luce con 10%
  • aumenta le luci del 20%
  • aumenta la luminosità la cucina leggermente
  • aumenta la luminosità la cucina per 50
  • aumenta le luci in alto
  • abbassa la luminosità le luci
  • abbassa la luce un po' ancora
  • abbassa la luce del 20%
  • aumenta la luminosità in salotto del 100%
  • rendelo più scuro in salotto
  • rendi più luminosa la camera
  • rendi le luci un po' più luminose più luminose
  • del salotto in più dimmer
  • riduci la luminosità in del salotto del 50%
  • imposta la luce su massimo
  • accendi la luminosità luce al massimo

es-ES

  • pon las luces a la mitad

fr-FR

  • Incontri la lumière sur 20% .
  • Règle la luminositàté du salon au massimo .
  • allume la lampada à 20 % riduzione luminosità
  • allume la lumière du salon au massimo
  • assombris la cucina de 20%
  • aumentae l'éclairage de 20%
  • aumenta l'éclairage de la kitchen
  • aumenta la luminosità de 10% dans le salon
  • aumenta la luminosità de la chambre
  • aumentae un peu l'éclairage
  • aumentae un peu la luminositàté de la chambre
  • baisse les lumière
  • baisse les lumières de 20%
  • baisse un peu la lumière du salon
  • luminositàté de la chambre à 20 %
  • moins de luminositàté dans parrucchiere

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.