Esquema de traços da Smart Home Scene
action.devices.traits.Scene
: esta 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 com 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 chamada, e o Google Assistente vai disponibilizar essas
cenas para os usuários com uma gramática de ativação simples:
- Iniciar modo balada.
- Ativar cena à 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 aplicará automaticamente efeitos no plural aos comandos do Scene, permitindo que os usuários acionem as 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, o recurso Ativar modo balada vai acionar os dois.
As cenas vão interagir bem com as próximas ações pessoais para gramática personalizada. Por exemplo, Ativar o Modo balada, Vamos começar a festa.
As cenas sempre precisam ter nomes fornecidos pelo usuário, em vez de nomes "BobCo Scene"
padrão. Cada cena é um dispositivo virtual e tem um nome.
Os nomes fornecidos pelo usuário podem ser do SYNC
.
ATRIBUTOS do dispositivo
Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC
. Para saber
mais sobre como lidar com 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 se lembram do estado anterior. O dispositivo é compatível com o comando |
Exemplos
Dispositivo que suporta uma cena reversível.
{ "sceneReversible": true }
STATES do dispositivo
Nenhuma.
Dispositivo COMMANDS
Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE
. Para saber
mais sobre como lidar com 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 for reversível, falso para ativar uma cena. |
Exemplos
Ative uma cena pelo nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Desative uma cena pelo nome.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }