Google Home Playground

Do Cloud para o Cloud    SDK Local Home    SDK do dispositivo

O Google Home Playground é um aplicativo da Web que simula um projeto de casa inteligente com tipos e características de dispositivos configuráveis. É possível criar dispositivos virtuais, modificar os atributos e estados deles, conferir esses dispositivos em Google Home Graph e importar ou exportar configurações de dispositivos.

Concluir a vinculação de contas

Para usar o Google Home Playground, recomendamos que você primeiro vincule a ferramenta à sua conta. Abra o Google Home app (GHA) no smartphone e siga o processo de vinculação de conta:

  1. Clique no ícone de adição (+) no canto superior esquerdo.
  2. Selecione Configurar dispositivo > Funciona com o Google.
  3. Pesquise a ação intitulada Google Home Playground.
  4. Selecione a ação e o GHA vai direcionar você para a página de login. Clique em Fazer login com o Google e selecione sua conta.
  5. Clique no botão Autorizar para autorizar a vinculação da conta.
Esta figura mostra o fluxo de vinculação de contas do app Google Home para
            conectar o Google Home Playground.

Depois de concluir a vinculação de contas, um conjunto de dispositivos virtuais padrão vai aparecer no GHA para você interagir.

Esta figura mostra a lista de dispositivos padrão que é preenchida quando um usuário
            vincula o Google Home Playground à conta.

Fazer login

Clique no botão abaixo para iniciar o Google Home Playground:

Launch Playground

Clique em Sign in with Google. Faça login com a mesma conta usada no GHA para concluir a vinculação.

Esta figura mostra o estado inicial do Google Home Playground e destaca o botão de login no canto superior direito.

Depois de fazer login, Google Home Playground vai mostrar os dispositivos virtuais armazenados em Home Graph.

Esta figura mostra a lista de dispositivos, as informações do dispositivo e a área de registro da
            visualização padrão do Google Home Playground.

A interface da Web é composta por três painéis:

  • Lista de dispositivos: mostra todos os dispositivos virtuais. É possível selecionar um determinado dispositivo virtual para conferir as informações dele e criar dispositivos virtuais usando esse painel.
  • Informações do dispositivo: apresenta as informações do dispositivo virtual selecionado. Também é possível editar essas informações e remover o dispositivo virtual selecionado pelo painel.
  • A Área de registro mostra os registros de interação entre Google Home Playground e Home Graph. É possível abrir os registros para inspecionar os payloads de solicitação e resposta para resolver problemas.

Dispositivo virtual

Conferir informações do dispositivo virtual

No painel Device list, selecione o dispositivo virtual que você quer acessar. No painel Device list, selecione o dispositivo virtual que você quer acessar. O painel Informações do dispositivo mostra as informações categorizadas em cinco guias:

  • Informações básicas:propriedades de nível superior do dispositivo, incluindo tipo, ID e nome.
  • Atributos:características do dispositivo com suporte.
  • Atributos:atributos específicos da característica do dispositivo.
  • Estados:todos os estados do dispositivo.
  • SUV:configuração da verificação secundária do usuário do dispositivo.

Editar informações do dispositivo virtual

Além de conferir as informações de um dispositivo virtual, você também pode editar diretamente as informações armazenadas em Home Graph no painel Informações do dispositivo.

Modificar características compatíveis

  1. Selecione a guia Atributos e clique no botão Editar.
  2. No painel pop-up, você pode conferir os traços compatíveis com o dispositivo e os que estão disponíveis para adicionar. Use os botões seta (arrow_forward/arrow_back) para adicionar ou remover características compatíveis do dispositivo.
  3. Quando terminar de atualizar os atributos compatíveis, clique em Salvar. Os atributos atualizados serão aplicados a Home Graph.
  4. É possível conferir essas atualizações de atributo na área de registro.
Esta figura mostra a ferramenta de UX para adicionar ou excluir características
            compatíveis em um dispositivo selecionado no Google Home Playground.

Modificar atributos do dispositivo

  1. Selecione a guia Atributos e edite o atributo para as características compatíveis com o dispositivo.
  2. Quando terminar de editar, pressione Enter e as mudanças de atributo serão aplicadas a Home Graph.
  3. É possível conferir esses atributos atualizados na Área de registro.

Modificar estados do dispositivo

  1. Selecione a guia Estados e edite o estado diretamente. As mudanças de estado serão aplicadas a Home Graph.
  2. É possível conferir essas modificações de estado na área de registro.

Adicionar uma verificação secundária do usuário a um dispositivo virtual

É possível adicionar um SUV a dispositivos virtuais e configurar o tipo de desafio e o comportamento correspondente em cada dispositivo. É possível adicionar um SUV a dispositivos virtuais e configurar o tipo de desafio e o comportamento correspondente em cada dispositivo.

