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: 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 |
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 } }