De nuvem para nuvem SDK do Local Home
O Google Home Test Suite é um aplicativo da Web que permite para testar sua ação de casa inteligente. O Test Suite gera e executa automaticamente casos de teste com base nos dispositivos e nas características associadas à sua conta. Ao concluir os testes, você pode conferir os resultados ou preencher o formulário de envio para enviar os resultados ao Google.
Os testes executados pelo Test Suite incluem, mas não são são limitados a:
Verifica se o Estado do relatório e A sincronização de solicitações foi implementada na sua dispositivos e características.
Verifica se a intent QUERY está implementada para o dispositivo e se os resultados dela correspondem aos resultados do estado do relatório.
Clique no botão para iniciar a ferramenta Test Suite abaixo:
Testar uma ação por conta própria
A seção a seguir descreve como executar o Test Suite em seu dispositivo e projeto de ação de casa inteligente. O Test Suite exige que você faça login para inspecionar os dispositivos na sua Google Home Graph e enviar comandos diretamente para Google Assistant
Para fazer o autoteste da ação, siga estas etapas:
- No navegador da Web, abra o Test Suite
Faça login no Google usando o botão do canto superior direito.
Configure os Detalhes do projeto:
- No campo ID do projeto, insira o identificador do projeto Ação de casa inteligente.
- Clique em Próxima.
Defina as configurações de teste:
- Ao certificar sua ação de casa inteligente, mantenha o padrão O valor de Estado do relatório/tempo limite de sincronização da solicitação não foi alterado. No entanto, para teste, será possível alterar o valor de tempo limite se o agente demorar mais para informar o estado para o Home Graph.
Para certificar sua ação de casa inteligente, confira se a Sincronização de solicitação de teste estiver ativada. Durante o teste, será solicitado que você adicione, atualizar ou remover um dispositivo e verificar se a lista de dispositivos mudou em Gráfico de Início. As ações de mudança ocorrem pela integração que você está testando. A integração em teste precisa ter pelo menos um dispositivo associado ao usuário do agente.
Se você estiver usando uma característica Scene, selecione Característica da cena de teste.
Se você estiver executando o pacote de testes para dispositivos do Local Home, selecione Oferece suporte ao SDK local do Google Home.
- Selecione Fulfillment local ou Configuração integrada.
- Clique em Compatível com consulta local se o dispositivo puder processar a intent QUERY localmente.
Faça uma execução de teste e confira os resultados:
- Clique em Próxima para começar a executar os testes. A interface mostra os dispositivos e características que estão sendo testadas.
Acesse a página Resultados e envio:
- Quando os testes forem concluídos, clique em Próxima para ver os resultados.
Os resultados incluem o número de testes aprovados e reprovados e um resultado que indica a porcentagem de passes.
Teste de validação da vinculação de contas
A vinculação de contas desempenha um um papel importante no ecossistema de casa inteligente do Google. Vinculação de contas O teste de validação em Test Suite verifica se há possíveis problemas.
O teste de validação de vinculação de contas tem testes para validar tokens de acesso. e atualizar tokens:
Teste de validação do token de acesso
Os tokens de acesso retornados do seu endpoint de troca de tokens são testados para garantir elas têm um formato válido e são retornadas com um token de atualização válido.
Itens de teste | Explicação |
---|---|
Verificar se o token de acesso está no formato JWT | A vinculação da Conta do Google não recomenda tokens de acesso ao formato JWT. Se um
formato JWT for encontrado, e o seguinte aviso será exibido:
The access token seems to be JWT, this is not good. Because it
unnecessarily exposes information about partner implementation and we
recommend opaque symmetric encrypted access token.
|
Verifique se o token de acesso com expiração tem um token de atualização. | Um token de atualização precisará ser fornecido quando o token de acesso for expirável. O teste falhará se nenhum token de atualização for encontrado. |
Teste de validação do token de atualização
Os tokens de atualização são testados para garantir que o endpoint de troca de tokens está correto e as troca por novos tokens de acesso.
Itens de teste | Explicação |
---|---|
Token de atualização com token de atualização inválido, verificando a resposta do parceiro. | Seu servidor deve retornar um erro HTTP 400 Solicitação inválida com
{"error": "invalid_grant"} a uma solicitação de token de atualização inválida.
Se a resposta não corresponder ao "código ou mensagem de erro", esse caso de teste
vai falhar. Visite
troque tokens de atualização por tokens de acesso para mais informações. |
Teste se o token de acesso foi atualizado após a atualização do token. | Novos tokens de acesso precisam ser retornados em resposta a solicitações de atualização de token. Se seu servidor fornecer o mesmo token de acesso, o caso de teste falhar. |
Verifique se o token de acesso não expirado ainda é válido. | O prazo de validade do token de acesso será exibido. |
Verifique se o token de atualização foi rotacionado durante a atualização. | Verificamos se os tokens de atualização são alterados após uma solicitação de token de atualização. Se o token de atualização mudar, seu servidor só deverá invalidar uma atualização token após o uso de um novo token de atualização, para evitar disputas isso pode interromper a vinculação da conta de um usuário. O teste vai falhar se você invalidar o token de atualização antigo antes de usar o novo. |
Mensagens de erro
A tabela a seguir lista algumas mensagens de erro comuns que você pode encontrar e as maneira sugerida de resolvê-los.
Mensagem de erro | Como resolver |
---|---|
A API HomeGraph não foi usada no projeto <_id_> antes ou está desativado | Verifique se você ativou a API HomeGraph. |
Entidade solicitada não encontrada | Verifique se o agentUserId é válido e está vinculado à sua
serviço. |
Verifique se você tem a permissão Erro ao receber dados do módulo: erro getModuleData: resposta de falha de HTTP para https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
Enviar os resultados do teste
Seus resultados de Test Suite precisam ser aprovados em 100% dos testes antes enviando seu formulário de certificação. Se você tem alguma característica que exija teste manual, execute a ferramenta Test Suite e anexar o resultado mesmo que não tenha alcançado 100%.
Para enviar os resultados do teste e certificar sua ação de casa inteligente, faça o seguinte: siga estas etapas:
- Depois de receber os resultados do teste, e você estiver pronto para certificar seus aplicativos home, clique em Submit na ferramenta Test Suite.
- Clique no botão FAZER O DOWNLOAD DOS RESULTADOS DE TESTE para recuperar os resultados.
- Clique em ACESSAR FORMULÁRIO DE ENVIO para enviar os resultados do teste ao Google.
Preencha todos os campos obrigatórios e clique em Enviar.