Esquema de traço Smart Home LightEffects

action.devices.traits.LightEffects: esse traço 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

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 Lógica de fulfillment de intents.

Exemplos

Dispositivo compatível com o efeito de ciclo de cores.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Dispositivo compatível com efeitos de suspensão/ativação.

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

ESTADOS DO DISPOSITIVO

Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre como processar intents QUERY, consulte Lógica de 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 seguintes comandos como parte da operação EXECUTE. Para saber mais sobre como processar intents EXECUTE, consulte Lógica de fulfillment de intents.

action.devices.commands.ColorLoop

Solicita que o dispositivo passe por um conjunto de cores.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parâmetros

Exemplos

Mude as cores das 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

Deixe minhas luzes em modo de espera por 60 minutos.

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

action.devices.commands.StopEffect

Parar o efeito de luz atual.

Parâmetros

Exemplos

Pare 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

Acenda minhas luzes 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 "despertar", 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