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:
- Comissionamento de dispositivos Matter físicos e virtuais na malha local do Android
- Comissionamento de dispositivos físicos e virtuais em uma malha de desenvolvimento
- Controlar dispositivos no tecido de desenvolvimento, por exemplo, acendendo uma luz
- Os recursos multiadministradores permitem compartilhar dispositivos na malha de desenvolvimento com outros apps e, por outro lado, incluir na malha 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 dispositivos Matter.
Para fazer o download do código-fonte, aprender a integrar o Mobile SDK e personalizar telas no Android Studio, faça o 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 conferir se o dispositivo tem o suporte mais recente ao Matter, consulte o guia Verificar módulos e serviços Matter.
- Crie um dispositivo Matter com recursos de ativação/desativação. Ele funciona com um dispositivo virtual e um ESP32.
- Dispositivo virtual Matter (MVD): Para minimizar os problemas ambientais, sugerimos que você use MVD para começar. Se você tiver problemas, será muito mais fácil investigar se o app de amostra for usado com o MVD.
- 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 de 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.
Você não precisa de um hub, como um Google Nest Hub (2nd gen), para comissionar e controlar dispositivos com a Sample App for Matter.
Instalar
Acesse a seção "Versões" no repositório Sample App for Matter do GitHub. Para a versão mais recente, localize o APK chamado
GHSAFM-version-default-debug.apk
na seção "Recursos". Não selecione otargetcommissioner
.Instale o Android Debug Bridge (adb):
Conecte o dispositivo Android usando um cabo 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ê 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á recuperar a caixa de diálogo a qualquer momento atualizando as preferências na seção "Administrador" do app.
Nas próximas etapas, você vai adicionar um dispositivo Matter à malha local do Android, além de uma malha de desenvolvimento local apenas para o app de exemplo.
O que são os tecidos Matter?
Uma malha Matter é um domínio compartilhado de confiança entre dispositivos em uma rede doméstica que permite que eles se comuniquem uns com os outros.
Os dispositivos podem ter um ou mais tecidos que correspondem a uma plataforma, app ou grupo de dispositivos interagindo. Os Fabrics 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 o comissionamento do Matter.
Para comissionar 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 por uma chamada para Mobile SDK. Para comprovar a posse, leia o QR code ou toque em Usar código de pareamento.
Quando o comissionamento for concluído, digite um Device Name e toque em Done.
Seu dispositivo agora está conectado à malha local do Android e à de desenvolvimento.
Todo o trabalho de comissionamento e as telas associadas são processados pela Play services ao comissionar dispositivos. Isso proporciona uma experiência do usuário consistente e elimina a necessidade de processar permissões sensíveis, como credenciais de Wi-Fi e Thread.
Controlar dispositivos
A malha de desenvolvimento cria as credenciais para controlar dispositivos Matter diretamente do app de exemplo.
Na tela inicial, você pode ativar ou desativar o dispositivo. Toque no dispositivo para acessar os detalhes.
Dispositivos compartilhados
O compartilhamento de um dispositivo é chamado de fluxo com vários administradores na especificação Matter. Depois que um dispositivo é comissionado para o app de exemplo, ele pode ser compartilhado facilmente com outros ecossistemas.
Para compartilhar seu dispositivo Matter com outros ecossistemas, você precisará ter outra plataforma instalada no seu dispositivo Android. Essa 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 repositório Sample App for Matter do GitHub. Para a versão mais recente, localize o APK chamado
GHSAFM-version-targetcommissioner-debug.apk
na seção "Recursos". Não selecione odefault
.Instale o comissário de destino.
$ adb unroot && adb install GHSAFM-version-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 app ou a plataforma com que quer parear o dispositivo. Essa tela oferece duas maneiras de compartilhar o dispositivo:
- Manualmente, usando um código de configuração a ser compartilhado com o app do comissionado de destino.
- Com um app Android local registrado como um comissário de Matter.
O app do comissário desejado tem o rótulo GHSAFM-TC. Toque nesta instância do app de exemplo para compartilhar seu dispositivo.
Em seguida, o app externo (comissário de destino) conclui o comissionamento do dispositivo na própria malha.
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 de configurações, é possível desativar as notificações proativas de descoberta comissionadas para dispositivos Matter.
Se o aplicativo fornecer o próprio fluxo de comissionamento ou descoberta de Matter, é recomendável suprimir essas notificações para evitar interrupções. Consulte Suprimir notificações de descoberta comissionadas para mais informações.
Utilitários para desenvolvedores
Na tela "Configurações", você também pode acessar os Utilitários do desenvolvedor.
Para analisar o conteúdo dos repositórios do Device Preferences DataStore no Logcat, siga estas etapas:
Clique em Log Repositories content (conteúdo dos repositórios de registros).
Clique em OK na caixa de diálogo e verifique o 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 o Sample App for Matter, tente concluir as etapas para verificar seu ambiente:
Se você tiver dúvidas sobre o uso do app de exemplo ou descobrir um bug de código, envie problemas para o Issue Tracker no repositório do GitHub:
Para receber orientação oficial do Google sobre questões técnicas, use o fórum para desenvolvedores de casa inteligente:
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)