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:
- Comissionar dispositivos Matter físicos e virtuais para a Tecido local do Android
- Comissionar dispositivos físicos e virtuais para um fabric de desenvolvimento
- Controle dispositivos na estrutura de desenvolvimento, por exemplo, ligar um leve
- Os recursos de vários administradores permitem compartilhar dispositivos no fabric de desenvolvimento com outros apps e, por outro lado, incluir no fabric de desenvolvimento dispositivos 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 Matter dispositivos.
Para fazer o download do código-fonte, saiba como integrar a Mobile SDK e personalize telas no Android Studio, conheça nossa Codelab Sample App for Matter.
Acesse o codelab Sample App for Matter
Pré-requisitos
- Um dispositivo com o Android O (8.1, nível 27 da API) ou mais recente disponível para testes. Para verificar se o dispositivo tem 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.
- Dispositivo virtual Matter (MVD, na sigla em inglês). Para minimizar os problemas do ambiente, recomendamos que você use o MVD para começar. Se você tiver problemas, será muito mais fácil investigar se o app de exemplo é usado contra o MVD.
- Crie um dispositivo virtual Matter
com o app
rootnode_dimmablelight_bCwGYSDpoe. Ao criar uma integração Matter no Google Home Developer Console, use0xFFF1como o ID do fornecedor e0x8000como o ID do produto. - Crie um dispositivo Espressif
com o
all-clusters-app. Quando você Criar uma integração com Matter no Developer Console, use0xFFF1como ID do fornecedor e0x8001como ID do produto.
Você não precisa de um hub, como Google Nest Hub (2nd gen), para encomendar e controlar dispositivos com a Sample App for Matter.
Instalar
Acesse a seção Versões. no GitHub Sample App for Matter repositório de dados. Para a versão mais recente, localize o APK chamado
GHSAFM-version-default-debug.apkna seção "Assets". Não selecione o botãotargetcommissioner:Instale o Android Debug Bridge (adb):
Conecte seu dispositivo Android por USB, ative a Transferência de arquivos e instale o APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Dispositivos de 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, a caixa de diálogo será exibida novamente a qualquer momento ao atualizar suas preferências na seção "Administrador" do aplicativo.
Nas próximas etapas, você vai adicionar um dispositivo Matter ao Tecido local do Android, junto com um tecido de desenvolvimento local ao exemplo. somente no app.
O que são os tecidos Matter?
Um fabric Matter é um domínio de confiança compartilhado entre dispositivos em uma rede doméstica que permite a comunicação entre eles.
Os dispositivos podem ter um ou mais fabrics que correspondem a uma plataforma, um app ou um grupo de dispositivos que interagem entre si. Os fabrics têm um ID exclusivo, e os dispositivos compartilham o mesmo conjunto de credenciais e a autoridade certificadora (AC). Essas credenciais são atribuídas durante Matter comissionamento.
Para comissionar um dispositivo Matter, siga estas etapas:
Toque em "Adicionar" . Botão do 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, Ler QR code ou toque em Usar código de pareamento.
Quando o comissionamento for concluído, insira um nome de dispositivo e toque em Concluído.
Seu dispositivo agora está conectado à estrutura local do Android e ao a estrutura de desenvolvimento.
Todo o trabalho de comissionamento e as 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 lidar com dados de acesso, como credenciais de Wi-Fi e Thread.
Controlar dispositivos
O fabric de desenvolvimento cria as credenciais para controlar dispositivos Matter diretamente no app de exemplo.
Na tela inicial, ative ou desative o dispositivo. Toque no dispositivo para acessar os detalhes dele.
Dispositivos compartilhados
O compartilhamento de um dispositivo é chamado de fluxo multiadministrador no especificação Matter. Depois que um dispositivo é comissionado para o app de exemplo, você pode compartilhá-lo facilmente com outros ecossistemas.
Para compartilhar o dispositivo Matter com outros ecossistemas: é necessário ter outra plataforma instalada no seu dispositivo Android. Isso plataforma externa se torna o comissário de destino. Criamos outra instância do app de exemplo que você pode usar como o comissário de destino.
Acesse a seção Versões. no GitHub Sample App for Matter repositório de dados. Para a versão mais recente, localize o APK chamado
GHSAFM-version-targetcommissioner-debug.apkna seção "Assets". Não selecione o botãodefault:Instalar o comissionado alvo.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkNa 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, novamente, é transferido para Play services.
Uma página de compartilhamento vai aparecer para você escolher o app ou a plataforma quer parear o dispositivo. Essa tela oferece duas maneiras de compartilhar dispositivo:
- Manualmente, usando um código de configuração para compartilhar com o app do encomendador de destino
- Com um app Android local que foi registrado como um Comissário de Matter
O app do comissário de destino é rotulado como GHSAFM-TC. Toque nesta instância do app de exemplo para compartilhar seu dispositivo.
Em seguida, o app externo (comissário de destino) conclui a comissionamento do dispositivo no próprio fabric.
Configurações
Na tela inicial, clique nas configurações Ícone do . Aqui você tem as opções 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 de descoberta proativas que podem gerar comissão para dispositivos Matter.
Se o app fornecer o próprio fluxo de descoberta ou comissionamento de Matter, talvez seja melhor suprimir essas notificações para evitar interrupções. Consulte Suprimir notificações de descoberta com comissionamento para mais informações.
Utilitários do desenvolvedor
Na tela "Configurações", você também pode acessar os Utilitários do desenvolvedor.
Para analisar o conteúdo dos repositórios da DataStore de preferências do dispositivo e do usuário no Logcat, siga estas etapas:
Clique em Registrar conteúdo dos repositórios.
Clique em OK na caixa de diálogo e marque Logcat.
Feedback e ajuda
Para enviar suas ideias ou feedback sobre como podemos melhorar a experiência de desenvolvimento com o Sample App for Matter, preencha nosso formulário de feedback.
Se você tiver problemas com a Sample App for Matter, tente concluir as etapas para verificar o ambiente:
Se você tiver dúvidas sobre como usar o app de exemplo ou descobrir um bug no código, podem enviar problemas para o Issue Tracker no repositório do GitHub:
Para receber orientações oficiais do Google em questões técnicas, use a casa inteligente Fórum de desenvolvedores:
Para receber suporte técnico da comunidade, use a tag google-smart-home em
Stack Overflow:
- Stack Overflow: google-smart-home (link em inglês)