Esta é a Central do desenvolvedor do Google Home, o novo destino para aprender a desenvolver ações de casa inteligente. Observação:você continuará criando ações no Console do Actions.

Esquema de traços da Smart Home Scene

action.devices.traits.Scene: esta característica é usada para implementar dispositivos virtuais junto com o tipo de dispositivo Scene.

Consulte o Guia de tipo de cena para mais informações.

Por exemplo, se um dispositivo permitir que os usuários configurem um agrupamento de comandos com um toque, definindo luzes com cores específicas ou sequenciando vários recursos de segurança, ou qualquer outra combinação de atividades, essa configuração poderá ser exposta pelo SYNC como uma cena chamada, e o Google Assistente vai disponibilizar essas cenas para os usuários com uma gramática de ativação simples:

  • Iniciar modo balada.
  • Ativar cena à meia-noite.

Como objetos virtuais, as cenas podem ser colocadas em salas (se relevante) para desambiguação:

  • Comece a festa na cozinha.
  • Ative o Modo noturno nos quartos.

Uma diferença entre cenas e alvos físicos é que o Google Assistente aplicará automaticamente efeitos no plural aos comandos do Scene, permitindo que os usuários acionem as cenas em vários parceiros. Por exemplo, se um usuário tiver uma cena "modo festa" em dois parceiros diferentes, um para segurança e outro para iluminação, o recurso Ativar modo balada vai acionar os dois.

As cenas vão interagir bem com as próximas ações pessoais para gramática personalizada. Por exemplo, Ativar o Modo balada, Vamos começar a festa.

As cenas sempre precisam ter nomes fornecidos pelo usuário, em vez de nomes "BobCo Scene" padrão. Cada cena é um dispositivo virtual e tem um nome. Os nomes fornecidos pelo usuário podem ser do SYNC.

ATRIBUTOS do dispositivo

Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte fulfillment de intent.

Atributos Tipo Descrição
sceneReversible Booleano

Padrão: false.

Indica que esta cena pode ser cancelada. Esse atributo só é relevante para cenas que modificam o estado e se lembram do estado anterior. O dispositivo é compatível com o comando ActivateScene com o parâmetro deactivate como "true".

Exemplos

Dispositivo que suporta uma cena reversível.

{
  "sceneReversible": true
}

STATES do dispositivo

Nenhuma.

Dispositivo COMMANDS

Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.ActivateScene

Ative ou desative uma cena.

Parâmetros

Parâmetros Tipo Descrição
deactivate Booleano

Obrigatório.

Verdadeiro para cancelar uma cena se for reversível, falso para ativar uma cena.

Exemplos

Ative uma cena pelo nome.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Desative uma cena pelo nome.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

Dispositivo ERRORS

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