Plug-in do Google Home para o Android Studio

O Google Home Plugin for Android Studio foi projetado e criado para desenvolvedores da plataforma Google Home. Esse plug-in oferece acesso a Google Assistant Simulator, ao Cloud Logging e a outras ferramentas para simplificar seu processo de desenvolvimento de casa inteligente.

Plug-in do Google Home para o Android Studio

Aviso de segurança

Para impedir que Android Studio armazene secrets e senhas, siga estas etapas:

  1. Clique em File e em Settings....
  2. Em Appearance & Behavior, expanda System Settings e clique em Passwords.
  3. Selecione Não salvar, esquecer senhas após a reinicialização.
Plug-in do Google Home para o Android Studio

Recursos

Simulador do Google Assistente

Para testar se os dispositivos de casa inteligente funcionam corretamente com o ecossistema do Google Home, interaja com Assistant Simulator a qualquer momento sem sair da Android Studio.

Assim como o Simulador do Google Assistente fornecido no console do Actions on Google Console, o Assistant Simulator permite controlar facilmente seus dispositivos digitando suas consultas, por exemplo, "Turn on the light" (Ligar a luz). Dentro de Android Studio, Assistant Simulator responde com mensagens de texto baseadas nos seus comandos, por exemplo, "Tudo bem, acendendo a luz".

Testar com o simulador do Google Assistente

Acessar o Cloud Logging

Google Cloud Logging fornece informações de depuração e métricas principais para oferecer insights sobre o uso da ação. Para simplificar o desenvolvimento, o Google Home Plugin mostra mensagens Cloud Logging em tempo real ao lado do código durante a solução de problemas.

É possível exibir registros em tempo real ou selecionar um período.

Visualização do Cloud Logging

Enunciados em lote

As respostas de Assistant Simulator a uma única fala não são determinísticas. Por exemplo, uma resposta pode ser qualquer uma das seguintes frases:

  • Entendi, acendendo duas luzes.
  • Claro, acendendo duas luzes.
  • Entendi, acendendo duas luzes.
  • Certo, acendendo duas luzes.

Para executar testes automatizados e verificar como as integrações do Google funcionam com essas várias respostas, é possível enviar falas em lote para o Assistant Simulator executando scripts de fala. Depois que um script é salvo, é possível coletar respostas e executar vários testes nas suas consultas.

Leitor do Home Graph

O Home Graph Viewer permite mostrar o estado dos dispositivos e iniciar o Google Home Test Suite no navegador.

Leitor de registros do Android Debug Bridge (adb)

O Visualizador de registros Adb é uma ferramenta para visualizar e analisar arquivos de registros, por exemplo, arquivos de registros do dispositivo Matter, registros do Google Home e registros do Android.

Instalar

Para instalar o Google Home Plugin em Android Studio, siga estas etapas:

  1. Faça o download ou atualize o Android Studio. Fazer o download do Android Studio
  2. Acesse File > Settings (Android Studio > Preferences no MacOS).
  3. Na seção Plugins, acesse Marketplace e pesquise google home.
  4. Instale a ferramenta e reinicie o app Android Studio.

Também é possível fazer o download do plug-in diretamente do JetBrains Marketplace (link em inglês).

Configuração

Depois de instalar o plug-in, é necessário concluir as seguintes etapas para usar Assistant Simulator e visualizar o Cloud Logging:

Fazer login com o Google

É possível fazer login na sua conta de desenvolvedor no painel do Google Home, autorizando Android Studio a se comunicar com os serviços do Google em seu nome.

  1. Clique na guia Google Home na coluna da guia vertical no lado esquerdo da janela Android Studio.

  2. Em Fazer login com, clique em Google para iniciar o navegador.

    Login do Google no Android Studio
  3. Escolha a conta vinculada aos seus dispositivos de casa inteligente.

  4. Na página de autorização do Fazer login com o Google, clique em Permitir.

  5. Feche a janela do navegador e volte para Android Studio.

Você deve estar conectado com a opção Sair.

Selecione um projeto do Cloud

Depois de fazer login, selecione um Projeto na lista suspensa. Para filtrar a lista de projetos, digite uma expressão Filter, como matter, e pressione Enter.

O menu suspenso Projeto carrega os primeiros 100 projetos com base no seu Filtro. Suas seleções são retidas quando você sai do Android Studio.

Selecione um projeto

Para ajuda com filtros de projeto, consulte os Parâmetros de consulta na Referência do Google Cloud.

Usar o simulador do Assistente

Para abrir o Assistant Simulator em Android Studio, clique em Painel de Utterances no painel Google Home Plugin.

Abrir painel de enunciados

Há várias maneiras de enviar consultas para o Assistant Simulator. A seguir, vamos falar sobre cada opção.

Digite consultas e colete respostas

Para interagir com o Assistant Simulator, digite sua consulta e pressione Enter.

Para reenviar uma consulta, clique no ícone "Reenviar" no final.

Depois de enviar uma ou mais consultas, clique em Repetir para executar as consultas mais uma vez e verificar as respostas. O painel Utterances acompanha suas consultas e respostas em um cache armazenado. A repetição só adiciona novas respostas a esse cache interno e não duplica as consultas toda vez que você clica no botão.

Repetir enunciados com o simulador do Google Assistente

Clique em Salvar para salvar as consultas e respostas inseridas no painel Utterances. Suas interações são convertidas em JSON no seguinte formato:

  • ask: sua consulta.
  • answers: uma matriz de possíveis respostas Assistant Simulator.

É possível editar esse arquivo JSON em Android Studio.

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

Coletar respostas em lote

No painel Google Home Plugin, clique em Arquivo de Utterances para abrir os arquivos JSON salvos em uma nova guia. Em Selecionar caminho, escolha um arquivo ou uma pasta. Se você escolher uma pasta, Coletar e Testar funcionarão em todos os arquivos .json de falas nessa pasta.

Você pode abrir várias guias para o mesmo arquivo ou arquivos diferentes, por exemplo, lights, lights(1) e plug.

A Barra de status exibe o resultado do último teste (se aplicável), um ponto amarelo ou verde para indicar se o arquivo foi coletado e o caminho do arquivo .json da expressão. Depois que você clica em Coletar, o Assistant Simulator executa suas consultas. Você vai receber uma notificação quando uma nova resposta for coletada, e a Barra de status exibirá um contador enquanto suas consultas estiverem sendo processadas.

Colete enunciados com o simulador do Google Assistente

Quando Coletar é concluído, a Barra de status é atualizada com uma marca de seleção verde na frente do caminho .json, e os arquivos de fala são preenchidos com as possíveis respostas.

Colete enunciados com o simulador do Google Assistente
{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

Se você interromper a coleta com antecedência, seu caminho .json não será marcado como coletado.

Testar enunciados em lote

Depois de coletar as respostas, clique em Testar para repetir as consultas e verificar as respostas e os registros. Quando você testa enunciados em lote, o Assistant Simulator espera as respostas que são salvas no arquivo JSON. Se o teste retornar uma resposta que não foi coletada, você receberá uma notificação semelhante a esta:

Expected one of: "Got it, turning on 2 lights."

Executar enunciados com o simulador do Google Assistente

Esse cenário indica um teste malsucedido. Caso contrário, o Assistant Simulator vai executar cada uma das consultas e retornar uma resposta. Uma verificação vai aparecer na barra de status se o teste for bem-sucedido.

Executar enunciados com o simulador do Google Assistente

Acessar o Cloud Logging

Para abrir uma guia do projeto na janela de ferramentas Registros do Cloud, clique em Registros do Cloud no painel Google Home Plugin. É possível abrir guias separadas do Cloud Log para cada um dos projetos.

Guias do Cloud Logging

Termos de consulta

Para o projeto selecionado, também é possível filtrar registros usando o campo Consulta. Por exemplo, para filtrar registros de uma palavra-chave de light:

Consulta do Cloud Logging

Selecione Usar QL para utilizar a linguagem de consulta do Logging.

Linguagem de consulta do Cloud Logging

Aqui estão alguns exemplos de consultas QL para ajudar você a começar:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

Consultas de data e hora

A consulta de registros por data também é opcional e pode ser ativada clicando em Depois e Antes. Insira o formato de data e hora no campo de texto fornecido (por exemplo, 5/11/22, 12:37 PM) ou use os seletores para escolher a data e insira a hora no campo de texto.

  • Para escolher uma data posterior a 5/1/22, selecione Depois e clique no ícone de data .
  • Para selecionar uma data anterior a 5/1/22, selecione Antes e clique no ícone de data .
  • Para selecionar uma data entre 5/1/22 e 6/30/22, selecione Antes e Depois e escolha as datas no ícone de data .

Selecione Tempo real para buscar os registros do projeto ativo. Clique em Parar para encerrar um feed em tempo real.

Nível de gravidade

Você também pode selecionar uma Gravidade mínima no menu suspenso.

Resultados da consulta

Clique em Buscar para enviar os parâmetros de consulta.

Depois que os registros forem carregados, clique em qualquer registro para expandir o payload JSON completo. Clique novamente em para exibir a mensagem completa.

Também é possível digitar uma palavra-chave na caixa Filtrar para restringir os resultados do registro. Clique em x para remover o filtro e voltar aos resultados originais da busca.

Acessar o Cloud Logging

Ver o Home Graph e executar testes

Para listar seus dispositivos, selecione Home Graph no painel Google Home Plugin.

Clique em Refresh para mostrar o Nome do dispositivo, o ID do dispositivo e o Tipo de dispositivo associados ao projeto selecionado. É possível ter vários painéis Google Home Graph abertos para projetos separados.

Depois que os dispositivos forem carregados, clique em qualquer registro para expandir o payload JSON completo.

Payload do JSON do Home Graph

Também é possível usar Expandir e Recolher para exibir e ocultar os payloads JSON dos seus dispositivos.

JSON de expansão e fechamento do Home Graph

Para iniciar o Pacote de testes para um dispositivo específico, clique em Testar. Isso inicia o Test Suite no navegador com o dispositivo selecionado e pronto para teste. Clique em Iniciar e aguarde os resultados do teste.

Testes de execução do Home Graph

Confira os detalhes do teste e confira os registros assim que ele for concluído.

Testes concluídos do Home Graph

Leitor de registros do Android Debug Bridge (adb)

Para abrir uma guia de projeto na janela de ferramentas Adb Log, clique no comando Adb Log na barra de ferramentas do plug-in do Google Home (à esquerda). Você pode abrir guias separadas de log do Adb para cada um dos seus arquivos de registro. Para excluir uma guia, clique no ícone .

Use o campo Selecionar para selecionar um componente de geração de registros específico para visualizar e a lista suspensa Gravidade para exibir apenas entradas com a gravidade de registro correspondente.

Para o registro do adb selecionado, é possível filtrar entradas de registro usando o campo Filter com modificadores opcionais diferenciando maiúsculas de minúsculas ou Regex.

Você também pode:

  • Para encontrar entradas específicas, use o campo Find Next e os comandos Find Next (ícone ) e Find Previous (ícone do ).
  • Use os modificadores opcionais Diferenciar maiúsculas de minúsculas ou Regex.
  • Ir para linha para pular para uma linha especificada (por número) no registro.

Selecione Numedado para ver as linhas de registro com os números de linha adicionados. Selecione Raw para ver as entradas de registro brutas.

Leitor de registros do Adb

Recursos e feedback

Clique em Recursos para ver uma lista de ferramentas e recursos para desenvolvedores.

Para enviar sua opinião ou feedback sobre como podemos melhorar a experiência de desenvolvimento com o Google Home Plugin, clique em Feedback.

Enviar feedback