Esquema de características de efeitos de luz da casa inteligente

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

Atributos do dispositivo

Os dispositivos com essa característica podem informar os seguintes atributos como parte da SYNC operação. Para saber mais sobre como processar SYNC intents, consulte Processamento de intents.

Exemplos

Dispositivo com suporte ao efeito de loop de cores.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo com suporte aos efeitos de suspensão/ativação.

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

Estados do dispositivo

As entidades com essa característica podem informar os seguintes estados como parte da QUERY operação. Para saber mais sobre como processar QUERY intents, consulte Processamento de intents.

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

Os dispositivos com essa característica podem responder aos seguintes comandos como parte da EXECUTE operação. Para saber mais sobre como processar EXECUTE intents, consulte Processamento de intents.

action.devices.commands.ColorLoop

Solicita que o dispositivo alterne um conjunto de cores.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parâmetros

Exemplos

Faça um loop de cores nas minhas luzes por 60 minutos.

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

action.devices.commands.Sleep

Diminui gradualmente o brilho do dispositivo e, opcionalmente, ajusta a temperatura da cor durante um período.

{
  "supportedEffects": [
    "sleep"
  ]
}

Parâmetros

Exemplos

Faça minhas luzes dormirem por 60 minutos.

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

action.devices.commands.StopEffect

Interrompe o efeito de luz atual.

Parâmetros

Exemplos

Interrompa o efeito na minha luz.

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

action.devices.commands.Wake

Aumenta gradualmente o brilho do dispositivo e, opcionalmente, ajusta a temperatura da cor durante um período.

{
  "supportedEffects": [
    "wake"
  ]
}

Parâmetros

Exemplos

Faça minhas luzes acordarem 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 vai oferecer suporte a efeitos emulados de "suspensão" e "ativação", sem a necessidade de código adicional. A plataforma emula os efeitos enviando uma série de intents EXECUTE.

Exemplos de declarações

Erros do dispositivo