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. Esta extensão oferece acesso a Google Assistant Simulator, Google Cloud Logging, visualizador do Home Graph e a outras ferramentas para simplificar seu processo de desenvolvimento de casas inteligentes e o Matter.
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, você pode interagir com Assistant Simulator a qualquer momento sem sair do VS Code.
Assim como o Simulador existente no Console do Actions, o Assistant Simulator permite que você controle facilmente seus dispositivos digitando as consultas, por exemplo, "Acenda a luz". No 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.
Enunciados em lote
Para testar a integração do Google Home como um autômato, é possível enviar expressões em lote para o simulador do Google Assistente executando um script de fala. Consulte Executar enunciados em lote para mais detalhes.
Ferramentas de registro do Matter
As ferramentas de registro do Matter podem coletar todos os registros relacionados à depuração do Matter, incluindo 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.
Cloud Logging
Cloud Logging fornece informações de depuração e métricas importantes 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 Ver o Cloud Logging para mais detalhes.
Visualizador do Home Graph
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 o Home Graph 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 Extensions na Activity Bar.
Pesquise
google homee clique em Instalar.
Também é possível fazer o download do Google Home Extension diretamente no 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, você precisará fazer login e selecionar um projeto antes de usar Assistant Simulator e ver 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.
Clique no ícone do 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 do 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á mostrada. 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.
Após o login, o Google Home Extension vai carregar seus projetos. Depois, clique em Selecionar um projeto.
Na janela suspensa Pesquisar e selecionar um projeto, selecione seu projeto de casa inteligente.
Instalar a ferramenta Android Debug Bridge (ADB)
Para visualizar os registros Matter em um smartphone Android, é necessário instalar o adb:
- Instale o adb no seu computador.
- 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:
- A maioria do SoC do dispositivo exportará portas seriais como
/dev/ttyUSBxno Linux ou/dev/tty.SLAB_USBtoUARTou/dev/tty.usbserialno MacOS. O LogViewer pode ler o registro diretamente no dispositivo. - Alguns tipos de SoC, como NXP ou Silicon Labs (links em inglês), 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
Conferir recursos para desenvolvedores
Em AJUDA E FEEDBACK, clique em Primeiros passos e recursos para abrir a página Recursos, em que você encontra informações úteis para o ecossistema do Google Home.
Usar o simulador do Google Assistente
Para abrir Assistant Simulator no VS Code, clique em GOOGLE ASSISTENTE
SIMULATOR na barra lateral. Na caixa Mensagem, digite sua consulta e pressione Enter.
Veja as respostas de Assistant Simulator e clique no botão após a consulta para reenviá-la.
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 os scripts de fala existentes.
Clique em para salvar o histórico em um script
*.utterance.
Para começar a enviar declarações em lote, escolha uma destas opções:
- Clique em para selecionar um script de fala na janela suspensa.
Abra diretamente um arquivo
*.utterancee clique em .
Acessar o Cloud Logging
Em ACESSO RÁPIDO, clique em Registros do Cloud para abrir a página Registros do Cloud. Lá, você encontrará os registros pertencentes ao projeto selecionado.
Os usuários podem filtrar registros com base na gravidade e no intervalo de tempo.
Por padrão, os registros são limitados a 50 linhas. Caso o usuário queira ver mais registros, role até a parte de baixo da tela e clique em Mais.
Acessar o Home Graph e executar os testes
Em ACESSO RÁPIDO, clique em Visualizador do Home Graph para abrir o painel Visualizador do Home Graph, onde você encontra os dispositivos que pertencem ao projeto selecionado. Também é possível clicar em Run Test para executar testes para o dispositivo.
Isso iniciará o pacote de testes no navegador com o dispositivo selecionado e pronto para teste. Clique em Start e aguarde os resultados do teste.
Confira os detalhes do teste e visualize os registros depois que todos os testes forem concluídos.
Usar a extensão do Google Home para a depuração do 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.
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 Google Play services Matter módulo são exibidos. Também é possível definir Gravidade para filtrar registros ou Pesquisar a palavra-chave nos registros.
Registro do dispositivo Matter
Em FERRAMENTAS DE REGISTRO DE REGISTRO, clique em Registros do dispositivo para abrir a página Recursos. Selecione Tipo de SoC primeiro:
Depois, selecione o Matter Device:
Em seguida, você pode buscar todos os registros do dispositivo e usar filtros como Gravidade e Pesquisa para encontrar suas informações de interesse.
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.
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 as informações do dispositivo e os 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 sua opinião ou feedback sobre como podemos melhorar a experiência de desenvolvimento com o 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 informar qualquer problema encontrado no Google Home Extension.
- Também incluímos um ícone de feedback na página Recursos.