Para ajudar você a criar aplicativos Android que interagem com dispositivos Matter, o Google desenvolveu o Google Home Mobile SDK. O Mobile SDK inclui duas APIs principais que permitem que seus apps comissionem e compartilhem dispositivos com o fabric do Google.
Depois que um dispositivo é adicionado ao Google Fabric, os usuários podem controlar os dispositivos usando o Google Home app (GHA), os controles de energia do Android, a voz e os dispositivos de tela tátil Nest.
O Mobile SDK também permite definir um serviço de comissionamento personalizado que pode ser usado para comissionar dispositivos para outros ecossistemas Matter.
Integrar o SDK para dispositivos móveis ao seu app Android
Para começar, siga estas etapas:
Siga as instruções em Configurar Google Play services.
Adicione a dependência Play services ao arquivo
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Garantir a entrega do módulo
O módulo home Play services é opcional. Portanto, a funcionalidade Matter só estará presente no dispositivo
de um usuário se um app no dispositivo especificar a dependência
do módulo Play services apropriado no arquivo AndroidManifest.xml.
O GHA e o Google Home Sample App for Matter incluem essa
dependência de módulo no manifesto. Se você estiver integrando o
Mobile SDK ao app Android, para garantir
o suporte a Matter para os usuários do app, adicione o
seguinte bloco service à declaração application no
arquivo AndroidManifest.xml:
<service android:name="com.google.android.gms.metadata.ModuleDependencies"
android:enabled="false"
android:exported="false">
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
<meta-data android:name="home:0:preferred" android:value=""/>
</service>
Esse recurso só tem suporte para dispositivos Android com Play services 22.50.14 ou mais recente.
Consulte o manifesto do Sample App for Matter para conferir um exemplo de implementação.
É possível verificar a disponibilidade do módulo de casa no momento da execução usando
ModuleInstallClient. Consulte a página
Como garantir a disponibilidade da API com o ModuleInstallClient
para mais informações.
Chamar outros apps Android
Se você estiver usando o Android 11 ou mais recente, inclua o bloco
queries abaixo no AndroidManifest.xml para que o app possa fazer chamadas para
outros apps.
<queries>
<!-- For GMS Core/Play service -->
<package android:name="com.google.android.gms" />
<package android:name="com.android.vending" />
<!-- End of GMS Core/Play service-->
</queries>
Para mais informações, consulte o artigo Filtragem da visibilidade de pacotes no Android.
Usar o app de exemplo do Google Home para o Matter
Para saber como o Mobile SDK funciona em um app Android, confira nossa Sample App for Matter.
Criar seu próprio app
Para ajudar você a começar rapidamente, disponibilizamos o Sample App for Matter como código aberto e um codelab complementar, permitindo que você personalize nosso código de exemplo para seus próprios projetos do Android.
Acesse o codelab Sample App for Matter
Recursos
Para saber mais sobre Mobile SDK, consulte a referência da API.
Para saber como esse SDK lida com os dados do usuário final, consulte a seção "Segurança dos dados do Google Play" do SDK para dispositivos móveis da Home.