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 app de exemplo oferece os seguintes recursos:
- Encomende dispositivos Matter físicos e virtuais ao tecido do Android local
- 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 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 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, um Google Nest Hub (2nd gen), para encomendar e controlar dispositivos com o Sample App for Matter.
Instalar
Acesse a seção "Lançamentos" no repositório Sample App for Matter do GitHub. 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 à tecido local do Android, com uma malha 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 comissão de Matter.
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, que é iniciado de uma chamada para Mobile SDK. Para comprovar a posse, leia o código QR ou toque em Usar código de pareamento.
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 comissionamento e as telas associadas são processados por Play services ao encomendar 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 Sample App for Matter do GitHub. 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 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.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 com o 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)