Esquema de atributo LightEffects 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 a repetição de 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 processamento de intents SYNC, consulte Fulfillment de intents.

Exemplos

Dispositivo com suporte ao efeito de loop de cor.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo com suporte a 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 operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment 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 está ativo no momento.

{}

COMANDOS do dispositivo

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

action.devices.commands.ColorLoop

Peça para o dispositivo alternar entre um conjunto de cores.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parâmetros

Exemplos

Colorloop 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 por um período.

{
  "supportedEffects": [
    "sleep"
  ]
}

Parâmetros

Exemplos

Deixar minhas luzes em suspensão por 60 minutos.

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

action.devices.commands.StopEffect

Parar o efeito de luz atual.

Parâmetros

Exemplos

Parar o efeito na minha luz.

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

action.devices.commands.Wake

Aumentar gradualmente o brilho do dispositivo e, opcionalmente, ajustar a temperatura da cor por um período.

{
  "supportedEffects": [
    "wake"
  ]
}

Parâmetros

Exemplos

Acender minhas luzes por 60 minutos.

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

Emulação de efeitos de luz

Se o dispositivo implementar o recurso Brightness, mas não o LightEffects, a plataforma vai oferecer suporte a efeitos de "suspensão" e "ativação" emulados, 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