Atenção! Os novos programas da prévia para desenvolvedores serão lançados em breve. Inscreva-se aqui e seja um dos primeiros a testar novas ferramentas e enviar feedback.

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 local apenas para o app de exemplo.

O que são tecidos Matter?

App de exemplo do Google Home para o Matter

O Fabric é 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 é conhecido como 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 comissionamento ou descoberta de casos, você pode suprimir 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 Device e 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: