Google Home Playground

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. Você pode criar dispositivos virtuais, modificar os atributos e estados do dispositivo, conferir esses dispositivos em Google Home Graph e importar ou exportar configurações de dispositivo.

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 da conta:

  1. Clique no ícone de mais (+) no canto superior esquerdo.
  2. Selecione Configurar dispositivo > Compatível com o Google.
  3. Pesquise a ação chamada Google Home Playground.
  4. Selecione a ação, e o GHA 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 da conta, um conjunto de dispositivos virtuais padrão será exibido no GHA para você interagir.

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

Fazer login

Para iniciar o Google Home Playground, clique no botão abaixo:

Iniciar o Playground

Clique em Fazer login com o Google. Faça login com a mesma conta que você usou em 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, o app 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 IU da Web tem três painéis:

  • A lista de dispositivos mostra todos os seus dispositivos virtuais. É possível selecionar um determinado dispositivo virtual para ver as informações dele e criar dispositivos virtuais nesse 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 no painel.
  • A Área de registro exibe 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

Ver informações do dispositivo virtual

No painel Device list, selecione o dispositivo virtual que quer acessar. No painel Device list, selecione o dispositivo virtual que quer acessar. O painel Informações do dispositivo mostrará os dados categorizados em cinco guias:

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

Editar informações do dispositivo virtual

Além de visualizar as informações de um dispositivo virtual, você também pode 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, é possível ver as características compatíveis com o dispositivo no momento 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 com o 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. Confira 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 Attributes e edite o atributo das características compatíveis com o dispositivo.
  2. Quando terminar de editar, pressione Enter, e as mudanças de atributo vão ser aplicadas a Home Graph.
  3. Confira esses atributos atualizados na Área de registro.

Modificar estados do dispositivo

  1. Selecione a guia States e edite o estado diretamente. As mudanças de estado vão ser aplicadas a Home Graph.
  2. Confira essas modificações de estado na Área de registro.

Adicionar uma verificação de usuário secundária ao dispositivo virtual

Você pode adicionar um SUV a dispositivos virtuais e configurar o tipo de desafio e o comportamento correspondente em cada dispositivo. Você pode adicionar um SUV a dispositivos virtuais e configurar o tipo de desafio e o comportamento correspondente em cada dispositivo.

Configurar 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 desafios) no dispositivo.
    • Tipo de desafio:se o SUV exige confirmação explícita (ackNeeded) ou número de identificação pessoal (pinNeeded).
    • PIN:o PIN válido.
    • Processamento de PIN incorreto:quando o PIN estiver errado, indica se é necessário perguntar ao usuário novamente e, caso contrário, o erro para responder.
Esta figura mostra a ferramenta de UX para ativar traços de verificação
            de usuário secundários em um dispositivo selecionado no Google Home
            Playground.

Identificar dispositivos que aceitam SUVs

No painel Lista de dispositivos, um ícone de chave é mostrado ao lado de cada dispositivo com SUV.

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

A lista a seguir de características exige 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 vai ser adicionado ao 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, no painel Informações do dispositivo, selecione a guia Informações básicas e clique em Ícone da lixeiraRemover dispositivo na parte inferior.
  2. Confirme a remoção do dispositivo no alerta pop-up.
  3. Depois de confirmar a remoção, o dispositivo vai 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 sua resposta de sincronização em Google Home Playground. Clique em Editor de respostas de sincronização para abrir um ambiente de desenvolvimento integrado incorporado.

A figura mostra o botão para abrir o editor de respostas de sincronização.

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

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

Importe e exporte dispositivos virtuais

Para solucionar problemas ou reproduzir problemas, exporte os dispositivos virtuais com os estados deles para um arquivo e compartilhe esse 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. 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 de confirmar o arquivo a ser importado, o Google Home Playground vai importar dispositivos virtuais com estados do arquivo e atualizar as informações e estados importados em Home Graph.

Inspecionar registros de interação

Quando você interage com os dispositivos virtuais, o Google Home Playground aplica automaticamente sua mudança a Home Graph. As interações com Home Graph são gravadas no painel Área de registro, em que é possível expandir cada entrada para inspecionar os payloads de resposta e solicitação 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 saber 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 saber o formato de cada método.

Ver tipos e características de dispositivos compatíveis

O ícone de ponto de interrogação ajuda no canto superior direito mostra o tipo de dispositivo e a lista de características atuais compatíveis com Google Home Playground.

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

Relatar problemas

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

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