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 o processo de desenvolvimento de casas inteligentes.
Aviso de segurança
Para impedir que o Android Studio armazene segredos e senhas, siga estas etapas:
- Clique em Arquivo e em Configurações.
- Em Appearance & Behavior, expanda System Settings e clique em Passwords.
- Selecione Não salvar, esquecer senhas após a reinicialização.
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 de Android Studio.
O Assistant Simulator permite controlar facilmente seus dispositivos digitando consultas, por exemplo, "Acender a luz". No Android Studio, Assistant Simulator responde com mensagens de texto com base nos seus comandos, por exemplo, "Ok, vou acender a luz."
Acessar o Cloud Logging
Google Cloud Logging fornece informações de depuração e métricas importantes para dar 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 mostrar registros em tempo real ou selecionar um período.
Frases em lote
As respostas Assistant Simulator a uma única frase não são determinísticas. Por exemplo, uma resposta pode ser qualquer uma das seguintes frases:
- Certo, acendendo duas luzes.
- Claro, acendendo duas luzes.
- Certo, 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, envie frases em lote para o Assistant Simulator executando scripts de fala. Depois que um script é salvo, você pode coletar respostas e realizar vários testes com suas consultas.
Leitor do Home Graph
O Visualizador do Home Graph permite exibir o estado dos seus dispositivos e iniciar o Google Home Test Suite no navegador.
Visualizador de registros do Android Debug Bridge (adb)
O Adb Log Viewer é uma ferramenta para visualizar e analisar arquivos de registro, por exemplo, arquivos de registro do dispositivo Matter, registros do Google Home e do Android.
Instalar
Para instalar o Google Home Plugin no Android Studio, siga estas etapas:
- Faça o download ou atualize o Android Studio. Fazer o download do Android Studio
- Acesse File > Settings (Android Studio > Preferences no MacOS).
- Na seção Plugins, acesse Marketplace e pesquise
google home. - Instale a ferramenta e reinicie o 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, você precisará concluir as etapas a seguir antes de usar o Assistant Simulator e acessar o Cloud Logging:
Fazer login com o Google
Você pode fazer login na sua conta de desenvolvedor no painel do Google Home, autorizando o Android Studio a se comunicar com os Serviços do Google em seu nome.
Clique na guia Google Home na coluna de guias verticais à esquerda da janela Android Studio.
Em Fazer login com, clique em Google para abrir o navegador.
Escolha a conta vinculada aos seus dispositivos de casa inteligente.
Na página de autorização Fazer login com o Google, clique em Permitir.
Feche a janela do navegador e volte para Android Studio.
Você já fez login e tem a opção de Sair.
Selecionar um projeto do Cloud
Depois de fazer login, selecione um Projeto no menu suspenso. Para filtrar a
lista de projetos, digite uma expressão Filtro, por exemplo, matter, e pressione
Enter.
O menu suspenso Project carrega os primeiros 100 projetos com base no seu Filter. Suas seleções são mantidas quando você sai do Android Studio.
Para receber ajuda com os filtros de projeto, consulte Parâmetros de consulta na referência do Google Cloud.
Usar o simulador do Google Assistente
Para abrir o Assistant Simulator em Android Studio, clique em Utterances Panel no painel Google Home Plugin.
Há várias maneiras de enviar consultas para o Assistant Simulator. A seguir, vamos abordar cada opção.
Digitar consultas e coletar respostas
Para interagir com o Assistant Simulator, digite sua consulta e pressione Enter.
Para reenviar uma consulta, clique no ícone de reenvio no final da consulta.
Depois de enviar uma ou mais consultas, clique em Repetir para executar as consultas novamente e verificar as respostas. O painel Utterances monitora suas consultas e respostas em um cache armazenado. A opção Reproduzir só adiciona novas respostas a esse cache interno e não duplica suas consultas sempre que você clica no botão.
Clique em Salvar para salvar as consultas e respostas que você inseriu no painel Frases. 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 Utterances File para abrir
os arquivos JSON salvos em uma nova guia. Em Selecionar caminho, você pode escolher um
arquivo ou uma pasta. Se você escolher uma pasta, Collect e Test vão
funcionar em todos os arquivos .json de enunciados nessa pasta.
É possível abrir várias guias para o mesmo arquivo ou arquivos diferentes, por exemplo, lights, lights(1) e plug.
A barra de status mostra o resultado do seu último teste (se aplicável),
um ponto amarelo ou verde para indicar se o arquivo foi coletado e o
caminho do arquivo .json da fala. Depois de clicar em
Collect,
o Assistant Simulator executa suas consultas.
Você vai receber uma notificação quando uma nova resposta for coletada, e a Barra de status vai mostrar um contador enquanto suas consultas estiverem sendo processadas.
Quando a Coleta for concluída, a Barra de status vai ser atualizada com uma marca de seleção verde em
frente ao caminho .json, e os arquivos de enunciados serão preenchidos com
possíveis respostas.
{
"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 antes do fim, o caminho .json não será marcado como
coletado.
Testar frases em lote
Depois de coletar as respostas, clique em Teste para repetir as consultas e verificar as respostas e os registros. Ao testar frases em lote, o Assistant Simulator espera as respostas salvas no arquivo JSON. Se o teste retornar uma resposta que não foi coletada, você vai receber uma notificação semelhante a esta:
Expected one of: "Got it, turning on
2 lights."
Esse cenário indica um teste sem sucesso. Caso contrário, o Assistant Simulator vai executar cada uma das suas consultas e retornar uma resposta. Uma verificação será exibida na barra de status se o teste for bem-sucedido.
Acessar o Cloud Logging
Para abrir uma guia de projeto na janela da ferramenta Cloud Logging, clique em Cloud Logging no painel Google Home Plugin. É possível abrir guias separadas do Cloud Logging para cada um dos seus projetos.
Termos de consulta
Para o projeto selecionado, também é possível filtrar os registros usando o campo Consulta.
Por exemplo, para filtrar registros de uma palavra-chave light:
Selecione Use QL para usar a Linguagem de consulta do Logging.
Confira 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. Você pode digitar o formato de data e hora no campo de texto
fornecido, por exemplo, 5/11/22, 12:37 PM, ou usar os seletores de data
para selecionar a data e, em seguida, inserir a hora no campo de texto.
- Para selecionar uma data posterior a
5/1/22, selecione Depois e clique no ícone de data . - Para selecionar uma data antes de
5/1/22, selecione Antes e clique no ícone de data . - Para selecionar uma data entre
5/1/22e6/30/22, selecione Antes e Depois e escolha as datas no ícone de data .
Selecione Tempo real para buscar os registros do projeto em tempo real. Clique em Parar para encerrar um feed em tempo real.
Nível de gravidade
Também é possível selecionar uma gravidade mínima no menu suspenso.
Resultados da consulta
Clique em Buscar para enviar seus parâmetros de consulta.
Depois que os registros forem carregados, clique em qualquer registro para expandir o payload JSON completo. Clique novamente em para mostrar a mensagem completa.
Opcionalmente, digite uma palavra-chave na caixa Filtrar para restringir os resultados
de registro. Clique no x para remover o filtro e voltar aos resultados de busca
originais.
Acessar o gráfico da casa e fazer testes
Para listar seus dispositivos, selecione Home Graph no painel Google Home Plugin.
Clique em Atualizar para mostrar o Nome do dispositivo, o ID do dispositivo e o Tipo do dispositivo dos dispositivos 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.
Você também pode usar Expand e Collapse para mostrar e ocultar os payloads JSON dos seus dispositivos.
Para iniciar o pacote de testes em um dispositivo específico, clique em Testar. Isso inicia o pacote de testes no navegador com o dispositivo selecionado e pronto para teste. Clique em Start e aguarde os resultados do teste.
Você pode conferir os detalhes do teste e consultar os registros quando os testes forem concluídos.
Visualizador de registros do Android Debug Bridge (adb)
Para abrir uma guia de projeto na janela da ferramenta Adb Log, clique no comando Adb Log na barra de ferramentas do plug-in do Google Home (à esquerda). É possível abrir guias separadas do Adb Log para cada um dos 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 exibir e o menu suspenso Gravidade para mostrar apenas entradas com a gravidade de registro correspondente.
Para o registro adb selecionado, é possível filtrar as entradas de registro usando o campo Filtro com modificadores opcionais Sensível a maiúsculas ou Regex.
Também é possível:
- Encontre entradas específicas usando o campo Encontrar e os comandos Encontrar a seguir (ícone ) e Encontrar anterior (ícone ).
- Use os modificadores Sensível à caixa ou Regex opcionais.
- Ir para a linha para ir para uma linha especificada (por número) no registro.
Selecione Numeradas para ver as linhas de registro com os números de linha adicionados. Selecione Raw para conferir as entradas de registro brutas.
Recursos e feedback
Clique em Recursos para ver uma lista de ferramentas e recursos para desenvolvedores.
Para enviar suas ideias ou feedback sobre como podemos melhorar a experiência de desenvolvimento com o Google Home Plugin, clique em Feedback.
