Esquema de atributo LightEffects da casa inteligente

action.devices.traits.LightEffects: essa característica pertence a dispositivos que oferecem suporte a comandos de iluminação complexos para mudar de estado, como alternar entre 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 como processar 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

Solicite que o dispositivo alterne entre as cores.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parâmetros

Exemplos

Fazer um loop de luz com 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 da cor durante 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 atributo 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 no dispositivo