Configurar a SUV no dispositivo

  1. No painel Device list, selecione o dispositivo virtual que você quer configurar.
  2. No painel Informações do dispositivo, selecione a guia SUV e configure o seguinte:
    • Ativado:se a SUV está ativada ou desativada (sem desafio) no dispositivo.
    • Tipo de desafio:se o SUV exige um reconhecimento explícito (ackNeeded) ou um número de identificação pessoal (pinNeeded).
    • PIN:o PIN válido.
    • Processamento de PIN incorreto:quando o PIN está errado, é possível pedir novamente ao usuário ou exibir o erro.
Esta figura mostra a ferramenta de UX para ativar as características de verificação
            do usuário secundário em um dispositivo selecionado no Playground do Google
            Nest.

Identificar dispositivos que ativam a SUV

No painel Lista de dispositivos, um ícone de chave chave aparece ao lado de cada dispositivo compatível com SUV.

Esta figura mostra os dispositivos recomendados para ativar a verificação secundária
             do usuário.

A lista de atributos a seguir requer SUV:

Criar um dispositivo virtual

  1. No painel Lista de dispositivos, clique em Adicionar um dispositivo.
  2. No painel pop-up, selecione o tipo de dispositivo e insira o nome do novo dispositivo. Como alternativa, você pode selecionar um conjunto predefinido de dispositivos para adicionar.
  3. Depois de concluir todas as etapas, o novo dispositivo será adicionado a Home Graph.
Esta figura mostra a ferramenta de UX para adicionar um novo tipo de dispositivo no
            Google Home Playground.

Remover um dispositivo virtual

  1. No painel Lista de dispositivos, selecione o dispositivo que você quer remover. Em seguida, no painel Informações do dispositivo, selecione a guia Informações básicas e clique em Ícone da lixeiraRemover dispositivo na parte de baixo.
  2. Confirme a remoção do dispositivo no alerta pop-up.
  3. Depois de confirmar a remoção, o dispositivo será removido de Home Graph.
Esta figura mostra a ferramenta de UX para remover um tipo de dispositivo virtual no
            Google Home Playground.

Editor de resposta de sincronização

É possível validar ou atualizar a resposta de sincronização em Google Home Playground. Clique em Editor de resposta de sincronização para abrir um ambiente de desenvolvimento integrado.

Esta figura mostra o botão para abrir o editor de resposta de sincronização.

Edite ou copie e cole sua resposta de sincronização e clique em Salvar para aplicar as mudanças e conferir como elas funcionam no ecossistema do Google Home.

Esta figura mostra a janela para editar a resposta de sincronização.

Importar e exportar dispositivos virtuais

Para resolver ou reproduzir problemas, exporte seus dispositivos virtuais com os estados deles para um arquivo e compartilhe com outras pessoas para importar e replicar os dispositivos virtuais.

Esta figura mostra a ferramenta de UX para importar e exportar dispositivos
            virtuais no Google Home Playground.

Exportar dispositivos virtuais para um arquivo

  1. Clique em para exportar dispositivos virtuais para um arquivo.
  2. Digite o nome do arquivo que você quer exportar e clique em OK.
  3. Depois de inserir o nome do arquivo, o navegador vai fazer o download do arquivo de dispositivos virtuais exportados.

Importar dispositivos virtuais de um arquivo

  1. Clique em para importar dispositivos virtuais de um arquivo.
  2. Selecione o arquivo que você quer importar e clique em OK.
  3. Depois que você confirmar o arquivo a ser importado, o Google Home Playground importará dispositivos virtuais com estados do arquivo e vai atualizar as informações e os estados dos dispositivos importados em Home Graph.

Inspecionar registros de interação

Quando você interage com os dispositivos virtuais, o Google Home Playground aplica automaticamente a mudança para Home Graph. As interações com Home Graph são gravadas no painel Área de registro, em que você pode expandir cada entrada para inspecionar os payloads de solicitação e resposta da API Home Graph.

Cada entrada de registro é uma matriz JSON, contendo elementos da seguinte estrutura:

{
  "uri": string,
  "request": object,
  "response": object
}
Campos Tipo Descrição
uri string URL da chamada de API Home Graph.
request object Corpo da solicitação da chamada de API Home Graph. Consulte a documentação de referência documentação de referência para conferir o formato de cada método.
response object Corpo da resposta da chamada de API Home Graph. Consulte a documentação de referência documentação de referência para conferir o formato de cada método.

Conferir os tipos e as características de dispositivos compatíveis

O ícone de pergunta ajuda no canto superior direito mostra o tipo de dispositivo atual e a lista de características com suporte do Google Home Playground.

Esta figura mostra a ferramenta de UX para adicionar um novo tipo de dispositivo no
            Google Home Playground.

Informar problemas

Queremos saber sua opinião. Informe os problemas encontrados usando o ícone de ponto de exclamação feedback no canto superior direito.

Esta figura mostra os ícones para enviar feedback e relatar
       problemas no Google Home Playground.