Extensão do Google Home para VS Code

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 ao Google Assistant Simulator, Google Cloud Logging, ao visualizador do Home Graph e a outras ferramentas para simplificar o processo de desenvolvimento do Matter e de casa inteligente.

Extensão do 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, é possível interagir com Assistant Simulator a qualquer momento sem sair do VS Code.

Semelhante ao simulador fornecido no Console do Actions, o Assistant Simulator permite controlar facilmente seus dispositivos digitando as consultas, por exemplo, "Acenda a luz". No VS Code, o 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, envie enunciados em lote ao simulador do Google Assistente executando um script de enunciado. Consulte Executar enunciados em lote para mais detalhes.

Cloud Logging

Cloud Logging fornece informações de depuração e métricas importantes para oferecer 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 Home Graph

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

Instalar a extensão Google Home para VS Code

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

  1. Clique no ícone Extensões na Barra de atividades.
  2. Pesquise 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 Mercado do VS Code.

Fazer o download de Google Home Extension

Configurar a extensão Google Home para VS Code

Depois de instalar Google Home Extension e atualizar o VS Code, você precisa fazer login e selecionar um projeto antes de usar Assistant Simulator e visualizar o Cloud Logging.

Fazer login com o Google e selecionar 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 o 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 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 uma caixa de diálogo Open Visual Studio Code será exibida. Clique em Abrir 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 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, o Google Home Extension carregará seus projetos. Depois, clique em Selecionar um projeto.

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

Usar a extensão Google Home para VS Code

Ver recursos para desenvolvedores

Em AJUDA E FEEDBACK, clique em Primeiros passos e recursos para abrir a página Recursos. Nela, 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 Assistant Simulator no VS Code, clique em SIMULATOR DO GOOGLE ASSISTENTE na barra lateral. Na caixa Mensagem, digite sua consulta e pressione Enter.

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

Usar o simulador do Google Assistente

Executar enunciados em lote

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

  • Clique em para abrir scripts de fala atuais.

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

    Ícones do menu de enunciados do lote

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

  • Clique em para selecionar um script de enunciado 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. Nela, é possível encontrar os registros pertencentes ao projeto selecionado.

Usar o Cloud Logging.

Os usuários podem filtrar os 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 inferior e clique em Mais.

Mostrar mais registros

Conferir 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 poderá encontrar dispositivos que pertencem ao projeto selecionado. Você também pode clicar em Run Test para executar testes no dispositivo.

Visualizador do Home Graph

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

Pacote de testes do Google Home

Você pode conferir os detalhes do teste e visualizar os registros depois que todos os testes forem concluídos.

Resultados do teste

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 nos enviar suas 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 disponibilizamos um ícone de feedback na página Recursos.