Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones de casa inteligente. Nota: Seguirás compilando acciones en la Consola de Actions.

Esquema de la función LightEffects de Smart Home

action.devices.traits.LightEffects: Esta característica pertenece a los dispositivos que admiten comandos de iluminación complejos para cambiar el estado, como la repetición indefinida 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 el manejo de 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 desplaza de forma aleatoria por diversos colores.
sleep
Disminuye 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 que admite el efecto de bucle de color.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivos que admiten efectos de activación y sueño.

{
  "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 el manejo de intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
activeLightEffect String

Efecto de luz actualmente activo si corresponde. Uno de supportedEffects.

Valores admitidos:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Número entero

Es la marca de tiempo de Unix cuando 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 COMMANDS

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 el manejo de 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

Uso de colores en mis luces por 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 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 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 del comando de activación, en segundos.

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