Esta é a Central do desenvolvedor do Google Home, a nova plataforma para aprender a desenvolver ações de casa inteligente. Observação: você continua criando ações no Console do Actions.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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.