Google Home Plugin for Android Studio is designed and created for Google Home Platform developers. This plugin gives you access to Google Assistant Simulator , Cloud Logging, and other tools to simplify your smart home development process.
Aviso de segurança
Para evitar que Android Studio armazene secrets e senhas, siga estas etapas:
- Clique em Arquivo e em Configurações....
- Em Aparência e comportamento, expanda Configurações do sistema e clique em Senhas.
- Selecione Não salvar, esqueça as 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 de Android Studio.
Semelhante ao simulador do Google Assistente fornecido no Actions on Google Console Console, Assistant Simulator enables you to easily control your devices by typing your queries, for example, "Turn on the light." Inside Android Studio, Assistant Simulator responds back with text messages based on your commands, for example, "Alright, turning on the light."
Ver Cloud Logging
Google Cloud Logging fornece informações de depuração e as 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 seu código durante a solução de problemas.
É possível exibir registros em tempo real ou selecionar um período.
Enunciados em lote
As respostas do Assistant Simulator para um único enunciado não são deterministas. Por exemplo, uma resposta pode ser qualquer uma das seguintes frases:
- Entendi. Acender 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 enunciados em lote para o Assistant Simulator executando scripts de expressão. Depois que um script é salvo, é possível coletar respostas e executar vários testes nas consultas.
Leitor do gráfico inicial
O Home Graph Viewer permite mostrar o estado dos seus dispositivos e iniciar o Google Home Test Suite no navegador.
Instalar
Para instalar o Google Home Plugin em Android Studio, siga estas etapas:
- Faça o download ou atualize 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 Android Studio.
Configuração
Depois de instalar o plug-in, conclua as etapas a seguir antes de usar a Assistant Simulator e ver 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 da coluna vertical à esquerda da janela Android Studio.
Em Fazer login com, clique em Google para iniciar seu 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ê precisa fazer login com a opção Sair.
Selecione um projeto do Cloud
Depois de fazer login, selecione um Projeto no menu suspenso. Para filtrar a
lista de projetos, digite uma expressão Filter, por exemplo, matter, e pressione
Enter.
O menu suspenso Projeto carrega os cem primeiros projetos com base no seu filtro. Suas seleções serão mantidas quando você sair Android Studio.
Se precisar de ajuda com filtros de projeto, consulte os 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 Utterance Panel no Google Home Plugin.
Há várias maneiras de enviar consultas para o Assistant Simulator. Em seguida, falaremos sobre cada opção.
Digite consultas e colete respostas
Para interagir com a Assistant Simulator, digite sua consulta e pressione Enter.
É possível reenviar uma consulta clicando no ícone de reenvio no final da consulta.
Depois de enviar uma ou mais consultas, clique em Repetir para executar novamente as consultas e conferir as respostas. O painel Utterances monitora suas consultas e respostas em um cache armazenado. A opção Repetir apenas adiciona novas respostas a esse cache interno e não duplica as consultas sempre que você clica no botão.
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 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, Coletar e Testar funcionará em todos os enunciados .json arquivos.
É possível abrir várias guias para o mesmo arquivo ou para 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ê vai receber uma notificação quando uma nova resposta for coletada e a barra de status vai mostrar um contador durante o processamento das consultas.
Quando a Coletar é concluída, a barra de status é atualizada com uma marca de seleção verde
em frente ao caminho .json, e os arquivos de expressão sã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 voz em lote
Depois de coletar as respostas, clique em Testar para repetir as consultas e verificar as respostas e os registros. Quando você testa falas 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 à seguinte:
Expected one of: "Got it, turning on
2 lights."
Esse cenário indica um teste com falha. Caso contrário, o Assistant Simulator 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.
Ver Cloud Logging
Para abrir uma guia de 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 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 para uma palavra-chave de light:
Selecione Usar QL para utilizar a Linguagem de consulta do Logging.
Veja 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 sua data e inserir a hora no campo de texto.
- Para selecionar uma data após
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 registros do projeto em tempo real. 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.
Você também pode 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 original.
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 Google Home Graph panels open for separate projects.
Depois que os dispositivos forem carregados, clique em qualquer registro para expandir o payload JSON completo.
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 Pacote de testes no navegador com o dispositivo selecionado e pronto para teste. Clique em Iniciar e aguarde os resultados do teste.
É possível verificar os detalhes e ver os registros após a conclusão do teste.
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.
