Esquema de características de casas inteligentes

action.devices.traits.Scene: essa 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 para cores específicas ou sequenciando vários recursos de segurança, ou qualquer outra combinação de atividades, essa configuração pode ser exposta pelo SYNC como uma cena nomeada. O Google Assistente vai disponibilizar essas cenas para os usuários usando uma gramática de ativação simples:

• Iniciar Modo balada.
• Ative a 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 vai aplicar automaticamente efeitos plural aos comandos do Scene, permitindo que os usuários acionem cenas em vários parceiros. Por exemplo, se um usuário tiver uma cena de "modo festa" em dois parceiros diferentes, uma para a segurança e outra para as luzes, o recurso Ativar modo de festa será acionado.

Os cenários vão interagir bem com as próximas ações personalizadas para gramática personalizada, por exemplo, Ativar o Modo balada -> Vamos começar a festa!.

Os cenários precisam sempre ter nomes fornecidos pelo usuário em vez do nome "BobCo Scene" padrão. Cada cena é um dispositivo virtual e tem os próprios nomes. 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 como processar 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 lembram do estado anterior. O dispositivo é compatível com o comando ActivateScene com o parâmetro deactivate como verdadeiro.

Exemplos

Dispositivo compatível com uma cena reversível.

{
  "sceneReversible": true
}

STATES do dispositivo

Nenhuma.

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.ActivateScene

Ative ou desative uma cena.

Parâmetros

Parâmetros	Tipo	Descrição
deactivate	Booleano	Obrigatório. Verdadeiro para cancelar uma cena se ela for reversível, ou Falso para ativar uma cena.

Exemplos

Ative uma cena por nome.

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

Desativar um cenário por nome.

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

Dispositivo ERRORS

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