Esquema de traço LightEffects para casa inteligente

action.devices.traits.LightEffects: essa característica pertence a dispositivos que oferecem suporte a comandos complexos de iluminação para mudar de estado, como o loop em várias cores.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o gerenciamento de intents SYNC, consulte fulfillment de intents.

Atributos Tipo Descrição
defaultColorLoopDuration Número inteiro

Padrão: 1800.

A duração padrão, em segundos, para o efeito acionado pelo comando action.devices.commands.ColorLoop.

defaultSleepDuration Número inteiro

Padrão: 1800.

A duração padrão, em segundos, para o efeito acionado pelo comando action.devices.commands.Sleep.

defaultWakeDuration Número inteiro

Padrão: 1800.

A duração padrão, em segundos, para o efeito acionado pelo comando action.devices.commands.Wake.

supportedEffects Array

Obrigatório.

Lista dos efeitos compatíveis com o dispositivo.

[item, ...] String

Efeito compatível.

Os valores suportados são:

colorLoop
Repete várias cores aleatoriamente.
sleep
Diminui gradualmente o brilho e, opcionalmente, ajusta a temperatura das cores ao longo de um período.
wake
Aumenta gradualmente o brilho e, opcionalmente, ajusta a temperatura das cores durante um período.

Exemplos

Efeito do loop de cores do dispositivo compatível.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo compatível com efeitos de sono/vigília.

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

STATES do dispositivo

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o gerenciamento de intents QUERY, consulte fulfillment de intents.

Estados Tipo Descrição
activeLightEffect String

Efeito de luz ativo, se houver. Uma destas: supportedEffects.

Os valores suportados são:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Número inteiro

Carimbo de data/hora Unix do momento em que se espera que o efeito termine por conta própria.

Exemplos

Qual é o efeito atual no meu dispositivo?

{
  "activeLightEffect": "colorLoop"
}

Qual é o efeito atual no meu dispositivo?

{
  "activeLightEffect": "sleep",
  "lightEffectEndUnixTimestampSec": 1595286869
}

Nenhum efeito de luz ativo no momento.

{}

Comandos do dispositivo

Dispositivos com essa característica podem responder aos seguintes comandos como parte da operação EXECUTE. Para saber mais sobre o gerenciamento de intents EXECUTE, consulte fulfillment de intents.

action.devices.commands.ColorLoop

Solicitar que o dispositivo alterne entre um conjunto de cores.

Esse comando requer os seguintes atributos:
{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parâmetros

Parâmetros Tipo Descrição
duration Número inteiro

Duração do comando de loop de cores, em segundos.

Exemplos

Fazer loop de cores para minhas luzes por 60 minutos.

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

action.devices.commands.Sleep

Reduza gradualmente o brilho do dispositivo e, opcionalmente, ajusta a temperatura das cores ao longo de um período.

Esse comando requer os seguintes atributos:
{
  "supportedEffects": [
    "sleep"
  ]
}

Parâmetros

Parâmetros Tipo Descrição
duration Número inteiro

Duração do comando de suspensão, em segundos.

Exemplos

Coloque minhas luzes em suspensão por 60 minutos.

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

action.devices.commands.StopEffect

Interrompe o efeito de luz atual.

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Parar o efeito na minha luz.

{
  "command": "action.devices.commands.StopEffect",
  "params": {}
}

action.devices.commands.Wake

Aumente gradualmente o brilho do dispositivo e, opcionalmente, ajuste a temperatura das cores ao longo de um período.

Esse comando requer os seguintes atributos:
{
  "supportedEffects": [
    "wake"
  ]
}

Parâmetros

Parâmetros Tipo Descrição
duration Número inteiro

Duração do comando de ativação, em segundos.

Exemplos

Fazer minhas luzes despertarem por 60 minutos.

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

Emulação de efeitos de luz

Se o dispositivo implementar a característica Brightness, mas não a LightEffects, a plataforma oferece suporte a efeitos emulados de "suspensão" e "ativação", sem a necessidade de outro código. A plataforma emula os efeitos enviando uma série de intents EXECUTE.

Exemplos de declarações

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

ERROS DO Dispositivo

Veja a lista completa de erros e exceções.