App de exemplo do Google Home para Matter

App de exemplo do Google Home para o 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:

  • Comissionar dispositivos Matter físicos e virtuais para o fabric local do Android
  • Comissionar dispositivos físicos e virtuais em uma estrutura de desenvolvimento
  • Controlar dispositivos na sua estrutura de desenvolvimento, por exemplo, acender uma luz
  • Os recursos de vários administradores permitem compartilhar dispositivos na estrutura de desenvolvimento com outros apps e, por outro lado, 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 usá-lo para comissionar, controlar e compartilhar dispositivos Matter.

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

Acesse o codelab do Sample App for Matter

Pré-requisitos

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

Instalar

  1. Acesse a seção "Versões" no repositório do GitHub Sample App for Matter. Para a versão mais recente, localize na seção "Assets" 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 o dispositivo Android com USB, ative a Transferência de arquivos e 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 do Sample App for Matter. Se você selecionar Não mostrar esta mensagem novamente, poderá abrir a caixa de diálogo novamente a qualquer momento atualizando suas preferências na seção "Administrador" do app.

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

O que são as redes do Matter?

App de exemplo do Google Home para o Matter

Uma estrutura do Matter é 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 um ou mais fabrics que correspondem a uma plataforma, um app ou um grupo de dispositivos que interagem entre si. Os fabrics têm um ID exclusivo, e os dispositivos compartilham o mesmo conjunto de credenciais e autoridade certificadora (CA). Essas credenciais são atribuídas durante o comissionamento do Matter.

Para comissionar um dispositivo Matter, siga estas etapas:

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

    Adicionar dispositivo

  2. Em seguida, o controle é transferido para Google Play services, que é iniciado por uma chamada para Mobile SDK. Para comprovar a posse, leia o QR code ou toque em 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 à malha local do Android e à malha de desenvolvimento.

Todo o trabalho de comissionamento e as telas associadas são processados pelo Play services ao comissionar dispositivos. Isso oferece uma experiência do usuário consistente e elimina a necessidade de lidar com permissões sensíveis, por exemplo, 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 do 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, é necessário 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 pode ser usada como o comissário de destino.

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

  2. Instale o comissionador 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 do Mobile SDK e, mais uma vez, o controle é transferido para o Play services.

Uma página de compartilhamento é exibida, permitindo que você escolha o app ou a plataforma em que quer parear o dispositivo. Essa tela oferece duas maneiras de compartilhar o dispositivo:

  1. Manualmente, usando um código de configuração que será compartilhado com o app de comissionamento de destino.
  2. Com um app Android local registrado como um comissário do Matter

O app de comissionamento de destino é rotulado como GHSAFM-TC. Toque nessa instância do app de exemplo para compartilhar o dispositivo.

Em seguida, o app externo (comissário de destino) conclui o comissionamento do dispositivo no próprio fabric.

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 comissionamento para dispositivos Matter.

Se o aplicativo tiver o próprio fluxo de descoberta ou comissionamento do 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", você também pode acessar os Utilitários para desenvolvedores.

Para analisar o conteúdo dos repositórios do DataStore de preferências do dispositivo e do usuário no Logcat, siga estas etapas:

  1. Clique em Registrar conteúdo dos repositórios.

  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 o Sample App for Matter, preencha nosso formulário de feedback.

Envie seu feedback

Se você tiver problemas com o Sample App for Matter, tente concluir as etapas para verificar seu ambiente:

Se você tiver dúvidas sobre como usar o app de exemplo ou descobrir um bug no código, envie problemas 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: