Extensão do Google Home para VS Code

Matter    De nuvem para nuvem    SDK do Local Home    SDK do dispositivo

O Google Home Extension for Visual Studio Code foi projetado e criado para desenvolvedores da plataforma Google Home. Essa extensão oferece acesso a Google Assistant Simulator, Google Cloud Logging, visualizador de Home Graph e outras ferramentas para simplificar seu processo de desenvolvimento do Matter e de uma casa inteligente.

Extensão do Google Home para VS Code

Recursos da 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.

Assim como o Simulador disponível no Console do Actions, 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, "Tudo bem, acendendo a luz". Consulte Usar o simulador do Google Assistente para ver mais detalhes.

Enunciados em lote

Para testar a integração do Google Home como um autômato, você pode enviar enunciados em lote ao simulador do Google Assistente executando um script de fala. Consulte Executar enunciados em lote para saber mais.

Ferramentas de registro do Matter

As ferramentas de registro do Matter podem coletar todos os registros relacionados à depuração do Matter, incluindo os registros de Google Home app (GHA) e do Google Play Services (GMS Core). Os registros podem ser visualizados no VS Code com pesquisas de filtro e palavra-chave. É possível fazer o download dos registros com outras informações de depuração, como Android e versão do app, e ser enviados ao Google para relatar problemas.

Registro do Matter na extensão do Google Home

Cloud Logging

Cloud Logging fornece informações de depuração e métricas principais para oferecer insights sobre o uso da ação. Para simplificar o desenvolvimento, o Google Home Extension mostra mensagens em tempo real do Google Cloud Logging ao lado do código durante a solução de problemas. Consulte Visualizar o Cloud Logging para mais detalhes.

Leitor do Home Graph

O Home Graph Viewer está disponível diretamente no Google Home Extension para que você possa verificar o estado do dispositivo no Home Graph dentro do VS Code. Consulte Ver o Home Graph e executar testes para saber mais.

Instalar a extensão do Google Home para VS Code

Para instalar o Google Home Extension, siga estas etapas no VS Code:

  1. Clique no ícone Extensions na Activity Bar.
  2. Pesquise por google home e clique em Instalar.

    Marketplace de extensões do Google Home

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 VS Code

Depois de instalar Google Home Extension e recarregar o VS Code, faça login e selecione um projeto antes de usar Assistant Simulator e visualizar o Cloud Logging.

Faça login com o Google e selecione um projeto na 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.

  1. Clique no ícone do Google Home na barra de atividades para abrir Google Home Extension.

    Ícone da extensão do Google Home
  2. Clique em Fazer login com o Google para iniciar a visualização de login no navegador.

    Login do Google no VS Code
  3. Selecione a conta vinculada aos seus dispositivos de casa inteligente.

  4. Na página de autorização do Fazer login com o Google, clique em Permitir.

  5. Uma guia do navegador será aberta e a caixa de diálogo Open Visual Studio Code será exibida. Clique em Abrir o Visual Studio Code para continuar.

    Abrir a caixa de diálogo do VS Code
  6. Você será redirecionado para o VS Code, em que sua permissão é necessária para que a extensão do Google Home abra um URI. Clique em Abrir para concluir o processo de login.

    Permitir que a extensão do Google Home abra um URI
  7. Depois de fazer login, o Google Home Extension vai carregar seus projetos. Depois, clique em Selecionar um projeto.

    Selecionar um projeto
  8. Na janela suspensa Pesquisar e selecionar um projeto, selecione o projeto de casa inteligente.

Instalar a ferramenta Android Debug Bridge (ADB)

Para ver os registros de Matter em um smartphone Android, instale o ADB:

  1. Instale o adb no seu computador.
  2. Ative as Opções do desenvolvedor e a depuração USB no smartphone Android.

Instalar ferramentas de SoC do dispositivo Matter

Para ver os registros de depuração de dispositivos Matter:

  1. A maioria do SoC de dispositivo exporta portas seriais /dev/ttyUSBx no Linux ou /dev/tty.SLAB_USBtoUART ou /dev/tty.usbserial no MacOS. O LogViewer pode ler o registro diretamente no dispositivo.
  2. Alguns tipos de SoC, como NXP ou Silicon Labs, podem exigir a instalação de ferramentas externas, como o JLink. Consulte Dispositivos compatíveis para mais informações.

Usar a extensão do Google Home para VS Code

Acessar recursos para desenvolvedores

Em AJUDA E FEEDBACK, clique em Primeiros passos e recursos para abrir a página Recursos, onde você encontra informações úteis para seu desenvolvimento com o ecossistema do Google Home.

Recursos para o ecossistema do Google Home

Usar o simulador do Google Assistente

Para abrir o Assistant Simulator no VS Code, clique em SIMULATOR do GOOGLE ASSISTENTE na barra lateral. Na caixa Mensagem, digite sua consulta e pressione Enter.

Veja respostas Assistant Simulator e clique no botão após a consulta para Reenviar.

Usar o simulador do Google Assistente

Executar enunciados em lote

Passe o mouse sobre a barra de menus do GOOGLE ASSISTANT SIMULATOR e escolha uma das seguintes opções para configurar os scripts:

  • Clique em para abrir os scripts de fala existentes.

  • Clique em para salvar o histórico em um script *.utterance.

    Ícones do menu de enunciados em lote

Para começar a enviar falas em lote, escolha uma das seguintes opções:

  • Clique em para selecionar um script de fala na janela suspensa.
  • Abra diretamente um arquivo *.utterance e clique em .

    Ícone de execução de enunciados em lote

Acessar o Cloud Logging

Em ACESSO RÁPIDO, clique em Registros do Cloud para abrir a página Registros do Cloud, em que é possível encontrar os registros pertencentes ao projeto selecionado.

Usar o Cloud Logging.

Os usuários podem filtrar registros com base na gravidade e no intervalo de tempo.

Filtrar registros por gravidade e hora

Por padrão, os registros são limitados a 50 linhas. Se o usuário quiser ver mais registros, role até a parte de baixo e clique em Mais para conferir mais registros.

Ver mais registros

Ver o Home Graph e executar testes

Em ACESSO RÁPIDO, clique em Visualizador do Home Graph para abrir o painel Leitor do Home Graph, onde você encontra os dispositivos que pertencem ao projeto selecionado. Você também pode clicar em Run Test para executar testes no dispositivo.

Leitor do Home Graph

Isso vai iniciar o pacote de testes no navegador com o dispositivo selecionado e pronto para testes. Clique em Start e aguarde os resultados do teste.

Pacote de testes do Google Home

É possível conferir os detalhes do teste e visualizar os registros depois que todos os testes forem concluídos.

Resultados do teste

Usar a extensão do Google Home para depurar o Matter

Geração de registros do Android

Em FERRAMENTAS DE REGISTRO DE REGISTRO, clique em Registros Android para abrir a página Registros Android, selecione o smartphone Android a que você quer se conectar e comece a mostrar registros.

Geração de registros do Android

Depois que o smartphone Android estiver conectado, você poderá ver os registros linha por linha. Os registros são filtrados, o que significa que apenas os registros relacionados a GHA e ao módulo Google Play services Matter são exibidos. Também é possível definir Gravidade para filtrar registros ou Pesquisar a palavra-chave nos registros.

Geração de registros do Android filtrada

Registro de dispositivo Matter

Em FERRAMENTAS DE REGISTRO DE REGISTRO, clique em Registros do dispositivo para abrir a página Recursos e selecione Tipo de SoC:

Registro de dispositivos Matter

Em seguida, selecione o Matter Device:

Registro de dispositivo Matter: selecionar dispositivo

Em seguida, você pode acessar todos os registros do dispositivo e usar filtros como Gravidade e Pesquisa para encontrar as informações do seu interesse.

Registro filtrado do dispositivo Matter

Fazer o download de todos os registros do Matter

Em ACESSO RÁPIDO, clique em Fazer download de registros para abrir a caixa de diálogo Fazer download de registros, selecione os registros que serão baixados e pressione OK.

Fazer o download de registros do Matter

Selecione a pasta para fazer o download dos registros e clique em Salvar:

Salvar registro do Matter

Em seguida, os registros são salvos na pasta de destino:

Pasta de destino dos registros do Matter

Extraia o arquivo ZIP salvo. Ele vai mostrar as informações do dispositivo e os arquivos de registro.

Arquivo ZIP do registro do Matter

O arquivo de informações do dispositivo vai incluir todas as informações da versão necessárias para depurar problemas.

Depuração de registro do Matter

Enviar feedback

Para enviar sua opinião ou feedback sobre como podemos melhorar a experiência de desenvolvimento com Google Home Extension, escolha uma destas opções:

  • No painel AJUDA E FEEDBACK, clique em Enviar feedback para dar sugestões.
  • No painel AJUDA E FEEDBACK, clique em Informar problema para relatar qualquer problema encontrado com Google Home Extension.
Ícone "Enviar feedback"
  • Também incluímos um ícone de feedback na página Recursos.