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 dispositivos Matter.
Para fazer o download do código-fonte, aprenda a integrar o Mobile SDK e personalizar telas no Android Studio. Teste nosso codelab Sample App for Matter.
Acesse 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 testes. Para verifique se o dispositivo tem a versão mais recente do Matter suporte, consulte a Verificar Matter módulos e Serviços guia.
- Crie um dispositivo Matter com recursos de ativação/desativação. Isso
funciona com um dispositivo virtual e um ESP32.
- Matter Virtual Device (MVD). Para minimizar problemas com o ambiente, sugerimos que você use o MVD para começar. Em caso de problemas, será muito mais fácil Investigue se o app de exemplo é usado em relação ao MVD.
- Criar um dispositivo virtual do Matter
com o app
rootnode_dimmablelight_bCwGYSDpoe. Quando você Criar uma integração com o Matter em Google Home Developer Console, use0xFFF1como ID do fornecedor e0x8000como ID do produto. - Criar um dispositivo Espressif
com o
all-clusters-app. Ao criar uma integração Matter no Developer Console, use0xFFF1como o ID do fornecedor e0x8001como o ID do produto.
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 o APK chamado
GHSAFM-version-default-debug.apkna seção "Assets". 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 depois 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, 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 fabric local do Android, junto com um fabric de desenvolvimento local apenas para o app de exemplo.
O que são os tecidos do Matter?
Uma malha Matter é um domínio compartilhado de confiança entre dispositivos em uma rede doméstica que permite uma comunicação entre eles.
Os dispositivos podem ter um ou mais tecidos que correspondam a uma plataforma, app ou grupo de dispositivos interagindo. Os tecidos têm um exclusivo e os dispositivos compartilham o mesmo conjunto de credenciais e autoridade de certificação (CA). 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 o 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 gerenciados pelo 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
A malha de desenvolvimento cria as credenciais para controlar Matter dispositivos diretamente do 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 de vários administradores na especificação Matter. Depois que um dispositivo é comissionado para o app de exemplo, você pode compartilhá-lo facilmente com outros ecossistemas.
Para compartilhar seu dispositivo Matter com outros ecossistemas, você precisa ter outra plataforma instalada no 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 comissário-alvo.
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:Instale o comissário de destino.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkNa tela inicial, toque no dispositivo para exibir as informações. Toque 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 é identificado 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 o comissionamento do dispositivo em sua própria malha.
Configurações
Na tela inicial, clique em "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 Halfsheet
Na tela "Configurações", é possível desativar a opção comissionada proativa notificações de descoberta para Matter dispositivos.
Caso seu aplicativo faça a própria descoberta de Matter ou fluxo de comissionamento, convém suprimir essas notificações para evitar interrupções. Consulte Suprimir descobertas comissionadas notificações para mais informações.
Utilitários do desenvolvedor
Na tela "Configurações", você também pode acessar os Utilitários do desenvolvedor.
Para revisar o conteúdo dos repositórios do DataStore de preferências do dispositivo e do usuário no Logcat, conclua as seguintes etapas:
Clique em Conteúdo dos repositórios de registros.
Clique em OK na caixa de diálogo e marque 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 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 no
Stack Overflow:
- Stack Overflow: google-smart-home (link em inglês)