App de exemplo do Google Home para casos

App de exemplo do Google Home para Matter

O Google Home Sample App for Matter usa o Google Home Mobile SDK para criar um app Android semelhante ao Google Home app (GHA). Este app de exemplo oferece os seguintes recursos:

  • Fazer o provisionamento de dispositivos Matter físicos e virtuais para a estrutura local do Android
  • Fazer o comissionamento de dispositivos físicos e virtuais em uma estrutura de desenvolvimento
  • Controlar dispositivos na sua plataforma de desenvolvimento, por exemplo, acender uma luz
  • Com os recursos de vários administradores, é possível compartilhar dispositivos na estrutura de desenvolvimento com outros apps e, inversamente, incluir na estrutura de desenvolvimento dispositivos compartilhados de outros apps.
  • Utilitários para desenvolvedores

Neste guia, descrevemos como instalar o APK do Sample App for Matter e usar para comissionar, controlar e compartilhar dispositivos Matter.

Para baixar o código-fonte, aprenda a integrar o Mobile SDK e personalizar telas no Android Studio. Confira nosso codelab Sample App for Matter.

Acesse o codelab Sample App for Matter

Pré-requisitos

Não é necessário um hub, por exemplo, um Google Nest Hub (2nd gen), para comissionar e controlar dispositivos com o Sample App for Matter.

Instalar

  1. Acesse a seção "Releases" no repositório Sample App for Matter do GitHub. Para a versão mais recente, localize na seção "Recursos" o APK chamado GHSAFM-version-default-debug.apk. Não selecione o targetcommissioner.

  2. Instale o Android Debug Bridge (adb):

    Instalar o adb

  3. Conecte seu dispositivo Android com USB e ative a Transferência de arquivos. Em seguida, instale o APK:

    $ adb unroot && adb install GHSAFM-version-default-debug.apk
    

Configurar dispositivos

Ao iniciar o app de exemplo pela primeira vez, você vai receber uma caixa de diálogo com um link para o codelab Sample App for Matter. Se você selecionar Não mostrar esta mensagem novamente, poderá trazer a caixa de diálogo de volta a qualquer momento atualizando suas preferências na seção "Administrador" do app.

Nas próximas etapas, você vai adicionar um dispositivo Matter à estrutura local do Android, além de uma estrutura de desenvolvimento local apenas para o app de exemplo.

O que são tecidos Matter?

App de exemplo do Google Home para Matter

Um Matter fabric é um domínio compartilhado de confiança entre dispositivos em uma rede doméstica que permite que eles se comuniquem entre si.

Os dispositivos podem ter uma ou mais estruturas que correspondem a uma plataforma, um app ou um grupo de dispositivos que interagem entre si. As estruturas têm um ID exclusivo, e os dispositivos compartilham o mesmo conjunto de credenciais e autoridade certificadora (AC). Essas credenciais são atribuídas durante o Matter comissionamento.

Para comissionar um dispositivo Matter, siga estas etapas:

  1. Toque no botão Adicionar dispositivo para iniciar o processo de inclusão.

    Adicionar dispositivo

  2. Em seguida, o controle é transferido para Google Play services, que é iniciado em uma chamada para Mobile SDK. Para estabelecer a prova de posse, toque em Ler QR code ou Usar código de pareamento.

    Ler QR code

  3. Quando o comissionamento for concluído, insira um Nome do dispositivo e toque em Concluído.

Seu dispositivo agora está conectado ao Local Android e ao desenvolvimento.

Todo o trabalho de provisionamento e as telas associadas são processados por Play services ao provisionar dispositivos. Isso oferece uma experiência de usuário consistente e elimina a necessidade de processar permissões sensíveis, como credenciais de Wi-Fi e Thread.

Controlar dispositivos

A estrutura de desenvolvimento cria as credenciais para controlar dispositivos Matter diretamente do app de exemplo.

Na tela inicial, é possível ativar ou desativar o dispositivo. Toque nele para acessar os detalhes.

Dispositivo adicionado

Dispositivos compartilhados

O compartilhamento de um dispositivo é chamado de fluxo de vários administradores na especificação Matter. Depois que um dispositivo é comissionado para o app de exemplo, é fácil compartilhá-lo com outros ecossistemas.

Para compartilhar seu dispositivo Matter com outros ecossistemas, você precisa ter outra plataforma instalada no seu dispositivo Android. Essa plataforma externa se torna o comissário de destino. Criamos outra instância do app de exemplo que você pode usar como comissário de destino.

  1. Acesse a seção "Releases" no repositório Sample App for Matter do GitHub. Para a versão mais recente, localize na seção "Recursos" o APK chamado GHSAFM-version-targetcommissioner-debug.apk. Não selecione o default.

  2. Instale o comissário de destino.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
    
  3. Na tela inicial, toque no dispositivo para mostrar as informações dele. Toque em Compartilhar.

    Compartilhar dispositivo

O app de exemplo chama a API Share Mobile SDK e, mais uma vez, o controle é transferido para Play services.

Uma tela de compartilhamento vai aparecer, permitindo que você escolha o app ou a plataforma que quer parear com o dispositivo. Essa tela oferece duas maneiras de compartilhar o dispositivo:

  1. Manualmente, usando um código de configuração para compartilhar com o app de comissário de destino
  2. Com um app Android local registrado como um comissário de Matter

O app comissário de destino é rotulado como GHSAFM-TC. Toque nesta instância do app de exemplo para compartilhar seu dispositivo.

Em seguida, o app externo (comissário de destino) conclui o provisionamento do dispositivo na própria estrutura.

Configurações

Na tela inicial, clique no ícone de configurações . Aqui você tem as opções de atualizar as preferências do usuário, receber ajuda e saber mais sobre o app.

Configurações

Notificação de meia página

Na tela "Configurações", é possível desativar as notificações proativas de descoberta de comissões para dispositivos Matter.

Se o aplicativo fornecer o próprio fluxo de descoberta ou comissionamento de Matter, talvez seja melhor suprimir essas notificações para evitar interrupções. Consulte Suprimir notificações de descoberta comissionáveis para mais informações.

Utilitários para desenvolvedores

Na tela "Configurações", também é possível acessar Utilitários do desenvolvedor.

Para revisar o conteúdo dos repositórios Device e User Preferences DataStore no Logcat, siga estas etapas:

  1. Clique em Conteúdo dos repositórios de registros.

  2. Clique em OK na caixa de diálogo e marque Logcat.

Feedback e ajuda

Para enviar suas ideias ou feedback sobre como podemos melhorar a experiência de desenvolvimento com Sample App for Matter, preencha nosso formulário de feedback.

Envie seu feedback

Se você estiver com problemas com o Sample App for Matter, siga as etapas para verificar seu ambiente:

Se você tiver dúvidas sobre como usar o app de exemplo ou encontrar um bug no código, envie um problema para o Issue Tracker no repositório do GitHub:

Para receber orientações oficiais do Google sobre questões técnicas, use o fórum de desenvolvedores de casa inteligente:

Para receber suporte técnico da comunidade, use a tag google-smart-home no Stack Overflow: