App de exemplo do Google Home para casos

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

App de exemplo do Google Home para o Matter

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:

  • Encomende dispositivos Matter físicos e virtuais ao tecido do Android local
  • Use dispositivos físicos e virtuais em uma fábrica de desenvolvimento
  • Controle os dispositivos no tecido de desenvolvimento, por exemplo, acender uma luz
  • Os recursos de multiadministrador permitem que você compartilhe dispositivos na malha de desenvolvimento com outros apps e, ao contrário, possam incluir dispositivos de malha de desenvolvimento 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 a Mobile SDK e a personalizar telas no Android Studio, confira nosso codelab Sample App for Matter.

Acesse o codelab Sample App for Matter

Pré-requisitos

Você não precisa de um hub, por exemplo, um Google Nest Hub (2nd gen), para encomendar e controlar dispositivos com o Sample App for Matter.

Instalar

  1. Acesse a seção "Lançamentos" no repositório Sample App for Matter do GitHub. Localize o APK chamado GHSAFM-1.2.2-default-debug.apk. Não selecione a targetcommissioner:

    Fazer o download do APK

  2. Instale o Android Debug Bridge:

    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.2.2-default-debug.apk
    

Dispositivos da comissão

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á 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 à tecido local do Android, com uma malha de desenvolvimento local apenas para o app de exemplo.

O que são os tecidos Matter?

App de exemplo do Google Home para o Matter

O Fabric é 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 juntos. Os tecidos têm um ID exclusivo, e os dispositivos compartilham o mesmo conjunto de credenciais e autoridade de certificação (CA). Essas credenciais são atribuídas durante a comissão de Matter.

Para encomendar um dispositivo Matter, siga estas etapas:

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

    Adicionar dispositivo

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

    Ler código QR

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

Seu dispositivo agora está conectado aos dois tecidos locais do Android e de desenvolvimento.

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

Controlar dispositivos

O tecido de desenvolvimento cria as credenciais para controlar os dispositivos Matter diretamente do app de exemplo.

Na tela inicial, ative ou desative o dispositivo. Toque nele para acessar os detalhes.

Dispositivo adicionado

Dispositivos compartilhados

O compartilhamento de um dispositivo é chamado de fluxo de vários administradores na especificação Matter. Depois que um dispositivo for atribuído ao app de exemplo, você poderá compartilhá-lo facilmente com outros ecossistemas.

Para compartilhar o 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 app de exemplo que pode ser usada como comissário de destino.

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

    Faça o download do Commissioner de destino

  2. Instale o comissário de destino.

    $ adb unroot && adb install GHSAFM-1.0.1-targetcommissioner-debug.apk
    
  3. Na tela inicial, toque no dispositivo para mostrar as informações. Toque em Compartilhar.

    Compartilhar dispositivo

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 para que você escolha o app 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 alvo.
  2. Com um app Android local que foi registrado como um comissário Matter

O app de comissão do destino é chamado de GHSAFM-TC. Toque nesta instância do app de exemplo para compartilhar o dispositivo.

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

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.

Configurações

Utilitários do desenvolvedor

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

Para analisar o conteúdo dos repositórios do DataStore e de preferências do dispositivo no Logcat, conclua as etapas abaixo:

  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ê estiver com problemas com o Sample App for Matter, tente concluir 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 ver orientações oficiais do Google sobre dúvidas técnicas, use o Fórum de desenvolvedores da casa inteligente:

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