O Google Home Extension for Visual Studio Code foi projetado e criado para desenvolvedores da plataforma Google Home. Essa extensão dá acesso a Google Assistant Simulator, Google Cloud Logging, ao Visualizador do gráfico da casa e a outras ferramentas para simplificar o processo de desenvolvimento de Matter e de casas inteligentes.
Recursos de extensão do Google Home
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 do VS Code.
O Assistant Simulator permite controlar facilmente seus dispositivos digitando suas consultas, por exemplo, "Acender a luz". No VS Code, Assistant Simulator responde com mensagens de texto com base nos seus comandos. Por exemplo, "Ok, vou acender a luz". Consulte Usar o Simulador do Google Assistente para mais detalhes.
Frases em lote
Para testar a integração do Google Home como um autômato, envie frases em lote para o simulador do Google Assistente executando um script de fala. Consulte Executar frases em lote para mais detalhes.
Ferramentas de geração de registros do Matter
As ferramentas de registro do Matter podem coletar todos os registros relacionados à depuração do Matter, incluindo os registros Google Home app (GHA) e do Google Play Services (GMS Core). Os registros podem ser visualizados no VS Code com pesquisas de filtro e de palavras-chave. Os registros podem ser transferidos por download com outras informações de depuração, como Android e a versão do app, e enviados ao Google para relatar problemas.
Cloud Logging
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 Extension mostra mensagens do Google Cloud Logging em tempo real ao lado do código durante a solução de problemas. Consulte Acessar o Cloud Logging para mais detalhes.
Leitor do Home Graph
O Visualizador do Home Graph agora está disponível diretamente no Google Home Extension para que você possa verificar o estado do dispositivo no seu Home Graph no VS Code. Consulte Visualizar o gráfico de início e executar testes para mais detalhes.
Instalar a extensão do Google Home para VS Code
Para instalar o Google Home Extension, siga estas etapas no VS Code:
- Clique no ícone Extensões na barra de atividades.
Pesquise
google homee clique em Instalar.
Também é possível fazer o download do Google Home Extension diretamente do VS Code Marketplace.
Fazer o download de Google Home Extension
Configurar a extensão do Google Home para o VS Code
Depois de instalar o Google Home Extension e recarregar o VS Code, você vai precisar fazer login e selecionar um projeto para usar o Assistant Simulator e acessar o Cloud Logging.
Fazer login com o Google e selecionar um projeto da nuvem
É possível fazer login na sua conta de desenvolvedor em Google Home Extension, autorizando o VS Code a se comunicar com os Serviços do Google em seu nome.
Clique no ícone Google Home na barra de atividades para abrir Google Home Extension.
Clique em Fazer login com o Google para abrir a visualização de login no navegador.
Selecione a conta vinculada aos seus dispositivos de casa inteligente.
Na página de autorização Fazer login com o Google, clique em Permitir.
Uma guia do navegador será aberta e uma caixa de diálogo Open Visual Studio Code será exibida. Clique em Abrir o Visual Studio Code para continuar.
Você será redirecionado para o VS Code, onde sua permissão é necessária para permitir que a extensão do Google Home abra um URI. Clique em Abrir para concluir o processo de login.
Depois de fazer login, o Google Home Extension vai carregar seus projetos. Depois de fazer isso, clique em Selecionar um projeto.
Na janela suspensa Search and select a project que aparece, selecione o projeto de casa inteligente.
Instalar a ferramenta Android Debug Bridge (adb)
Para conferir os registros do Matter em um smartphone Android, é necessário instalar o ADB:
- Instale o ADB no computador.
- Ative as opções do desenvolvedor e a depuração USB no smartphone Android.
Instalar ferramentas de SoC do dispositivo Matter
Para conferir os registros de depuração de dispositivos Matter:
- A maioria dos SoCs de dispositivos exporta portas seriais, como
/dev/ttyUSBxno Linux ou/dev/tty.SLAB_USBtoUARTou/dev/tty.usbserialno macOS. O LogViewer pode ler o registro diretamente do dispositivo. - Alguns tipos de SoC, como NXP ou Silicon Labs, podem exigir a instalação de ferramentas externas (por exemplo, JLink). Consulte Dispositivos compatíveis para mais informações.
Usar a extensão do Google Home para VS Code
Acessar os recursos para desenvolvedores
Em AJUDA E FEEDBACK, clique em Começar e recursos para abrir a página Recursos, onde você encontra informações úteis para o desenvolvimento com o ecossistema do Google Home.
Usar o Simulador do Google Assistente
Para abrir Assistant Simulator no VS Code, clique em GOOGLE ASSISTANT
SIMULATOR na Side Bar. Na caixa Mensagem, digite sua consulta e
pressione Enter.
Você pode conferir as respostas Assistant Simulator e clicar no botão após a consulta para Reenviar.
Executar frases em lote
Passe o cursor sobre a barra de menus GOOGLE ASSISTANT SIMULATOR e escolha uma das seguintes opções para configurar os scripts:
Clique em para abrir os scripts de fala atuais.
Clique em para salvar o histórico em um script
*.utterance.
Para começar a enviar frases em lote, escolha uma das seguintes opções:
- Clique em para selecionar um script de fala na janela suspensa.
Abra um arquivo
*.utterancediretamente e clique em .
Acessar o Cloud Logging
Em ACESSO RÁPIDO, clique em Cloud Logging para abrir a página Cloud Logging, em que você pode encontrar os registros do projeto selecionado.
Os usuários podem filtrar os registros com base na gravidade e no período.
Por padrão, os registros são limitados a 50 linhas. Se o usuário quiser conferir mais registros, role a tela para baixo e clique em Mais.
Acessar o gráfico da casa e fazer testes
Em ACESSO RÁPIDO, clique em Visualizador de gráfico da casa para abrir o painel Visualizador de gráfico da casa, onde você pode encontrar dispositivos que pertencem ao projeto selecionado. Você também pode clicar em Run Test para executar testes no dispositivo.
Isso vai iniciar o pacote de testes no navegador com o dispositivo selecionado e pronto para teste. Clique em Iniciar e aguarde os resultados do teste.
Você pode conferir os detalhes do teste e visualizar os registros depois que todos os testes forem concluídos.
Usar a extensão do Google Home para depuração do Matter
Geração de registros do Android
Em MATTER LOGGING TOOLS, clique em Android Logs para abrir a página Android Logs, selecione o Android ao qual você quer se conectar e comece a mostrar registros.
Depois que o smartphone Android estiver conectado, você poderá conferir os registros linha por linha. Os registros são filtrados, o que significa que apenas os registros relacionados ao GHA e ao módulo Google Play services Matter são mostrados. Também é possível definir Gravidade para filtrar registros ou Pesquisar a palavra-chave nos registros.
Registro do dispositivo Matter
Em MATTER LOGGING TOOLS, clique em Device Logs para abrir a página Resources e selecione SoC Type:
Em seguida, selecione o dispositivo Matter:
Em seguida, você pode acessar todos os registros do dispositivo e usar filtros como Severity e Search para encontrar as informações de interesse.
Fazer o download de todos os registros do Matter
Em QUICK ACCESS, clique em Download Logs para abrir a caixa de diálogo Download Logs, selecione os registros que serão transferidos por download e pressione OK.
Selecione a pasta para fazer o download dos registros e clique em Salvar:
Em seguida, os registros serão salvos na pasta de destino:
Extraia o arquivo ZIP salvo. Ele vai mostrar informações do dispositivo e arquivos de registro.
O arquivo de informações do dispositivo vai incluir todas as informações de versão necessárias para depurar problemas.
Enviar feedback
Para enviar suas ideias ou feedback sobre como podemos melhorar a experiência de desenvolvimento com o Google Home Extension, escolha uma das seguintes opções:
- No painel AJUDA E FEEDBACK, clique em Enviar feedback para enviar suas sugestões.
- No painel HELP AND FEEDBACK, clique em Report Issue para informar qualquer problema encontrado com Google Home Extension.
- Também disponibilizamos um ícone de feedback na página Recursos.