Google Home Playground

SDK do dispositivo

O Google Home Playground é um aplicativo da Web que permite simular um projeto de casa inteligente, simulando uma casa virtual com tipos e características configuráveis de dispositivo. O Google Home Playground permite que você crie dispositivos virtuais, modifique os atributos e estados do dispositivo, visualize esses dispositivos em Google Home Graph e importe ou exporte configurações do dispositivo.

Conclua a vinculação da conta

Para usar Google Home Playground, é recomendável vincular primeiro a ferramenta à sua conta. Abra o Google Home app (GHA) no seu smartphone e siga o processo de vinculação da conta:

1. Clique no ícone de adição (+) no canto superior esquerdo.
2. Selecione Configurar dispositivo > Compatível com o Google.
3. Pesquise a ação 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 para fazer login.
5. Clique no botão Autorizar para autorizar a vinculação da conta.

Depois de concluir a vinculação da conta, você verá um conjunto de dispositivos virtuais padrão no GHA.

Fazer login

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

Abrir o Playground

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

Depois que você fizer login, Google Home Playground mostrará os dispositivos virtuais armazenados em Home Graph.

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

• Lista de dispositivos mostra todos os seus dispositivos virtuais. Você pode selecionar um determinado dispositivo virtual para visualizar as informações dele e criar dispositivos virtuais por meio desse 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 por meio do 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 Lista de dispositivos, selecione o dispositivo virtual que você quer ver. O painel Informações do dispositivo exibirá as informações categorizadas em cinco guias:

• Informações básicas: propriedades de nível superior do dispositivo, incluindo tipo, código e nome do dispositivo.
• Características: características compatíveis do dispositivo.
• Atributos: atributos específicos do traço do dispositivo.
• Estados: todos os estados do dispositivo.
• SUV: configuração de verificação de usuário secundária 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 em Home Graph por meio do painel Informações do dispositivo.

Modificar características compatíveis

1. Selecione a guia Traits e clique no botão Edit.
2. No painel pop-up, você pode ver as características atualmente compatíveis com o dispositivo e as disponíveis para adição. Use os botões de seta (arrow_forward/arrow_back) para adicionar ou remover traços compatíveis com o dispositivo.
3. Quando terminar de atualizar as características compatíveis, clique em Salvar. As características atualizadas serão aplicadas a Home Graph.
4. Você pode ver essas atualizações de características na área de registro.

Modificar atributos do dispositivo

1. Selecione a guia Informações básicas/atributos e edite o atributo para as características compatíveis com o dispositivo.
2. Quando terminar de editar, pressione Enter, e as alterações de atributos serão aplicadas a Home Graph.
3. Veja 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. Você pode ver essas modificações de estado na área de registro.

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

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

Configurar 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 o SUV está ativado ou desativado (sem desafio) no dispositivo.
   • Tipo de desafio: se o SUV exige reconhecimento explícito (ackNeeded) ou número de identificação pessoal (pinNeeded).
   • PIN: o PIN válido
   • Manipulação de PIN incorreto: quando o PIN estiver incorreto, pergunte ao usuário novamente e, se não estiver, o erro para responder.

Identificar dispositivos que ativam o SUV

No painel Lista de dispositivos, um ícone de chave chave é exibido ao lado de cada dispositivo habilitado para SUV.

A lista de características a seguir exige SUV:

• ArmDisarm (em inglês)
• LockUnlock (link em inglês)
• OpenClose (link em inglês)
• Reinicializar
• Atualização de software

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.

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 Remover dispositivo na parte inferior.
2. Confirme a remoção do dispositivo no alerta pop-up.
3. Depois que você confirmar a remoção do dispositivo, ele será removido de Home Graph.

Importar e exportar dispositivos virtuais

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

Exportar dispositivos virtuais para um arquivo

1. Clique em file_download 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 fará o download do arquivo dos dispositivos virtuais exportados.

Importar dispositivos virtuais de um arquivo

1. Clique em upload_file 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 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, o Google Home Playground aplica automaticamente sua alteração ao 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 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 de API Home Graph. Consulte a documentação de referência para ver o formato de cada método.
response	object	Corpo de resposta da chamada de API Home Graph. Consulte a documentação de referência para ver o formato de cada método.

Ver as características e os tipos de dispositivo compatíveis

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

Problemas com feedback e relatórios

Queremos saber sua opinião. Envie seu feedback clicando no ícone de carinha sentiment_satisfaction no canto superior direito ou relate problemas encontrados usando o ícone de ponto de exclamação feedback.