Esquema de atributos LightEffects de la casa inteligente

action.devices.traits.LightEffects: Este atributo pertenece a dispositivos que pueden admitir comandos de iluminación complejos para cambiar de estado, como un bucle de varios colores.

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.

Atributos Tipo Descripción
defaultColorLoopDuration Número entero

(Predeterminado: 1800)

Es la duración predeterminada, en segundos, del efecto activado por el comando action.devices.commands.ColorLoop.
defaultSleepDuration Número entero

(Predeterminado: 1800)

Es la duración predeterminada, en segundos, del efecto activado por el comando action.devices.commands.Sleep.
defaultWakeDuration Número entero

(Predeterminado: 1800)

Es la duración predeterminada, en segundos, del efecto activado por el comando action.devices.commands.Wake.
supportedEffects Matriz

Obligatorio.

Es una lista de los efectos que admite el dispositivo.
[item, ...] String

Efecto compatible.

Valores admitidos:

colorLoop
Hace un bucle de varios colores de forma aleatoria.
sleep
Reduce el brillo de forma gradual y, de manera opcional, ajusta la temperatura de color durante un período.
wake
Aumenta gradualmente el brillo y, de manera opcional, ajusta la temperatura de color durante un período.

Ejemplos

Dispositivo compatible con el efecto de bucle de colores.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo que admita efectos de activación y desactivación.

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

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 los intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
activeLightEffect String

Es el efecto de luz activo actualmente, si corresponde. Es uno de los siguientes: supportedEffects.

Valores admitidos:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Número entero

Es una marca de tiempo Unix del momento en que se espera que termine el efecto, si el efecto termina por sí solo.

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 efectos de luz activos en este momento.

{}

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.ColorLoop

Solicita al dispositivo que cambie entre un conjunto de colores.

Este comando requiere los siguientes atributos: 
{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parámetros

Parámetros Tipo Descripción
duration Número entero

Duración del comando de bucle de colores, en segundos.

Ejemplos

Hacer que mis luces cambien de color durante 60 minutos

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

action.devices.commands.Sleep

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

Este comando requiere los siguientes atributos: 
{
  "supportedEffects": [
    "sleep"
  ]
}

Parámetros

Parámetros Tipo Descripción
duration Número entero

Es la duración del comando de suspensión, en segundos.

Ejemplos

Establece mis luces en modo de suspensión durante 60 minutos.

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

action.devices.commands.StopEffect

Detén el efecto de luz actual.

Parámetros

Parámetros Tipo Descripción

Sin propiedades

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.

Este comando requiere los siguientes atributos: 
{
  "supportedEffects": [
    "wake"
  ]
}

Parámetros

Parámetros Tipo Descripción
duration Número entero

Es la duración del comando de activación, en segundos.

Ejemplos

Aclara las luces durante 60 minutos.

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

Emulación de efectos de luz

Si tu dispositivo implementa el atributo Brightness, pero no el atributo LightEffects, la plataforma admite efectos de "activación" y "inactividad" emulados, sin necesidad de código adicional. Para emular los efectos, la plataforma envía una serie de intents EXECUTE.

Expresiones de muestra

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

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.