Esquema do traço 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 ver mais informações.
Por exemplo, se um dispositivo permite 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 aos usuários com uma simples gramática de ativação:
- Iniciar o Modo balada.
- Ativar o cenário noturno.
Como objetos virtuais, as cenas podem ser colocadas em salas (se relevantes) para fins de desambiguação:
- Comece a festa na cozinha.
- Ativar 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 festa" em dois parceiros diferentes, um para segurança e outro para iluminação, Ativar modo festa acionará ambos.
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 atributos a seguir como parte da operação SYNC
. Para saber
mais sobre como gerenciar 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 do estado anterior. O dispositivo oferece suporte ao comando |
Exemplos
Dispositivo compatível com uma cena reversível.
{ "sceneReversible": true }
STATES do dispositivo
Nenhum.
COMANDOS do dispositivo
Dispositivos com essa característica podem responder aos comandos
a seguir como parte da operação EXECUTE
. Para saber
mais sobre como gerenciar intents EXECUTE
, consulte
Fulfillment de intents.
action.devices.commands.ActivateScene
Ativa ou desativa uma cena.
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
deactivate |
Booleano |
Obrigatório. Verdadeiro para cancelar uma cena se for reversível ou falso para ativar uma cena. |
Exemplos
Ative um cenário pelo nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Desativar um cenário por nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }