Esquema de atributo de cena da casa inteligente

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

Consulte o guia de tipos de cena para mais informações.

Por exemplo, se um dispositivo permitir que os usuários configurem o agrupamento de comandos com um toque, definindo luzes para 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 com nome, e o Google Assistente vai disponibilizar essas cenas para os usuários com uma gramática de ativação simples:

  • Inicie o Modo balada.
  • Ativar a cena de meia-noite.

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

  • Comece a festinha na cozinha.
  • Ative o modo noturno nos quartos.

Uma diferença entre as cenas e os alvos físicos é que o Google Assistente aplica automaticamente efeitos plurais aos comandos de cena, permitindo que os usuários ativem 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 luzes, Ativar o modo festa acionará ambos.

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

As cenas sempre precisam ter nomes fornecidos pelo usuário, em vez da nomenclatura padrão "BobCo Scene". Cada cena é um dispositivo virtual com o próprio nome. Os nomes fornecidos pelo usuário podem vir de SYNC.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o processamento de intents SYNC, consulte Fulfillment de intents.

Atributos Tipo Descrição
sceneReversible Booleano

Padrão: false.

Indica que esta cena pode ser cancelada. Esse atributo é relevante apenas para cenas que modificam o estado e lembram o estado anterior. O dispositivo oferece suporte ao comando ActivateScene com o parâmetro deactivate definido como verdadeiro.

Exemplos

Dispositivo compatível com uma cena reversível.

{
  "sceneReversible": true
}

ESTADOS DO DISPOSITIVO

Nenhum.

COMANDOS DO dispositivo

Dispositivos com essa característica podem responder aos comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte Fulfillment de intents.

action.devices.commands.ActivateScene

Ativar ou desativar uma cena.

Parâmetros

Parâmetros Tipo Descrição
deactivate Booleano

Obrigatório.

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

Exemplos

Ativar uma cena por nome.

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

Desativar uma cena por nome.

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

ERROS no dispositivo

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