Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph , and import or export device configurations.
Conclua a vinculação da conta
Para usar Home Playground, é recomendável primeiro vincular a ferramenta à sua conta. Abra o Google Home app (GHA) on your phone, and go through the account linking process:
- Clique no ícone de adição no canto superior esquerdo.
- Selecione Configurar dispositivo > Compatível com o Google.
- Pesquise a ação Google Home Playground.
- 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.
- Clique no botão Autorizar.

s de concluir a vinculação da conta, um conjunto de dispositivos virtuais padrão será exibido no GHA para você interagir.

Fazer login
Inicie o Home Playground clicando no botão abaixo:
Clique em Sign in with Google. Faça login com a mesma conta que você usou em GHA para concluir a vinculação da conta.

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

A IU da Web consiste em três painéis:
- A lista de dispositivos mostra todos os seus dispositivos virtuais. Selecione um determinado dispositivo virtual para visualizar as informações dele e criar dispositivos virtuais usando esse painel.
- As informações do dispositivo apresentam 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 exibe os registros de interação entre 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 mostra as informações categorizadas em cinco guias:
- Informações básicas:propriedades de nível superior do dispositivo, incluindo tipo, ID e nome do dispositivo.
- Atributos:características do dispositivo que podem ser usadas.
- Atributos:características específicas do dispositivo.
- Estados:todos os estados do dispositivo.
- SUV:configuração da verificação de usuário secundária do dispositivo.
Editar informações do dispositivo virtual
Além de ver as informações de um dispositivo virtual, você também pode editar diretamente as informações armazenadas em Home Graph pelo painel Informações do dispositivo.
Modificar as características compatíveis
- Selecione a guia Tratas e clique no botão Editar.
- No painel pop-up, você pode ver as características compatíveis com o dispositivo e
as opções disponíveis para adicionar. Use os botões arrow
(arrow_forward/arrow_back) para adicionar ou remover características compatíveis com o dispositivo. - Quando terminar de atualizar as características compatíveis, clique em Salvar, e as características atualizadas serão aplicadas a Home Graph.
- Veja essas atualizações de traços na área de registros.

Modificar atributos do dispositivo
- Selecione a guia Basic Information/Attributes e edite o atributo para as características compatíveis com o dispositivo.
- Quando terminar de editar, pressione Enter para aplicar as alterações de atributo ao Home Graph.
- É possível ver esses atributos atualizados na área de registro.
Modificar estados do dispositivo
- Selecione a guia States (Estados) e edite o estado diretamente. As mudanças de estado serão aplicadas a Home Graph.
- É possível visualizar essas modificações de estado na Área de registro.
Adicionar uma verificação de usuário secundária ao dispositivo virtual
É possível adicionar um SUV a dispositivos virtuais e configurar o tipo de desafio e o comportamento correspondente em cada um deles.
Configurar SUV no dispositivo
- No painel Lista de dispositivos, selecione o dispositivo virtual que você quer configurar.
- 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 uma confirmação explícita (ackNeeded) ou um número de identificação pessoal (pinNeeded).
- PIN:o PIN válido
- Tratamento do PIN incorreto:se o PIN estiver incorreto, pergunte ao usuário novamente e, se não, o erro para responder.

Identificar dispositivos que permitem a exibição de SUVs
No painel Lista de dispositivos, um ícone de chave chave é exibido ao lado de cada dispositivo ativado para SUV.

A lista de características a seguir exige SUV:
- ArmDisarm (link em inglês)
- LockUnlock (em inglês)
- OpenClose.
- Reiniciar
- Atualização de software
Criar um novo dispositivo virtual
- No painel Lista de dispositivos, clique em Adicionar um dispositivo.
- No painel pop-up, selecione o tipo de dispositivo e insira o nome do seu novo dispositivo. Também é possível selecionar um conjunto predefinido de dispositivos.
- Depois de concluir todas as etapas, o novo dispositivo vai ser adicionado ao Home Graph.

Remover um dispositivo virtual
- 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.
- Confirme a remoção do dispositivo no alerta pop-up.
- Depois que você confirmar a remoção do dispositivo, ele vai ser removido de Home Graph.

Importar e exportar dispositivos virtuais
Para solucionar problemas ou reproduzir problemas, você pode exportar os dispositivos virtuais com os estados deles para um arquivo e compartilhar com outras pessoas o arquivo para importar e replicar os dispositivos virtuais.

Exportar dispositivos virtuais para um arquivo
- Clique em para exportar dispositivos virtuais para um arquivo.
- Digite o nome do arquivo que você quer exportar e clique em OK.
- Depois de inserir o nome do arquivo, o navegador fará o download do arquivo dos dispositivos virtuais exportados.
Importar dispositivos virtuais de um arquivo
- Clique em para importar dispositivos virtuais de um arquivo.
- Selecione o arquivo que você quer importar e clique em OK.
- Depois de confirmar o arquivo a ser importado, o Home Playground importará os 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, 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 Home Graph da API.
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 da 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 help no canto superior direito exibirá o tipo de dispositivo e a lista de traços compatíveis com o Home Playground.

Problemas e feedback no relatório
Queremos saber sua opinião. Para enviar feedback, clique no ícone de rosto sorridente sentiment_satisfaction no canto superior direito ou denuncie problemas encontrados usando o ícone de ponto de exclamação feedback.
