Google Home Playground

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, visualizar esses dispositivos em Google Home Graph e importar ou exportar configurações de dispositivos.

Concluir a vinculação da conta

Para usar 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 contas descrito em Conectar dispositivos de casa inteligente de terceiros no app Google Home.

  1. Pesquise a integração intitulada Google Home Playground.
  2. Selecione a integração. O GHA vai direcionar você para a página de login. Clique em Fazer login com o Google e selecione sua conta para fazer login.
  3. 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 da conta, um conjunto de dispositivos virtuais padrão será mostrado 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 dele.

Fazer login

Inicie Google Home Playground clicando no botão abaixo:

Iniciar o Playground

Clique em Fazer login com o Google. Faça login com a mesma conta usada no GHA para concluir a vinculação da conta.

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 registros da
            visualização padrão do Google Home Playground.

A interface da Web consiste em três painéis:

  • A lista de dispositivos mostra todos os dispositivos virtuais. É possível selecionar um 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 expandir os registros para inspecionar os payloads de solicitação e resposta para solução de problemas.

Dispositivo virtual

Conferir informações do dispositivo virtual

No painel Lista de dispositivos, selecione o dispositivo virtual que você quer conferir. No painel Lista de dispositivos, selecione o dispositivo virtual que você quer conferir. O painel Informações do dispositivo vai mostrar as informações categorizadas em cinco guias:

  • Informações básicas:propriedades de nível superior do dispositivo, incluindo tipo, ID e nome.
  • Características:características compatíveis do dispositivo.
  • Atributos:atributos específicos da característica do dispositivo.
  • Estados:todos os estados do dispositivo.
  • SUV: Verificação Secundária do Usuário configuração de dispositivo.

Editar informações do dispositivo virtual

Além de conferir as informações de um dispositivo virtual, também é possível editar diretamente as informações armazenadas no Home Graph pelo painel Informações do dispositivo.

Modificar características compatíveis

  1. Selecione a guia Características e clique no botão Editar.
  2. No painel pop-up, você pode conferir as características compatíveis do dispositivo e as características disponíveis para adicionar. Use os botões de seta (arrow_forward/arrow_back) para adicionar ou remover características compatíveis do dispositivo.
  3. Quando terminar de atualizar as características compatíveis, clique em Salvar, e as características atualizadas serão aplicadas a Home Graph.
  4. É possível conferir essas atualizações de características 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 das características compatíveis com o dispositivo.
  2. Depois de terminar a edição, 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 ao dispositivo virtual

É possível adicionar uma SUV a dispositivos virtuais e configurar o tipo de desafio e o comportamento correspondente em cada dispositivo. É possível adicionar uma 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 Lista de dispositivos, 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 a SUV exige confirmação explícita (ackNeeded) ou número de identificação pessoal (pinNeeded).
    • PIN:o PIN válido.
    • Como lidar com o PIN incorreto:quando o PIN está errado, se o usuário deve ser solicitado novamente e, caso contrário, o erro a ser respondido.
Esta figura mostra a ferramenta de UX para ativar características de verificação do usuário secundário em um dispositivo selecionado no Google Home Playground.

Identificar dispositivos que ativam a SUV

No painel Lista de dispositivos, um ícone de chave key aparece ao lado de cada dispositivo ativado pela SUV.

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

A lista de características a seguir exige a SUV:

Criar um novo 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 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 do dispositivo, ele 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 incorporado.

Esta figura mostra o botão para abrir o editor de respostas síncronas.

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

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

Importar e exportar dispositivos virtuais

Para solucionar problemas ou reproduzir problemas, é possível exportar os dispositivos virtuais com os estados deles para um arquivo e compartilhar o arquivo 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. Insira 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 de confirmar o arquivo a ser importado, Google Home Playground vai importar dispositivos virtuais com estados do arquivo e 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, Google Home Playground aplica automaticamente a mudança a Home Graph. As interações com Home Graph são registradas no painel Área de registro, em que é possível expandir cada entrada para inspecionar os payloads de solicitação de API e resposta da API Home Graph.

Cada entrada de registro é uma matriz JSON que contém 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 da API Home Graph. Consulte a documentação de referência documentação de referência para 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 o formato de cada método.

Conferir tipos e características de dispositivos compatíveis

O ícone de ajuda de ponto de interrogação no canto superior direito vai mostrar o tipo de dispositivo atual e a lista de características compatíveis com 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 denunciar problemas no Google Home Playground.