Estendendo sua casa inteligente Ações com alternâncias e modos

Nick Felker Blocked Desbloquear Seguir Seguindo 27 de novembro de 2018 Estruturas, salas e dispositivos são representados no gráfico inicial

Se você criou uma Ação para a casa inteligente do Google Assistente, pode estar familiarizado com as várias características , que definem o conjunto de recursos que seu dispositivo pode ter. Seu dispositivo pode ser capaz de ligar e desligar , mudar de cor ou ter velocidades diferentes . Ao mesmo tempo, seu dispositivo pode ter recursos mais avançados que não podem ser definidos por um desses traços.

Para integrar esses recursos com o Google Assistente, você pode usar o modo ou alternar traços. Eles são muito semelhantes, pois ambos são definidos em pares de valores-chave.

Modos

Um traço de modo representa um parâmetro do dispositivo que pode ser atribuído a uma das várias configurações. As configurações de um modo podem ser ordenadas ou não. Por exemplo, uma lavadora pode ter uma carga pequena , média ou grande , que possui alguma ordem incremental. Um forno pode ter configurações não ordenadas, como assar, assar ou assar .

Cada modo só pode ter uma configuração em um determinado momento, e o modo sempre deve ser atribuído a uma dessas configurações.

Na sua resposta SYNC, você pode retornar a lista de modos suportados, bem como as configurações que estão disponíveis para o modo dado. Para ver os modos disponíveis, você pode consultar esta página de referência , que mostra as chaves e sinônimos.

No exemplo abaixo, a lavadora tem um único modo, chamado load , mas também pode ser chamado de tamanho ou tamanho de carga . O modo pode ter uma configuração pequena ou grande . Para alterar a configuração, você pode apenas dizer "Definir a carga para pequena na máquina de lavar". Você pode ver toda a resposta abaixo:

Alterna

As alternâncias são semelhantes aos modos, exceto que, em vez de um modo ter um dos vários valores de sequência, uma alternância terá um valor booleano. Isso pode ser útil se o dispositivo tiver muitas configurações que podem ser ativadas ou desativadas, como o modo noturno ou o modo silencioso.

Cada alternância deve ser considerada independente de outras alternâncias. Por exemplo, o modo noturno não deve ser afetado pelo modo silencioso e vice-versa. Cada alternância deve estar ativada ou desativada e não em algum estado intermediário.

Assim como nos modos, todas as alternações suportadas podem ser retornadas em sua resposta SYNC. Esta página de referência mostra todos os nomes de alternância suportados.

No exemplo abaixo, a câmera tem dois toggles. O primeiro é chamado noite . O segundo é chamado de gravação, mas também pode ser chamado de monitoramento . Para ativar uma das alternâncias, basta dizer "Ativar gravação para a câmera frontal". Você pode ver toda a resposta abaixo:

Conforme você desenvolve sua Ação, pode achar útil usar uma combinação de ambos os modos e alterna. Isso dará aos usuários a flexibilidade necessária para controlar seu dispositivo por meio do Google Assistente.

Manipulando executar intenções

Quando o usuário diz “Definir a carga pequena na máquina de lavar” ou “Ativar gravação na câmera”, o servidor receberá uma intenção EXECUTAR com as configurações modificadas modo ou alterna listados nas updateModeSettings ou updateToggleSettings objeto, como mostrado abaixo :

Novos modos e alterna

A documentação de referência para modos e alterna mostra a lista completa de nomes que você pode usar. Se você quiser que um novo item seja adicionado à lista, poderá arquivar uma solicitação de recurso no projeto de amostra do GitHub. Inclua os modos, configurações de modo ou alterna na descrição do problema. Se sua solicitação for aprovada pelo Google, ela será adicionada após alguns dias, permitindo que você faça uma iteração rápida.

Aprendendo mais

Essas duas características podem fornecer aos desenvolvedores muita flexibilidade no controle de seus dispositivos do Google Assistente. Para saber mais sobre essas características e tudo mais sobre a casa inteligente, você pode começar a usar este codelab doméstico inteligente ou visitar nossa documentação para desenvolvedores .

Que tipos de casa inteligente Ações você está construindo? Tweet seu projeto com #AoGDevs para compartilhar com a comunidade.