Esquema de traços de cena de casa inteligente
action.devices.traits.Scene: essa característica é usada para implementar dispositivos virtuais com o tipo de dispositivo CENE.
Consulte o Guia de tipos de cena para mais informações.
Por exemplo, se um dispositivo permitir que os usuários configurem o agrupamento com um toque de
definindo as luzes com cores específicas ou sequenciando vários comandos de segurança
ou qualquer outra combinação de atividades, essa configuração pode
expostas pelo SYNC como uma cena nomeada, e o Google Assistente vai fazer com que
cenários disponíveis aos usuários por meio da gramática de ativação simples:
- Inicie o Modo balada.
- Ative o cenário noturno.
Como objetos virtuais, as cenas podem ser colocadas em salas (se relevantes) para desambiguação:
- Comece a festinha na cozinha.
- Ative o modo noturno nos quartos.
Uma diferença entre cenas e alvos físicos é que o Google Assistente aplicar automaticamente efeitos de plural aos comandos de cenas, permitindo que os usuários acionem cenas em vários parceiros. Por exemplo, se um usuário tem um "modo balada" cena em dois parceiros diferentes, um para a segurança e outro para as luzes, Ativar o Modo balada acionará os dois.
As cenas vão interagir bem com as próximas ações pessoais para gramática personalizada Por exemplo, Ativar Modo balada -> Vamos começar a festa!.
As cenas sempre precisam ter nomes fornecidos pelo usuário, em vez de "Cena BobCo" padrão
e nomeação. 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 relatar o seguinte
atributos como parte da operação SYNC. Para saber
mais sobre como lidar com intents SYNC, consulte
Fulfillment da 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 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 ao seguinte
como parte da operação EXECUTE. Para saber
mais sobre como lidar com intents EXECUTE, consulte
Fulfillment da 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, 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
}
}