App de exemplo do Google Home para casos

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:

• Fazer o provisionamento de dispositivos Matter físicos e virtuais para a estrutura local do Android
• Fazer o comissionamento de dispositivos físicos e virtuais em uma estrutura de desenvolvimento
• Controlar dispositivos na sua plataforma de desenvolvimento, por exemplo, acender uma luz
• Com os recursos de vários administradores, é possível compartilhar dispositivos na estrutura de desenvolvimento com outros apps e, inversamente, incluir na estrutura de desenvolvimento dispositivos compartilhados de outros apps.
• Utilitários para desenvolvedores

Neste guia, descrevemos como instalar o APK do Sample App for Matter e usar para comissionar, controlar e compartilhar dispositivos Matter.

Para baixar o código-fonte, aprenda a integrar o Mobile SDK e 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 garantir que seu dispositivo tenha o suporte mais recente do Matter, 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). Para minimizar problemas no 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 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, use 0xFFF1 como ID do fornecedor e 0x8000 como ID do produto.
  • Crie um dispositivo Espressif com o all-clusters-app. Ao criar uma integração do Matter no Developer Console, use 0xFFF1 como ID do fornecedor e 0x8001 como 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

1. Acesse a seção "Releases" no repositório Sample App for Matter do GitHub. Para a versão mais recente, localize na seção "Recursos" o APK chamado GHSAFM-version-default-debug.apk. Não selecione o targetcommissioner.

2. Instale o Android Debug Bridge (adb):

   Instalar o adb

3. Conecte seu dispositivo Android com USB e ative a Transferência de arquivos. Em seguida, instale o APK:

   $ adb unroot && adb install GHSAFM-version-default-debug.apk
   

Configurar dispositivos

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á trazer a caixa de diálogo de volta a qualquer momento atualizando suas preferências na seção "Administrador" do app.

Nas próximas etapas, você vai adicionar um dispositivo Matter à estrutura local do Android, além de uma estrutura de desenvolvimento local apenas para o app de exemplo.

O que são tecidos Matter?

Um Matter fabric é um domínio compartilhado de confiança entre dispositivos em uma rede doméstica que permite que eles se comuniquem entre si.

Os dispositivos podem ter uma ou mais estruturas que correspondem a uma plataforma, um app ou um grupo de dispositivos que interagem entre si. As estruturas 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 o Matter comissionamento.

Para comissionar um dispositivo Matter, siga estas etapas:

1. Toque no botão add Adicionar dispositivo para iniciar o processo de inclusão.

   

2. Em seguida, o controle é transferido para Google Play services, que é iniciado em uma chamada para Mobile SDK. Para estabelecer a prova de posse, toque em Ler QR code ou Usar código de pareamento.

   

3. Quando o comissionamento for concluído, insira um Nome do dispositivo e toque em Concluído.

Seu dispositivo agora está conectado ao Local Android e ao desenvolvimento.

Todo o trabalho de provisionamento e as telas associadas são processados por Play services ao provisionar dispositivos. Isso oferece uma experiência de usuário consistente e elimina a necessidade de processar permissões sensíveis, como credenciais de Wi-Fi e Thread.

Controlar dispositivos

A estrutura de desenvolvimento cria as credenciais para controlar dispositivos Matter diretamente do app de exemplo.

Na tela inicial, é possível ativar ou desativar 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 é comissionado para o app de exemplo, é fácil compartilhá-lo com outros ecossistemas.

Para compartilhar seu dispositivo Matter com outros ecossistemas, você precisa 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 comissário de destino.

1. Acesse a seção "Releases" no repositório Sample App for Matter do GitHub. Para a versão mais recente, localize na seção "Recursos" o APK chamado GHSAFM-version-targetcommissioner-debug.apk. Não selecione o default.

2. Instale o comissário de destino.

   $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
   

3. Na 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 tela de compartilhamento vai aparecer, permitindo que você escolha o app ou a plataforma que quer parear com o dispositivo. Essa tela oferece duas maneiras de compartilhar o dispositivo:

1. Manualmente, usando um código de configuração para compartilhar com o app de comissário de destino
2. Com um app Android local registrado como um comissário de Matter

O app 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 o provisionamento do dispositivo na própria estrutura.

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 página

Na tela "Configurações", é possível desativar as notificações proativas de descoberta de comissões para dispositivos Matter.

Se o aplicativo 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 comissionáveis para mais informações.

Utilitários para desenvolvedores

Na tela "Configurações", também é possível acessar Utilitários do desenvolvedor.

Para revisar o conteúdo dos repositórios Device e User Preferences DataStore no Logcat, siga estas etapas:

1. Clique em Conteúdo dos repositórios de registros.

2. 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 Sample App for Matter, preencha nosso formulário de feedback.

Envie seu feedback

Se você estiver com problemas com o Sample App for Matter, siga as etapas para verificar seu ambiente:

• Verificar Matter módulos e serviços

Se você tiver dúvidas sobre como usar o app de exemplo ou encontrar um bug no código, envie um problema para o Issue Tracker no repositório do GitHub:

• sample-apps-for-matter-android/issues

Para receber orientações oficiais do Google sobre questões técnicas, use o fórum de desenvolvedores de casa inteligente:

• Fórum para desenvolvedores de casas inteligentes

Para receber suporte técnico da comunidade, use a tag google-smart-home no Stack Overflow:

• Stack Overflow: google-smart-home