Google Home Sample App for Matter uses the Google Home Mobile SDK to create an Android app that's similar to Google Home app (GHA) . This sample app provides the following features:
- Comissões físicas e virtuais Matter devices to the Local Android fabric
- Use dispositivos físicos e virtuais em uma fábrica de desenvolvimento
- Controle os dispositivos no tecido de desenvolvimento, por exemplo, acender uma luz
- Os recursos de multiadministrador permitem que você compartilhe dispositivos na malha de desenvolvimento com outros apps e, ao contrário, possam incluir dispositivos de malha de desenvolvimento compartilhados de outros apps.
- Utilitários para desenvolvedores
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 a Mobile SDK e a personalizar telas no Android Studio, confira nosso codelab Sample App for Matter.
Acesse o codelab Sample App for Matter
Pré-requisitos
- Um dispositivo Android O (8.1, nível 27 da API) ou mais recente disponível para testes. Para verificar se o dispositivo tem o suporte Matter mais recente, consulte o guia Verificar módulos e serviços do Matter.
- Crie um dispositivo
Matter com recursos de ativação/desativação. Este app de exemplo 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 seu ID do fornecedor e0x8000
como seu ID do produto. - Crie um dispositivo Espressif
com o
all-clusters-app
. Ao criar uma integração Matter no Developer Console, use0xFFF1
como o ID do fornecedor e0x8001
como o ID do produto.
- Crie um
dispositivo virtual Matter
com o app
Você não precisa de um hub, por exemplo, Google Nest Hub (2nd gen) , to commission and control devices with the Sample App for Matter.
Instalar
Acesse a seção "Lançamentos" no repositório do GitHub Sample App for Matter. Localize o APK chamado
GHSAFM-1.2.2-default-debug.apk
. Não selecione atargetcommissioner
:Instale o Android Debug Bridge:
Conecte o dispositivo Android via USB, ative a Transferência de arquivos e instale o APK:
$ adb unroot && adb install GHSAFM-1.2.2-default-debug.apk
Dispositivos da comissão
Ao iniciar o app de exemplo pela primeira vez, você vai receber 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, além de um tecido de desenvolvimento local apenas para o app de exemplo.
O que são os 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 juntos. Os tecidos têm um ID exclusivo, e os dispositivos compartilham o mesmo conjunto de credenciais e autoridade de certificação (CA). Essas credenciais são atribuídas durante a Matter comissão.
Para encomendar um dispositivo Matter, siga estas etapas:
Toque no botão
Adicionar dispositivo para iniciar o processo de comissionamento.Em seguida, o controle é transferido para Google Play services , which is launched from a call to the Mobile SDK. To establish proof of possession, Scan QR code or tap Use pairing code.
Quando a ativação for concluída, insira o Nome do dispositivo e toque em Concluído.
Seu dispositivo agora está conectado aos dois tecidos locais do Android e de desenvolvimento.
Todo o trabalho de encomenda e as telas associadas são processadas por Play services ao comissionar dispositivos. Isso oferece uma experiência consistente ao usuário e elimina a necessidade de processar permissões confidenciais, por exemplo, credenciais de Wi-Fi e Thread.
Controlar dispositivos
O tecido de desenvolvimento cria as credenciais para controlar os dispositivos Matter diretamente do app de exemplo.
Na tela inicial, ative ou desative 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 for atribuído ao app de exemplo, você poderá compartilhá-lo facilmente com outros ecossistemas.
Para compartilhar o 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 app de exemplo que pode ser usada como comissário de destino.
Acesse a seção "Lançamentos" no repositório do GitHub Sample App for Matter. Localize o APK mais recente chamado
GHSAFM-[version]-targetcommissioner
, por exemplo,GHSAFM-1.2.2-targetcommissioner-debug.apk
:Instale o comissário de destino.
$ adb unroot && adb install GHSAFM-1.0.1-targetcommissioner-debug.apk
Na tela inicial, toque no dispositivo para mostrar as informações. 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 para que você escolha o app 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 alvo.
- Com um app Android local que foi registrado como um comissário da Matter
O app de comissão do destino é chamado de GHSAFM-TC. Toque nesta instância do app de exemplo para compartilhar o dispositivo.
Em seguida, o app externo (comissionador de destino) conclui a ativação do dispositivo no próprio tecido.
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 oferecer um fluxo de comissionamento ou descoberta do Matter próprio, você pode querer 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 para desenvolvedores.
Para analisar o conteúdo dos repositórios do DataStore e de preferências do dispositivo no Logcat, conclua as etapas abaixo:
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ê estiver com problemas no 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 de código, envie problemas para o Issue Tracker no repositório do GitHub:
Para ver 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 (link em inglês)