Schema dell'attributo Luminosità per la smart home

action.devices.traits.Brightness: questa trait riguarda come controllare la luminosità di un dispositivo.

ATTRIBUTI del dispositivo

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

Esempi

Dispositivo che supporta i comandi di luminosità, le query sugli stati e la generazione di report.

{}

Dispositivo che supporta solo i comandi di luminosità.

{
  "commandOnlyBrightness": true
}

STATI del dispositivo

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

Esempi

Qual è il livello di luminosità della mia luce?

{
  "brightness": 65
}

COMANDI 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 Adempimento degli intent.

action.devices.commands.BrightnessAbsolute

Regola la luminosità assoluta del dispositivo.

Parametri

Esempi

Regola la luminosità della mia luce al 65%.

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

action.devices.commands.BrightnessRelative

Regola la luminosità relativa del dispositivo.

{
  "commandOnlyBrightness": true
}

Parametri

Il payload contiene uno dei seguenti elementi:

Aggiustamento percentuale relativo.

Regolazione relativa al peso.

Esempi

Aumenta l'intensità della mia luce del 20%.

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

Abbassa un po' la luce.

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

Frasi di esempio

ERRORI del dispositivo