Esquema de rasgo de efectos de luz de casa inteligente

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

ATRIBUTOS DISPOSITIVOS

Los dispositivos con este trait pueden informar lo siguiente atributos como parte de la operación SYNC. Para aprender 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.

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

Efecto admitido.

Valores admitidos:

colorLoop
Repite diferentes 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 el brillo de forma gradual 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 admite efectos de sueño/activación.

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

Dispositivo STATES

Las entidades con esta característica pueden informar lo siguiente estados como parte de la operación QUERY. Para aprender 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 actualmente activo, si corresponde Es uno de 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
}

En este momento, no hay ningún efecto de luz activo.

{}

COMANDOS del dispositivo

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

action.devices.commands.ColorLoop

Solicita que el dispositivo recorra 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

Realiza un bucle de colores en mis luces 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 en un período determinado.

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

Parámetros

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

Duración del comando Sleep, 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

Detener el efecto de luz actual

Parámetros

Parámetros Tipo Descripción

Sin propiedades

Ejemplos

Detén el efecto de la lámpara.

{
  "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 en un período determinado.

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

Parámetros

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

Duración del comando de activación, en segundos.

Ejemplos

Hacer que las luces se activen por 60 minutos

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

Emulación de efectos de luz

Si tu dispositivo implementa las Brightness, pero no la LightEffects, la La plataforma admite la emulación de suspensión y "wake" de la imagen, sin la 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 DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.