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>
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.
- 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 respostaIDENTIFY
precisa corresponder a um dosotherDeviceIds
da respostaSYNC
. - 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óriodist
: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.
- Faça upload do JavaScript segmentado para Node.js: faça upload do arquivo
bundle.js
do diretóriodist/node
. - Faça upload do JavaScript segmentado pelo Chrome (navegador): faça upload do
arquivo
bundle.js
do diretóriodist/web
.
- Faça upload do JavaScript segmentado para Node.js: faça upload do arquivo
- 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.