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 que é local apenas para o app de exemplo.
O que são tecidos 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:
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 é 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.
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 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:
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-apps-for-matter-android/issues (link 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)