Esquema de características de casas inteligentes efeitos de casa

action.devices.traits.LightEffects: essa característica pertence a dispositivos compatíveis com comandos complexos de iluminação 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 fulfillment de intent.

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 de efeitos compatíveis com o dispositivo.
[item, ...]	String	Efeito compatível. Os valores suportados são: colorLoop Repetições de cores aleatórias. sleep Reduz gradualmente o brilho e, se quiser, ajusta a temperatura da cor ao longo de um período. wake aumenta gradualmente o brilho e, se quiser, ajusta a temperatura da cor ao longo de um período;

Exemplos

O dispositivo oferece suporte ao efeito de loop de cores.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

O dispositivo oferece suporte a efeitos de sono e despertar.

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

STATES do dispositivo

Entidades com essa característica podem relatar os estados a seguir como parte da operação QUERY. Para saber mais sobre como processar intents QUERY, consulte fulfillment de intent.

Estados	Tipo	Descrição
activeLightEffect	String	Efeito de luz ativo, se houver. Um dentre supportedEffects. Os valores suportados são: colorLoop sleep wake
lightEffectEndUnixTimestampSec	Número inteiro	Carimbo de data/hora Unix quando o efeito for esperado, se o efeito terminar 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 como processar intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.ColorLoop

Solicite ao dispositivo um ciclo 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 o loop de luzes com as cores durante 60 minutos.

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

action.devices.commands.Sleep

Reduza gradualmente o brilho do dispositivo e, se quiser, ajuste a temperatura da cor 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 sleep, em segundos.

Exemplos

Fazer minhas luzes ficarem suspensas 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

Pare o efeito na minha luz.

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

action.devices.commands.Wake

Aumente gradualmente o brilho do dispositivo e, se quiser, ajuste a temperatura da cor 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 wake, em segundos.

Exemplos

Fazer minhas luzes despertar por 60 minutos

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

Emulação de efeitos de luz

Se o dispositivo implementa a característica Brightness, mas não a LightEffects, a plataforma oferece suporte a efeitos de "suspensão" e "viagem" emulados, sem necessidade de código adicional. 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

Dispositivo ERRORS

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