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: A duração padrão, em segundos, para o efeito acionado pelo comando |
defaultSleepDuration |
Número inteiro |
Padrão: A duração padrão, em segundos, para o efeito acionado pelo comando |
defaultWakeDuration |
Número inteiro |
Padrão: A duração padrão, em segundos, para o efeito acionado pelo comando |
supportedEffects |
Array |
Obrigatório. Lista de efeitos compatíveis com o dispositivo. |
[item, ...] |
String |
Efeito compatível. Os valores suportados são:
|
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 Os valores suportados são:
|
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 noquarto dos miudos . -
Iniciar o modo dormir
por 1 hora nasluzes do quarto . -
Liga a função adormecer das
luzes .
sv-SE
-
Starta insomningsläge på
lamporna -
Tänd
lamporna långsamt