Esquema de traçado de cena da casa inteligente
action.devices.traits.Scene
: essa característica é usada para implementar dispositivos virtuais junto com o tipo de dispositivo CENE.
Consulte o Guia de tipo 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 pode
ser exposta por SYNC
como uma cena nomeada, e o Google Assistente disponibiliza essas
cenas para os usuários com uma simples gramática de ativação:
- Iniciar Modo balada.
- Ative o cenário à 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 plurais aos comandos de cena, permitindo que os usuários acionem cenas em vários parceiros. Por exemplo, se um usuário tiver uma cena "modo balada" em dois parceiros diferentes, um para segurança e outro para luzes, a opção Ativar modo balada vai acionar as duas.
Os cenários vão interagir bem com as próximas ações pessoais para gramática personalizada. Por exemplo, Ative o Modo balada -> Vamos começar a festa!.
Os cenários precisam sempre ter nomes fornecidos pelo usuário, em vez da nomenclatura
padrão "BobCo Scene". Cada cena é um dispositivo virtual próprio, com nomes próprios.
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 gerenciamento de intents SYNC
, consulte
fulfillment de intents.
Atributos | Tipo | Descrição |
---|---|---|
sceneReversible |
Booleano |
Padrão: Indica que este cenário pode ser cancelado. Esse atributo só é relevante para cenas que modificam o estado e lembram o 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 o gerenciamento de intents EXECUTE
, consulte
fulfillment de intents.
action.devices.commands.ActivateScene
Ative ou desative uma cena.
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
deactivate |
Booleano |
Obrigatório. "Verdadeiro" para cancelar um cenário se for reversível ou "Falso" para ativar uma cena. |
Exemplos
Ative um cenário por nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Desative um cenário por nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }