O Google Home Plugin for Android Studio foi projetado e criado para desenvolvedores da plataforma Google Home. Esse plug-in oferece acesso ao 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 Android Studio armazene segredos e senhas, siga estas etapas:
- Clique em File e em Settings....
- Em Appearance & Behavior, expanda System Settings e clique em Passwords.
- Selecione Do not save, forget passwords after restart.
Recursos
Simulador do Assistente
Para testar se os dispositivos de casa inteligente funcionam corretamente com o ecossistema do Google Home, você pode interagir com Assistant Simulator a qualquer momento sem sair do Android Studio.
O Assistant Simulator permite controlar facilmente os dispositivos digitando as consultas, por exemplo, "Acenda a luz." Dentro de Android Studio, Assistant Simulator responde com mensagens de texto com base nos comandos, por exemplo, "Tudo bem, acendendo a luz."
Ver o Cloud Logging
Google Cloud Logging fornece informações de depuração e métricas importantes para oferecer insights sobre o uso da sua 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.
Declarações em lote
Assistant Simulator respostas a uma única declaração 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.
- Tudo bem, acendendo duas luzes.
Para executar testes automatizados e verificar como as integrações do Google funcionam com essas várias respostas, envie declarações em lote ao Assistant Simulator executando scripts de declaração. Depois que um script é salvo, é possível coletar respostas e executar vários testes nas consultas.
Leitor do Home Graph
O Leitor do Home Graph permite mostrar o estado dos dispositivos e iniciar o pacote de testes do Google Home no navegador.
Visualizador de registros do Android Debug Bridge (adb)
O visualizador de registros do adb é uma ferramenta para visualizar e analisar arquivos de registro, por exemplo Matter arquivos de registro de dispositivos, registros do Google Home e registros do Android.
Instalar
Para instalar o Google Home Plugin em Android Studio, siga estas etapas:
- Faça o download ou atualize Android Studio. Faça 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 Android Studio.
Também é possível fazer o download do plug-in diretamente do JetBrains Marketplace.
Configuração
Depois de instalar o plug-in, siga estas etapas antes de usar Assistant Simulator e ver o Cloud Logging:
Fazer login com o Google
É possível fazer login na sua conta de desenvolvedor no painel de controle da casa do Google Home, autorizando 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 Sign in with, clique em Google para abrir o navegador.
Escolha a conta vinculada aos dispositivos de casa inteligente.
Na página de autorização Fazer login com o Google, clique em Allow.
Feche a janela do navegador e volte para Android Studio.
Agora você está conectado e tem a opção de Sign Out.
Selecionar um projeto na nuvem
Depois de fazer login, selecione um Project no menu suspenso. Para filtrar a lista de projetos, digite uma expressão de Filter, por exemplo, matter e pressione Enter.
O menu suspenso Project carrega os 100 primeiros projetos com base no seu Filter. As seleções são mantidas quando você sai Android Studio.
Para receber ajuda com filtros de projeto, consulte 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 Utterances Panel no painel Google Home Plugin.
Há várias maneiras de enviar consultas ao Assistant Simulator. Em seguida, vamos analisar cada opção.
Digitar consultas e coletar respostas
Para interagir com o Assistant Simulator, digite a consulta e pressione Enter.
É possível reenviar uma consulta clicando no ícone de reenviar no final de sua consulta.
Depois de enviar uma ou mais consultas, clique em Replay para executar as consultas novamente e verificar as respostas. O painel Utterances acompanha as consultas e respostas em um cache armazenado. Replay só adiciona novas respostas a esse cache interno e não duplica as consultas sempre que você clica no botão.
Clique em Save para salvar as consultas e respostas inseridas no Utterances painel. 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 Select Path, é possível escolher um
arquivo ou uma pasta. Se você escolher uma pasta, Collect e Test vão funcionar em todas as declarações .json arquivos nessa pasta.
É possível abrir várias guias para o mesmo arquivo ou arquivos diferentes, por exemplo
lights, lights(1) e plug.
A Status Bar mostra 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 de declaração .json. Depois de clicar em
Collect,
o Assistant Simulator executa as consultas.
Você vai receber uma notificação quando uma nova resposta for coletada, e a Status Bar vai mostrar um contador enquanto as consultas estiverem sendo processadas.
Quando Collect for concluído, a Status Bar será atualizada com uma marca de seleção verde na frente do caminho .json, e os arquivos de declaração 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ê Stop a coleta antecipadamente, o caminho .json não será marcado como coletado.
Testar declarações em lote
Depois de coletar as respostas, clique em Test para reproduzir as consultas e verificar as respostas e os registros. Ao testar declarações 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 à seguinte resposta:
Expected one of: "Got it, turning on
2 lights."
Esse cenário indica um teste sem êxito. Caso contrário, o Assistant Simulator vai executar cada uma das consultas e retornar uma resposta. Uma marca de seleção check será mostrada na Status Bar se o teste for bem-sucedido.
Ver o Cloud Logging
Para abrir uma guia de projeto na janela de ferramentas Cloud Logs, clique em Cloud Logs no painel Google Home Plugin. É possível abrir guias separadas do Cloud Log para cada um dos projetos.
Termos de consulta
Para o projeto selecionado, também é possível filtrar registros usando o campo Query.
Por exemplo, para filtrar registros de uma palavra-chave de 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 After e Before. É possível 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 após
5/1/22, selecione After e clique no ícone de data . - Para selecionar uma data anterior a
5/1/22, selecione Before e clique no ícone de data . - Para selecionar uma data entre
5/1/22e6/30/22, selecione Before e After e escolha as datas no ícone de data .
Selecione Real time para buscar registros de projetos ativos. Clique em Stop para encerrar um feed em tempo real.
Nível de gravidade
Também é possível selecionar uma Minimal Severity no menu suspenso.
Resultados da consulta
Clique em Fetch 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 mostrar a mensagem completa.
Opcionalmente, digite uma palavra-chave na caixa Filter para restringir os resultados do registro. Clique no x para remover o filtro e voltar aos resultados da busca original.
Ver o Home Graph e executar testes
Para listar os dispositivos, selecione Home Graph no painel Google Home Plugin.
Clique em Refresh para mostrar o Device name, Device id e Device type dos dispositivos associados ao projeto selecionado. É possível abrir vários Google Home Graph painéis para projetos separados.
Depois que os dispositivos forem carregados, clique em qualquer registro para expandir o payload JSON completo.
Também é possível usar Expand e Collapse para mostrar e ocultar os payloads JSON dos dispositivos.
Para iniciar o pacote de testes de um dispositivo específico, clique em Test. Isso inicia o pacote de testes no navegador com o dispositivo selecionado e pronto para ser testado. Clique em Start e aguarde os resultados do teste.
É possível verificar os detalhes do teste e conferir os registros quando os testes forem concluídos.
Visualizador 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). É 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 Select para selecionar um componente de registro específico para visualizar e o menu suspenso Severity para mostrar apenas as entradas com a gravidade de registro correspondente.
Para o registro do adb selecionado, é possível filtrar as entradas de registro usando o campo Filter com modificadores opcionais Case-sensitive ou Regex.
Também é possível:
- Encontre entradas específicas usando o campo Find e os comandos Find Next ( ícone) e Find Previous ( ícone).
- Use modificadores opcionais Case-sensitive ou Regex.
- Jump to line para acessar uma linha especificada (por número) no registro.
Selecione Numbered para mostrar as linhas de registro com números de linha adicionados. Selecione Raw para mostrar entradas de registro brutas.
Recursos e feedback
Clique em Resources para acessar 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.
