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, Cloud Logging e outras ferramentas para simplificar o processo de desenvolvimento de casa inteligente.
Aviso de segurança
Para impedir que Android Studio armazene chaves secretas e senhas, siga estas etapas:
- Clique em Arquivo e depois em Configurações....
- Em Appearance & Behavior, expanda System Settings e clique em Passwords.
- Selecione Não salvar, esqueça senhas após a reinicialização.
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 da Android Studio.
Assim como no simulador do Assistente, fornecido no Console Actions on Google Console, o Assistant Simulator permite controlar facilmente seus dispositivos digitando suas consultas, por exemplo, "Acenda a luz". Dentro de Android Studio, Assistant Simulator responde com mensagens de texto baseadas nos seus comandos, por exemplo, "Tudo bem, acendendo a luz."
Ver o Cloud Logging
Google Cloud Logging fornece informações de depuração e principais métricas para fornecer 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.
Você pode exibir registros em tempo real ou selecionar um período.
Declarações em lote
As respostas Assistant Simulator a uma única expressão não são determinísticas. Por exemplo, uma resposta pode ser qualquer uma das seguintes frases:
- Ok, ligando duas luzes.
- Claro, acendendo duas luzes.
- Ok, ligando 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 enunciados em lote para o Assistant Simulator executando scripts de enunciado. Depois que um script é salvo, é possível coletar respostas e executar vários testes nas consultas.
Visualizador do gráfico da página inicial
O Home Graph Viewer permite que você exiba o estado de seus dispositivos e inicie o Pacote de teste do Google Home em seu navegador.
Visualizador de registros do Android Debug Bridge (adb)
O Visualizador de registros do Adb é uma ferramenta para ver e analisar arquivos de registros, por exemplo, arquivos de registro do dispositivo Matter, 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 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.
Configuração
Depois de instalar o plug-in, será necessário concluir as etapas a seguir antes de usar o Assistant Simulator e visualizar o Cloud Logging:
Fazer login com o Google
É possível fazer login na sua conta de desenvolvedor no painel inicial do Google, autorizando Android Studio a se comunicar com os serviços do Google em seu nome.
Clique na guia Google Home na coluna da guia vertical à esquerda da janela Android Studio.
Em Fazer login com, clique em Google para iniciar o navegador.
Escolha a conta vinculada aos seus dispositivos de casa inteligente.
Na página de autorização do Fazer login com o Google, clique em Permitir.
Feche a janela do navegador e volte para Android Studio.
Agora você está conectado, com a opção de Sair.
Selecionar um projeto do Cloud
Após fazer login, selecione um Project no menu suspenso. Para filtrar a lista de projetos, digite uma expressão Filtro, por exemplo, matter e pressione Enter.
A lista suspensa Projeto carrega os cem primeiros projetos com base no seu filtro. Suas seleções serão mantidas quando você sair de Android Studio.
Para ajuda com os filtros do 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 ao Assistant Simulator. Em seguida, veremos cada opção.
Digite consultas e colete respostas
Para interagir com Assistant Simulator, digite sua consulta e pressione Enter.
Para reenviar uma consulta, clique no ícone no final dela.
Depois de enviar uma ou mais consultas, clique em Reproduzir novamente para executar as consultas novamente e verificar as respostas. O painel Utterances monitora suas consultas e respostas em um cache armazenado. A opção Repetir só adiciona novas respostas a esse cache interno e não duplica suas consultas sempre que você clica no botão.
Clique em Save 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 Utterances File para abrir
os arquivos JSON salvos em uma nova guia. Em Selecionar caminho, escolha um arquivo ou uma pasta. Se você escolher uma pasta, Collect e Test funcionarão em todos os enunciados .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 barra de status exibe o resultado do seu último teste (se aplicável),
um ponto amarelo ou verde para indicar se o arquivo foi coletado e o
caminho de arquivo .json do enunciado. Depois de clicar em
Coletar,
o Assistant Simulator executa suas consultas.
Você será notificado quando uma nova resposta for coletada e a Barra de status exibirá um contador enquanto as consultas estiverem sendo processadas.
Quando a opção Coletar for concluída, a Barra de status será atualizada com uma marca de seleção verde na frente do seu caminho .json, e seus arquivos de fala 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 antecipadamente, o 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 expressõ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ê receberá uma notificação semelhante à seguinte:
Expected one of: "Got it, turning on
2 lights."
Esse cenário indica um teste sem êxito. Caso contrário, o Assistant Simulator executará cada uma das suas consultas e retornará uma resposta. Uma verificação de será exibida na barra de status se o teste for bem-sucedido.
Ver o Cloud Logging
Para abrir uma guia do projeto na janela de ferramentas do 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 Consulta.
Por exemplo, para filtrar registros para uma palavra-chave de light:
Selecione Usar QL para utilizar a linguagem de consulta do Logging.
Veja alguns exemplos de consultas de 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. Digite o formato de data e hora no campo de texto fornecido, por exemplo, 5/11/22, 12:37 PM, ou use os seletores de data para selecionar a data e digite 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 anterior a
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 ativo. 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 os parâmetros de consulta.
Depois que os registros forem carregados, clique em qualquer registro para expandir o payload do 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 no x para remover o filtro e voltar aos resultados da busca originais.
Ver gráfico inicial e executar testes
Para listar seus dispositivos, selecione Home Graph no painel Google Home Plugin.
Clique em Atualizar para exibir o Nome do dispositivo, ID do dispositivo e Tipo de dispositivo para os 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 completo do JSON.
Também é possível usar Expandir e Recolher para exibir 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 Test Suite no navegador com o dispositivo selecionado e pronto para ser testado. Clique em Iniciar e aguarde os resultados do teste.
É possível verificar os detalhes do teste e ver os registros após a conclusão do teste.
Visualizador de registros do Android Debug Bridge (adb)
Para abrir uma guia do projeto na janela de ferramentas do Adb Log, clique no comando Adb Log na barra de ferramentas do plug-in do Google Home (à esquerda). É possível abrir guias separadas 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 visualizar e a lista suspensa Gravidade para exibir apenas entradas com a gravidade de registro correspondente.
Para o registro adb selecionado, você pode filtrar entradas de registro usando o campo Filtro com modificadores opcionais diferenciando maiúsculas de minúsculas ou Regex.
Você também pode:
- Encontre entradas específicas usando o campo Localizar e os comandos Localizar próximo (ícone ) e Localizar anterior (ícone ).
- Use os modificadores opcionais diferencia maiúsculas de minúsculas ou Regex.
- Ir para linha para pular para uma linha especificada (por número) no registro.
Selecione Numerado para ver as linhas de registro com o número de linha adicionado. Selecione Raw para ver entradas de registro brutas.
Recursos e feedback
Clique em Recursos para ver uma lista de ferramentas e recursos para desenvolvedores.
Para enviar sua opinião ou seu feedback sobre como podemos melhorar a experiência de desenvolvimento com o Google Home Plugin, clique em Feedback.
