Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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

Los dispositivos 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.