O Google Home Sample App for Matter usa o Google Home Mobile SDK para criar um app Android semelhante ao Google Home app (GHA). Esse app de exemplo oferece os seguintes recursos:
- Comissionar dispositivos físicos e virtuais Matter para o Local Android fabric
- Comissionar dispositivos físicos e virtuais para um ambiente de desenvolvimento
- Controlar dispositivos no ambiente de desenvolvimento, por exemplo, acender uma luz
- Os recursos de vários administradores permitem compartilhar dispositivos no ambiente de desenvolvimento com outros apps e, inversamente, incluir no ambiente de desenvolvimento dispositivos compartilhados de outros apps
- Utilitários para desenvolvedores
Este guia descreve como instalar o Sample App for Matter APK e usar 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, experimente nosso Sample App for Matter codelab.
Acesse o codelabSample App for Matter
Pré-requisitos
- Um dispositivo Android O (8.1, nível 27 da API) ou mais recente disponível para testes. Para garantir que seu dispositivo tenha o suporte Matter mais recente, consulte o guia Matter Módulos e serviços.
- Crie um dispositivo Matter com recursos de ativação/desativação. Esse app de exemplo funciona com um dispositivo virtual e um ESP32.
- Dispositivo virtual Matter (MVD, na sigla em inglês). Para minimizar problemas de ambiente, sugerimos que você use o MVD para começar. Se você tiver problemas, será muito mais fácil investigar se o app de exemplo for usado no MVD.
- Crie um Matter dispositivo virtual
com o app
rootnode_dimmablelight_bCwGYSDpoe. Ao criar uma integração no Google Home Developer Console, use0xFFF1como ID do fornecedor e0x8000como ID do produto.Matter - Crie um dispositivo Espressif
com o
all-clusters-app. Ao criar uma integração no Developer Console, use0xFFF1como ID do fornecedor e0x8001como ID do produto.MatterDeveloper Console
Não é necessário 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 Releases no repositório do GitHub .Sample App for Matter Para a versão mais recente, localize na seção "Assets" o APK chamado
GHSAFM-version-default-debug.apk. Não selecione otargetcommissioner.Instale o Android Debug Bridge (adb):
Conecte seu dispositivo Android com USB e ative a Transferência de arquivos e, em seguida, instale o APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Comissionar dispositivos
Ao iniciar o app de exemplo pela primeira vez, você vai receber uma caixa de diálogo com um link para o Sample App for Matter codelab. Se você selecionar Não mostrar esta mensagem novamente, poderá trazer a caixa de diálogo de volta a qualquer momento atualizando suas preferências na seção "Admin" do app.
Nas próximas etapas, você vai adicionar um dispositivo Matter ao Local Android fabric, além de um ambiente de desenvolvimento local apenas para o app de exemplo.
O que são ambientes Matter?
Um Matter ambiente é 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 ambientes que correspondem a uma plataforma, um app ou um grupo de dispositivos que interagem juntos. Os ambientes têm um ID exclusivo, e os dispositivos compartilham o mesmo conjunto de credenciais e autoridade certificadora (AC). Essas credenciais são atribuídas durante Matter o comissionamento.
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 em uma chamada para o Mobile SDK. Para estabelecer a prova de posse, leia o QR code ou toque em Usar código de pareamento.
Quando o comissionamento for concluído, insira um nome do dispositivo e toque em Concluído.
Seu dispositivo agora está conectado ao Local Android fabric e ao ambiente 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 de usuário consistente e elimina a necessidade de processar permissões confidenciais, por exemplo, credenciais de Wi-Fi e Thread.
Controlar dispositivos
O ambiente de desenvolvimento cria as credenciais para controlar Matter dispositivos diretamente do app de exemplo.
Na tela inicial, você pode ativar ou desativar o dispositivo. Toque no dispositivo para acessar os detalhes dele.
Dispositivos compartilhados
O compartilhamento de um dispositivo é chamado de fluxo de vários administradores na Matter especificação. Depois que um dispositivo é comissionado para o app de exemplo, você pode compartilhá-lo facilmente com outros ecossistemas.
Para compartilhar seu Matter dispositivo com outros ecossistemas, é necessário ter outra plataforma instalada no dispositivo Android. Essa plataforma externa se torna o comissionador de destino. Criamos outra instância do app de exemplo que você pode usar como comissionador de destino.
Acesse a seção Releases no repositório do GitHub .Sample App for Matter Para a versão mais recente, localize na seção "Assets" o APK chamado
GHSAFM-version-targetcommissioner-debug.apk. Não selecione odefault.Instale o comissionador de destino.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkNa tela inicial, toque no dispositivo para mostrar 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 folha de compartilhamento é exibida, permitindo que você escolha o app ou a plataforma a 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 comissionador de destino
- Com um app Android local que foi registrado como um Matter comissionador
O app comissionador de destino é rotulado como GHSAFM-TC. Toque nessa instância do app de exemplo para compartilhar seu dispositivo.
Em seguida, o app externo (comissionador de destino) conclui o comissionamento do dispositivo no próprio ambiente.
Configurações
Na tela inicial, clique no ícone de configurações settings. Aqui você tem as opções de atualizar as preferências do usuário, receber ajuda e saber mais sobre o app.
Notificação de meia folha
Na tela "Configurações", você pode desativar as notificações proativas de descoberta comissionável para dispositivos Matter.
Se o aplicativo fornecer o próprio Matter fluxo de descoberta ou comissionamento, talvez você queira suprimir essas notificações para evitar interrupções. Consulte Suprimir notificações de descoberta comissionável para mais informações.
Utilitários para desenvolvedores
Na tela "Configurações", você também pode acessar os Utilitários para desenvolvedores.
Para revisar o conteúdo dos repositórios do DataStore de preferências do dispositivo e do usuário em Logcat, siga estas etapas:
Clique em Conteúdo dos repositórios de registros.
Clique em OK na caixa de diálogo e confira o Logcat.
Feedback e ajuda
Para enviar suas ideias ou 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, siga 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 receber orientações oficiais 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: