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