Esquema de rasgos de LightEffects para casas inteligentes

action.devices.traits.LightEffects: Esta característica pertenece a dispositivos que pueden admitir comandos de iluminación complejos para cambiar el estado, como repetir indefinidamente varios colores.

Dispositivo ATTRIBUTES

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

Lista de efectos que admite el dispositivo.
[item, ...] String

Efecto compatible.

Valores admitidos:

colorLoop
Repite el bucle a través de varios colores de forma aleatoria.
sleep
Disminuye gradualmente el brillo y, de forma opcional, ajusta la temperatura de color durante un período determinado.
wake
Aumenta el brillo de forma gradual y, de forma opcional, ajusta la temperatura de color durante un período determinado.

Ejemplos

Dispositivo compatible con efecto de bucle de color.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo compatible con efectos de sueño y activación.

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

Dispositivo STATES

Las entidades con esta característica 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

Efecto de luz activo actualmente, si corresponde. Es uno de supportedEffects.

Valores admitidos:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Número entero

Marca de tiempo Unix en la que se espera que el efecto termine, 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 ningún efecto de luz activo 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 los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.ColorLoop

Solicita al dispositivo que navegue por un conjunto de colores.

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

Parámetros

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

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

Ejemplos

Realiza un bucle de colores en las luces 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 cierto 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

Hacer que las luces se suspendan 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 la 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 cierto 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

Haz que las luces se activen durante 60 minutos.

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

Emulación de efectos de luz

Si tu dispositivo implementa la característica Brightness, pero no la característica LightEffects, la plataforma admite los 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

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

ERRORS de dispositivos

Consulta la lista completa de errores y excepciones.