Esta é a Central do desenvolvedor do Google Home, o novo destino para aprender a desenvolver ações de casa inteligente. Observação:você continuará criando ações no Console do Actions.

Esta página foi traduzida pela API Cloud Translation.

Switch to English

Testar e depurar o app

Recomendamos que você crie seu app de fulfillment local usando as etapas descritas anteriormente e, em seguida, teste a integração da casa inteligente no seu próprio ambiente de hospedagem seguindo estas etapas:

No seu próprio ambiente de hospedagem, disponibilize a página HTML que executa o app de fulfillment local. O snippet a seguir mostra um exemplo de arquivo HTML estático que executa o app de fulfillment local.

<html>
  <head>
    <!-- Local Home SDK -->
    <script src="//www.gstatic.com/eureka/smarthome/smarthome_sdk.js"></script>
    <!-- Local app under development -->
    <script src="local_execution.js"></script>
  </head>

</html>

Teste o controle do dispositivo.
Depurar no Chrome. Use pontos de interrupção e registros para resolver problemas de integração.
Modifique e compile o código do TypeScript. Depois, repita essas etapas.

Ao repetir esse processo de compilação e teste, você pode ver as mudanças em ação de forma rápida e fácil para detectar e depurar problemas no código.

Testar o controle do dispositivo

No console da ação, você precisa especificar o URL do app da Web, que veicula o HTML carregado no dispositivo Google Home ou Google Nest durante o fulfillment local.

Para testar o controle do dispositivo com o fulfillment local, siga estas etapas:

Chrome

Abra seu projeto de casa inteligente no Console do Actions.
Na navegação à esquerda, clique em Ações.
Em Configurar o SDK local do Google Home (opcional) > Insira seu URL de teste para o Chrome, especifique o URL do servidor de desenvolvimento que veicula o HTML que executa seu app de fulfillment local.
Clique em Salvar. Pode levar até 30 minutos para o Google propagar as mudanças no console.
Reinicie o dispositivo Google Home ou Google Nest de teste.
Emita um comando para o dispositivo inteligente. Por exemplo, se o dispositivo implementar a característica OnOff, você poderá dizer "Ok Google, acenda as luzes".

Node.js

Abra seu projeto de casa inteligente no Console do Actions.
Na navegação à esquerda, clique em Ações.
Em Configurar o SDK local do Google Home (opcional) > Insira o URL de teste para o Node, especifique o URL do servidor de desenvolvimento que exibe o JavaScript que executa seu app de fulfillment local.
Clique em Salvar. Pode levar até 30 minutos para o Google propagar as mudanças no console.
Reinicie o dispositivo Google Home ou Google Nest de teste.
Emita um comando para o dispositivo inteligente. Por exemplo, se o dispositivo implementar a característica OnOff, você poderá dizer "Ok Google, acenda as luzes".

Para mais detalhes sobre qual ambiente de execução é usado pelo dispositivo, consulte Dispositivos com suporte.

Como depurar do Chrome

É possível depurar seu app de fulfillment local usando o Chrome DevTools. Antes de depurar, verifique se o ambiente está configurado corretamente:

você definiu seu URL de desenvolvimento no console como um URL acessível pelo dispositivo Google Home ou Google Nest (na rede local ou pela Internet);
A máquina está conectada à mesma rede local do dispositivo Google Home ou Google Nest que você está testando.
Sua rede não bloqueia pacotes entre dispositivos.
Você fez login com a mesma Conta do Google no Console do Actions e no dispositivo Google Home ou Google Nest.
Você atualizou a resposta SYNC no seu fulfillment da nuvem. Precisa retornar pelo menos um valor válido no campo otherDeviceIds.
Você inseriu as informações de configuração de verificação corretas no Console do Actions.

Para conectar seu app de fulfillment local ao depurador do Chrome DevTools, siga estas etapas:

Chrome

Na máquina de desenvolvimento local, instale e inicie o navegador Google Chrome.
No campo de endereço do navegador Chrome, inicie o inspetor do Chrome inserindo: chrome://inspect#devices. Uma lista de dispositivos vai aparecer na página, e o arquivo HTML vai aparecer abaixo do nome do dispositivo Google Home ou Google Nest de teste.
Clique no link de inspeção azul abaixo do HTML para iniciar o Chrome DevTools. Alterne para a guia Console. A plataforma local do Home exibe a versão do seu app e do SDK local no registro do console. Se você vir o registro, isso significa que o Google carregou seu app com sucesso e pode se conectar a ele. Caso contrário, reinicie o dispositivo Google Home ou Google Nest.

Node.js

Na máquina de desenvolvimento local, instale e inicie o navegador Google Chrome.
Determine o endereço IP local do dispositivo de teste.
No campo de endereço do navegador Chrome, inicie o inspetor do Chrome inserindo: chrome://inspect#devices.
Selecione Configurar... para abrir as Configurações de descoberta de destino.

Figura 2: configurações de descoberta de destino em chrome://inspect.

Digite DEVICE_IP_ADDRESS:9222 na lista e clique em Concluído.
Clique no link azul de inspeção abaixo do script para iniciar o Chrome DevTools. Alterne para a guia Console. A plataforma local do Home exibe a versão do seu app e do SDK local no registro do console. Se você vir o registro, isso significa que o Google carregou seu app com sucesso e pode se conectar a ele. Caso contrário, reinicie o dispositivo Google Home ou Google Nest.

Para saber mais sobre qual ambiente de execução é usado pelo dispositivo, consulte Dispositivos compatíveis.

Dicas de depuração

Algumas coisas adicionais a serem consideradas durante a depuração incluem:

Não vincule vários dispositivos Google Home ou Google Nest à conta de teste na mesma rede local. Não será possível controlar qual dispositivo Google Home ou Google Nest é segmentado com os comandos de fulfillment local.
Atualize a página no Chrome DevTools para recarregar o contêiner do app de fulfillment local com o código mais recente do URL de desenvolvimento. Isso não redefine a plataforma Local Home, o que pode ser necessário para acionar novamente as intents da plataforma (como IDENTIFY) no app de fulfillment local. Para redefinir a plataforma local do Home, reinicie o dispositivo Google Home ou Google Nest.
Verifique se o app JavaScript carrega sem erros. Para isso, verifique a seção do console da página do DevTools. Se houver um problema, você verá uma mensagem como esta: Uncaught TypeError: Cannot read property ‘open’ of null.
O verificationId da resposta IDENTIFY precisa corresponder a um dos otherDeviceIds da resposta SYNC.
Para o gerenciador EXECUTE, verifique se os comandos HTTP, TCP ou UDP podem ser recebidos pelo dispositivo e funcionar conforme o esperado.
Retorne um Promise dos gerenciadores.
Evite manter o estado global na memória. Consulte Ciclo de vida do aplicativo.
Os erros gerados pelo app de fulfillment local vão aparecer nos registros de erros do projeto.

Preparar e lançar para produção

Para iniciar a ação de casa inteligente, siga estas etapas:

Abra um terminal. No diretório do projeto, execute o comando npm run build. Esse comando gera os seguintes pacotes JavaScript para seu app no diretório dist:
```
project-directory/
└── dist
 ├── web
 │    └── bundle.js
 └── node
      └── bundle.js
```
No console, faça upload do seu app JavaScript clicando em Desenvolver > Ações. Na seção Configurar o SDK local do Home, clique em Fazer upload de arquivos JavaScript.

Figura 3: upload do app JavaScript.
Na caixa de diálogo Fazer upload de arquivos, faça o upload dos arquivos de pacote que você gerou anteriormente. Faça upload das duas versões dos arquivos do pacote (nó e Web) para que a ação seja configurada para funcionar corretamente em todos os ambientes de execução compatíveis com o fulfillment local.
1. Faça upload do JavaScript segmentado para Node.js: faça upload do arquivo bundle.js do diretório dist/node.
2. Faça upload do JavaScript segmentado pelo Chrome (navegador): faça upload do arquivo bundle.js do diretório dist/web.
Teste a ação em um dispositivo com Google Assistente para verificar se ela se comporta como esperado em um ambiente de produção. Para saber mais, consulte Testar e compartilhar a ação de casa inteligente.
Quando estiver tudo certo com a forma como a ação funciona, envie-a ao Google para implantação na produção, seguindo as instruções em Iniciar ação de casa inteligente. Isso inclui a conclusão das etapas de solicitação de autoteste e certificação.

Implementar o app de fulfillment local