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. É possível criar dispositivos virtuais, modificar os atributos e estados deles, conferir esses dispositivos em Google Home Graph e importar ou exportar configurações.

Concluir vinculação de conta

Para usar Google Home Playground, é recomendável primeiro vincular 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 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.
5. Clique no botão Autorizar para autorizar a vinculação da conta.

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

Fazer login

Inicie o 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 que você usou no GHA para concluir a vinculação.

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

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

• A lista de dispositivos mostra todos os seus 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 apresentam as informações do dispositivo virtual selecionado. Você também pode editar essas informações e remover o dispositivo virtual selecionado pelo 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

Acessar informações do dispositivo virtual

No painel Lista de dispositivos, selecione o dispositivo virtual que você quer visualizar. No painel Lista de dispositivos, selecione o dispositivo virtual que você quer visualizar. 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.
• Características:características do dispositivo compatíveis.
• Atributos:atributos específicos para a 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 visualizar as informações de um dispositivo virtual, você também pode editar diretamente as informações dele armazenadas em 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 ver as características atualmente compatíveis com o 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 com o dispositivo.
3. Quando terminar de atualizar as características compatíveis, clique em Salvar e as atualizadas serão aplicadas ao Home Graph.
4. Você pode ver essas atualizações de características na Área de registro.

Modificar atributos do dispositivo

1. Selecione a guia Attributes e edite o atributo das características com suporte do dispositivo.
2. Quando terminar de editar, pressione Enter para que as mudanças no atributo sejam aplicadas a Home Graph.
3. Você pode conferir 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 serão aplicadas a Home Graph.
2. Você pode conferir 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 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:
   • Ativada:se o SUV está ativado ou desativado (sem desafio) no dispositivo.
   • Tipo de desafio:se a SUV requer 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 está errado, se é necessário perguntar novamente ao usuário e, se não, o erro para responder.

Identificar dispositivos que ativam o SUV

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

A lista de características a seguir requer SUV:

• ArmDisarm
• LockUnlock
• OpenClose
• Reinicializar
• SoftwareUpdate

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 aquele 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 Remover dispositivo na parte inferior.
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.

Editor de respostas de sincronização

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

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

Importar e exportar dispositivos virtuais

Para solucionar problemas ou reproduzir problemas, exporte os dispositivos virtuais com os estados deles para um arquivo e compartilhe com outras pessoas o arquivo 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 de 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á 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, o Google Home Playground aplica automaticamente a mudança 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, 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 da documentação de referência para saber qual é o formato de cada método.
response	object	Corpo da resposta da chamada de API Home Graph. Consulte a documentação de referência da documentação de referência para saber qual é 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 vai mostrar o tipo de dispositivo atual e a lista de características com suporte do Google Home Playground.

Relatar problemas

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