Esquema del rasgo Smart Home LightEffects

action.devices.traits.LightEffects: Este rasgo pertenece a los dispositivos que pueden admitir comandos de iluminación complejos para cambiar el estado, como recorrer varios colores.

Atributos del dispositivo

Los dispositivos con este rasgo pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents de SYNC, consulta Entrega de intents.

Ejemplos

Dispositivo que admite el efecto de bucle de color.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo que admite efectos de activación y suspensión.

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

ESTADOS del dispositivo

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

Ejemplos

¿Cuál es el efecto actual en mi dispositivo?

{
  "activeLightEffect": "colorLoop"
}

¿Cuál es el efecto actual en mi dispositivo?

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

No hay ningún efecto de luz activo en este momento.

{}

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents de EXECUTE, consulta Entrega de intents.

action.devices.commands.ColorLoop

Solicita al dispositivo que alterne entre un conjunto de colores.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parámetros

Ejemplos

Pon mis luces en bucle de color durante 60 minutos.

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

action.devices.commands.Sleep

Disminuye gradualmente el brillo del dispositivo y, de manera opcional, ajusta la temperatura de color durante un período.

{
  "supportedEffects": [
    "sleep"
  ]
}

Parámetros

Ejemplos

Atenúa las luces durante 60 minutos.

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

action.devices.commands.StopEffect

Detiene el efecto de luz actual.

Parámetros

Ejemplos

Detén el efecto en mi luz.

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

action.devices.commands.Wake

Aumenta gradualmente el brillo del dispositivo y, de manera opcional, ajusta la temperatura de color durante un período.

{
  "supportedEffects": [
    "wake"
  ]
}

Parámetros

Ejemplos

Haz que mis luces se enciendan durante 60 minutos.

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

Emulación de efectos de luz

Si tu dispositivo implementa el rasgo Brightness, pero no el rasgo LightEffects, la plataforma admite efectos emulados de "suspensión" y "activación", sin necesidad de código adicional. La plataforma emula los efectos enviando una serie de intents EXECUTE.

Expresiones de muestra

ERRORES del dispositivo