Esquema de rasgo de brillo de una casa inteligente

action.devices.traits.Brightness: Esta característica abarca cómo controlar el brillo de un dispositivo.

ATRIBUTOS del dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents SYNC, consulta Cómo entregar intents.

Ejemplos

Dispositivo que admite comandos de brillo, consulta de estados y generación de informes.

{}

Dispositivo que solo admite comandos de brillo.

{
  "commandOnlyBrightness": true
}

ESTADOS DEL DISPOSITIVO

Las entidades con este atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

Ejemplos

¿Cuál es el nivel de brillo de la luz?

{
  "brightness": 65
}

COMANDOS del dispositivo

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents EXECUTE, consulta Cómo entregar intents.

action.devices.commands.BrightnessAbsolute

Ajusta el brillo absoluto del dispositivo.

Parámetros

Ejemplos

Ajusta mi luz al 65% de brillo.

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

action.devices.commands.BrightnessRelative

Ajusta el brillo relativo del dispositivo.

{
  "commandOnlyBrightness": true
}

Parámetros

La carga útil contiene uno de los siguientes elementos:

Es el ajuste relativo porcentual.

Ajuste relativo del peso.

Ejemplos

Sube el brillo de la luz un 20%.

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

Atenúa la luz un poco.

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

Expresiones de muestra

ERRORES del dispositivo