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 aplicativo de exemplo fornece os seguintes recursos:

• Comissionamento de dispositivos Matter físicos e virtuais no tecido local do Android
• Encomende dispositivos físicos e virtuais para uma infraestrutura de desenvolvimento
• controlar dispositivos no tecido de desenvolvimento, por exemplo, acender uma luz;
• Os recursos de multiadministrador permitem compartilhar dispositivos na malha de desenvolvimento com outros apps e, de maneira inversa, ser incluídos nos dispositivos de malha de desenvolvimento compartilhados de outros aplicativos
• Utilitários do desenvolvedor

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, usando nosso 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 garantir que seu dispositivo tenha o suporte Matter mais recente, consulte o guia Verificar módulos e serviços Matter.
• Crie um dispositivo Matter com recursos de ativação/desativação. Este aplicativo de amostra funciona com um dispositivo virtual e um ESP32.
  • 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 o ID do fornecedor e 0x8000 como o ID do produto.
  • Crie um dispositivo Espressif com o all-clusters-app. Ao criar uma integração Matter no Developer Console, use 0xFFF1 como seu ID de fornecedor e 0x8001 como seu ID do produto.

Você não precisa de 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 "Versões" no repositório Sample App for Matter do GitHub. Localize o APK chamado GHSAFM-1.4.1-default-debug.apk. Não selecione o targetcommissioner:

   download Faça o download do APK

2. Instale o Android Debug Bridge (adb):

   Instalar o adb

3. Conecte o dispositivo Android via USB, ative a Transferência de arquivos e instale o APK:

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

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

Nas próximas etapas, você adicionará um dispositivo Matter ao tecido local do Android, com um tecido de desenvolvimento que é local apenas para o app de exemplo.

O que são tecidos Matter?

Um tecido Matter é 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 tecidos que correspondem a uma plataforma, app ou grupo de dispositivos que interagem entre si. Os tecidos 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 a comissão de Matter.

Para comissionar um dispositivo Matter, siga estas etapas:

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

   

2. Em seguida, o controle é transferido para Google Play services, que é iniciado de uma chamada para Mobile SDK. Para comprovar isso, leia o código QR ou toque em Usar código de pareamento.

   

3. Quando a ativação for concluída, digite um Nome de dispositivo e toque em Concluído.

Seu dispositivo agora está conectado ao tecido do Android local e do tecido de desenvolvimento.

Todo o trabalho de comissionamento e 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 processar permissões confidenciais, como credenciais de Wi-Fi e Thread.

Controlar dispositivos

O tecido de desenvolvimento cria as credenciais para controlar os dispositivos Matter diretamente do aplicativo de amostra.

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 amostra, você pode compartilhá-lo facilmente com outros ecossistemas.

Para compartilhar seu dispositivo Matter com outros ecossistemas, é necessário ter outra plataforma instalada no dispositivo Android. Essa plataforma externa se torna o comissário de destino. Criamos outra instância do aplicativo de amostra que você pode usar como comissário de destino.

1. Acesse a seção "Versões" no repositório Sample App for Matter do GitHub. Localize o APK mais recente chamado GHSAFM-[version]-targetcommissioner, por exemplo, GHSAFM-1.4.1-targetcommissioner-debug.apk:

   download Faça o download do Commissioner de destino

2. Instale o comissário de destino.

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

3. 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 aplicativo ou a plataforma com que você quer parear o dispositivo. Essa tela oferece duas maneiras de compartilhar o dispositivo:

1. Manualmente, usando um código de configuração para ser compartilhado com o app de comissão do alvo
2. Com um app Android local registrado como comissionador Matter

O app de comissão do alvo é rotulado como GHSAFM-TC. Toque nesta instância do app de amostra para compartilhar seu dispositivo.

Em seguida, o app externo (comissionador de destino) conclui a ativação do dispositivo no tecido dele.

Configurações

Na tela inicial, clique no ícone de configurações settings. 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 Configurações, é possível desativar as notificações proativas de descoberta comissionadas para dispositivos Matter.

Se o aplicativo fornece o próprio fluxo de descoberta ou comissão de Matter, suprima essas notificações para evitar interrupções. Consulte Suprimir notificações de descoberta comissionadas para mais informações.

Utilitários do desenvolvedor

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

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

1. Clique em Registrar repositórios de conteúdo.

2. Clique em OK na caixa de diálogo e marque Logcat.

Feedback e ajuda

Para enviar sua opinião ou seu 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ê tiver problemas com o Sample App for Matter, tente concluir as etapas para verificar seu ambiente:

• Verificar Matter módulos e serviços

Se você tiver dúvidas sobre como usar o aplicativo de amostra ou descobrir um bug de código, envie problemas para o Issue Tracker no repositório do GitHub:

• sample-apps-for-matter-android/issues (link em inglês)

Para receber orientações oficiais do Google sobre dúvidas técnicas, use o Fórum de desenvolvedores da casa inteligente:

• Fórum para desenvolvedores de casas inteligentes (em inglês)

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

• Stack Overflow: google-smart-home (em inglês)