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
- Um dispositivo Android O (8.1, API de nível 27) ou mais recente disponível para teste. Para garantir que seu dispositivo tenha o suporte Matter mais recente, consulte o guia Verificar módulos e serviços Matter.
- Crie um dispositivo Matter com recursos de ativação/desativação. Este aplicativo de amostra funciona com um dispositivo virtual e um ESP32.
- Crie um dispositivo virtual Matter
com o app
rootnode_dimmablelight_bCwGYSDpoe
. Ao criar uma integração Matter no Google Home Developer Console, use0xFFF1
como o ID do fornecedor e0x8000
como o ID do produto. - Crie um dispositivo Espressif
com o
all-clusters-app
. Ao criar uma integração Matter no Developer Console, use0xFFF1
como seu ID de fornecedor e0x8001
como seu ID do produto.
- Crie um dispositivo virtual Matter
com o app
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
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 otargetcommissioner
:Instale o Android Debug Bridge (adb):
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?
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:
Toque no botão
Adicionar dispositivo para iniciar o processo de ativação.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.
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.
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.
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
:Instale o comissário de destino.
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
Na tela inicial, toque no dispositivo para exibir as informações dele. Toque em Compartilhar.
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:
- Manualmente, usando um código de configuração para ser compartilhado com o app de comissão do alvo
- 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.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:
Clique em Registrar repositórios de conteúdo.
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.
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:
- sample-app-for-matter-android/issues (em inglês)
Para receber orientações oficiais do Google sobre dúvidas técnicas, use o Fórum de desenvolvedores da casa inteligente:
- Fórum para desenvolvedores de casas inteligentes (em inglês)
Para receber suporte técnico da comunidade, use a tag google-smart-home
no Stack Overflow:
- Stack Overflow: google-smart-home (em inglês)