Extensão do Google Home para VS Code

SDK do dispositivo

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, Home Graph Viewer e outras ferramentas para simplificar seu processo de desenvolvimento de casa e caso inteligente.

Extensão Google Home para VS Code

Recursos da extensão Google Home

Simulador do Google 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 VS Code.

Assim como no simulador fornecido no Console do Actions, o Assistant Simulator permite que você controle facilmente os dispositivos digitando suas consultas, por exemplo, "Acenda a luz". Dentro do VS Code, Assistant Simulator responde com mensagens de texto baseadas nos seus comandos, por exemplo, "Tudo bem, acendendo a luz." Consulte Usar o simulador do Google Assistente para mais detalhes.

Declarações em lote

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

Ferramentas de registro de casos

As ferramentas de geração de registros do Matter podem coletar todos os registros relacionados à depuração do Matter, incluindo os registros Google Home app (GHA) e os registros 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 mais informações sobre depuração, como Android e versão do app, e enviá-los ao Google para relatar problemas.

Registro de casos de extensão do Google Home

Cloud Logging

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 Extension mostra mensagens do Google Cloud Logging em tempo real ao lado do código durante a solução de problemas. Consulte Visualizar o Cloud Logging para mais detalhes.

Visualizador do gráfico da página inicial

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

Instalar a extensão Google Home para o VS Code

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

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

    Mercado de extensões do Google Home

Também é possível fazer o download de Google Home Extension diretamente do VS Code Marketplace.

Fazer o download de Google Home Extension

Configurar a extensão Google Home para o VS Code

Depois de instalar o Google Home Extension e recarregar o VS Code, você precisará fazer login e selecionar um projeto antes de usar o Assistant Simulator e ver o Cloud Logging.

Fazer login com o Google e selecionar um projeto na nuvem

Você pode fazer login na sua conta de desenvolvedor a partir de 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 Google Home
  2. Clique em Fazer login com o Google para iniciar a visualização de login no seu navegador.

    VS Code Login do Google
  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 uma caixa de diálogo Abrir código do Visual Studio será exibida. Clique em Abrir código do Visual Studio para continuar.

    Abrir a caixa de diálogo do VS Code
  6. 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.

    Permitir que a extensão do Google Home abra um URI
  7. Após o login, Google Home Extension carregará seus projetos. Em seguida, clique em Selecionar um projeto.

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

Instalar a ferramenta Android Debug Bridge (adb)

Para ver os registros Matter em um smartphone Android, será necessário instalar 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 das SoCs de dispositivo exportará portas seriais como /dev/ttyUSBx no Linux ou /dev/tty.SLAB_USBtoUART ou /dev/tty.usbserial no MacOS. O LogViewer pode ler o registro diretamente do dispositivo.
  2. Alguns tipos de SoC, como NXP ou Silicon Labs, podem exigir que ferramentas externas (por exemplo, JLink) sejam instaladas. Consulte Dispositivos compatíveis para mais informações.

Usar a extensão do Google Home para o VS Code

Ver recursos para desenvolvedores

Em AJUDA E FEEDBACK, clique em Primeiros passos e recursos para abrir a página Recursos, em que você pode encontrar 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 GOOGLE ASSISTENTE SIMULATOR na barra lateral. Na caixa Mensagem, digite sua consulta e pressione Enter.

É possível visualizar respostas Assistant Simulator e clicar no botão após sua consulta para reenviá-la.

Usar o simulador do Google Assistente

Executar enunciados em lote

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

  • Clique em para abrir scripts de fala existentes.

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

    Ícones de menu de expressões em lote

Para começar a enviar enunciados 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 lote

Ver o Cloud Logging

Em QUICK ACCESS, clique em Cloud Logs para abrir a página Cloud Logs, onde você pode encontrar os registros pertencentes ao projeto selecionado.

Usar o Cloud Logging

Os usuários podem filtrar os registros com base na gravidade e no período.

Filtrar registros por gravidade e tempo

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

Ver mais registros

Ver gráfico inicial e executar testes

Em QUICK ACCESS, clique em Home Graph Viewer para abrir o painel Home Graph Viewer, onde você pode encontrar dispositivos que pertencem ao projeto selecionado. Também é possível clicar em Run Test para executar testes no dispositivo.

Visualizador do gráfico da página inicial

Isso iniciará o pacote de testes no navegador com o dispositivo selecionado e pronto para ser testado. Clique em Iniciar e aguarde os resultados do teste.

Pacote de teste do Google Home

É possível verificar os detalhes do teste e ver os registros após a conclusão de todos os testes.

Resultados do teste

Usar a extensão Google Home para a depuração do caso

Geração de registros do Android

Em Ferramentas 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 os registros.

Geração de registros do Android

Depois que o smartphone Android estiver conectado, você poderá ver os registros linha por linha. Observe que 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 exibidos. Também é possível definir Gravidade para filtrar os registros ou Pesquisar a palavra-chave nos registros.

Registros do Android filtrados

Registro do dispositivo Matter

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

Registro do dispositivo Matter

Em seguida, selecione o Dispositivo Matter:

Selecionar o dispositivo do Matter

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

Registro filtrado do dispositivo Matter

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 a serem transferidos e pressione OK.

Fazer o download dos registros do Matter

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

Salvar registro do caso

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

Pasta de destino do registro do caso

Extraia o arquivo zip salvo, ele mostrará informações do dispositivo e arquivos de registro.

Arquivo zip do Matter

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

Depuração de registro de caso

Enviar feedback

Para enviar sua opinião ou seu 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 comentários para nos dar sugestões.
  • No painel AJUDA E FEEDBACK, clique em Informar problema para relatar qualquer problema que você tenha encontrado no Google Home Extension.
Ícone "Enviar feedback"
  • Também fornecemos um ícone de feedback na página Recursos.