Esquema de la función SmartEffects de Home Home

action.devices.traits.LightEffects: Esta característica pertenece a los dispositivos que admiten comandos de iluminación complejos para cambiar el estado, como repetir indefinidamente 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 manejar 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 que activa el comando action.devices.commands.ColorLoop.
defaultSleepDuration	Número entero	(Predeterminado: 1800) Es la duración predeterminada, en segundos, del efecto que activa el comando action.devices.commands.Sleep.
defaultWakeDuration	Número entero	(Predeterminado: 1800) Es la duración predeterminada, en segundos, del efecto que activa el comando action.devices.commands.Wake.
supportedEffects	Matriz	Obligatorio. Lista de los efectos que admite el dispositivo.
[item, ...]	String	Efecto admitido Valores admitidos: colorLoop Se desplazan a lo largo de varios colores de forma aleatoria. sleep Disminuye el brillo de forma gradual y, de forma 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

Efecto de bucle de colores compatible con el dispositivo.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo que admite efectos de suspensión/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 manejar los intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
activeLightEffect	String	Efecto de luz activo actualmente (si lo hay). supportedEffects. Valores admitidos: colorLoop sleep wake
lightEffectEndUnixTimestampSec	Número entero	Es una marca de tiempo Unix en la que se espera que finalice el efecto, si este finaliza por su cuenta.

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.

{}

Dispositivo COMMAND

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

action.devices.commands.ColorLoop

Solicita al dispositivo que 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 color, en segundos.

Ejemplos

Colorear mis luces en bucle 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 de tiempo.

Este comando requiere los siguientes atributos:

{
  "supportedEffects": [
    "sleep"
  ]
}

Parámetros

Parámetros	Tipo	Descripción
duration	Número entero	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 de 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 de tiempo.

Este comando requiere los siguientes atributos:

{
  "supportedEffects": [
    "wake"
  ]
}

Parámetros

Parámetros	Tipo	Descripción
duration	Número entero	Duración en segundos del comando de activación.

Ejemplos

Hacer 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 "sleep" y "wake", sin necesidad de código adicional. La plataforma emula los efectos mediante el envío de 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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.