App de exemplo do Google Home para casos

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 aplicativo de exemplo fornece os seguintes recursos:

  • Comissionamento de dispositivos Matter físicos e virtuais no tecido local do Android
  • Encomende dispositivos físicos e virtuais para uma infraestrutura de desenvolvimento
  • controlar dispositivos no tecido de desenvolvimento, por exemplo, acender uma luz;
  • Os recursos de multiadministrador permitem compartilhar dispositivos na malha de desenvolvimento com outros apps e, de maneira inversa, ser incluídos nos dispositivos de malha de desenvolvimento compartilhados de outros aplicativos
  • Utilitários do desenvolvedor

Este guia descreve como instalar o APK Sample App for Matter e usá-lo para comissionar, controlar e compartilhar dispositivos Matter.

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

Acessar o codelab Sample App for Matter

Pré-requisitos

Você não precisa de 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 "Versões" no repositório Sample App for Matter do GitHub. Localize o APK chamado GHSAFM-1.4.1-default-debug.apk. Não selecione o targetcommissioner:

    Faça o download do APK

  2. Instale o Android Debug Bridge (adb):

    Instalar o adb

  3. Conecte o dispositivo Android via USB, ative a Transferência de arquivos e instale o APK:

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

Dispositivos da comissão

Ao iniciar o app de exemplo pela primeira vez, você verá 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á exibir a caixa de diálogo novamente a qualquer momento atualizando suas preferências na seção "Administrador" do app.

Nas próximas etapas, você adicionará um dispositivo Matter ao tecido local do Android, com um tecido de desenvolvimento que é local apenas para o app de exemplo.

O que são tecidos Matter?

App de exemplo do Google Home para o Matter

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

Os dispositivos podem ter um ou mais tecidos que correspondem a uma plataforma, app ou grupo de dispositivos que interagem entre si. Os tecidos têm um código exclusivo, e os dispositivos compartilham o mesmo conjunto de credenciais e autoridade de certificação (CA, na sigla em inglês). Essas credenciais são atribuídas durante a comissão de Matter.

Para comissionar um dispositivo Matter, siga estas etapas:

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

    Adicionar dispositivo

  2. Em seguida, o controle é transferido para Google Play services, que é iniciado de uma chamada para Mobile SDK. Para comprovar isso, leia o código QR ou toque em Usar código de pareamento.

    Ler código QR

  3. Quando a ativação for concluída, digite um Nome de dispositivo e toque em Concluído.

Seu dispositivo agora está conectado ao tecido do Android local e do tecido de desenvolvimento.

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

Controlar dispositivos

O tecido de desenvolvimento cria as credenciais para controlar os dispositivos Matter diretamente do aplicativo de amostra.

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 amostra, você pode compartilhá-lo facilmente com outros ecossistemas.

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

  1. Acesse a seção "Versões" no repositório Sample App for Matter do GitHub. Localize o APK mais recente chamado GHSAFM-[version]-targetcommissioner, por exemplo, GHSAFM-1.4.1-targetcommissioner-debug.apk:

    Faça o download do Commissioner de destino

  2. Instale o comissário de destino.

    $ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
    
  3. Na tela inicial, toque no dispositivo para exibir 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 página de compartilhamento é exibida, permitindo que você escolha o aplicativo ou a plataforma com que você quer parear o dispositivo. Essa tela oferece duas maneiras de compartilhar o dispositivo:

  1. Manualmente, usando um código de configuração para ser compartilhado com o app de comissão do alvo
  2. Com um app Android local registrado como comissionador Matter

O app de comissão do alvo é rotulado como GHSAFM-TC. Toque nesta instância do app de amostra para compartilhar seu dispositivo.

Em seguida, o app externo (comissionador de destino) conclui a ativação do dispositivo no tecido dele.

Configurações

Na tela inicial, clique no ícone de configurações . Aqui você tem as opções para 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 comissionadas para dispositivos Matter.

Se o aplicativo fornece o próprio fluxo de descoberta ou comissão de Matter, suprima essas notificações para evitar interrupções. Consulte Suprimir notificações de descoberta comissionadas para mais informações.

Utilitários do desenvolvedor

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

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

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

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

Feedback e ajuda

Para enviar sua opinião ou seu 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ê 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 aplicativo de amostra ou descobrir um bug de código, envie problemas para o Issue Tracker no repositório do GitHub:

Para receber orientações oficiais do Google sobre dúvidas técnicas, use o Fórum de desenvolvedores da casa inteligente:

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