Para ajudar você a criar aplicativos Android que interagem com dispositivos Matter, o Google desenvolveu a Google Home Mobile SDK. O Mobile SDK inclui duas APIs principais que permitem que seus apps comissionem e compartilhem dispositivos com o Google Fabric.
Depois que um dispositivo é adicionado à estrutura do Google, seus usuários podem controlar os dispositivos pelo Google Home app (GHA), controles liga/desliga do Android, voz e dispositivos com tela touchscreen do 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ó vai estar presente no dispositivo
do usuário se um app nele especificar a dependência do módulo
Play services adequada 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 ao Matter para os usuários do app, adicione o
bloco service abaixo à 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 de Sample App for Matter para ver um exemplo de implementação.
É possível verificar a disponibilidade do módulo inicial 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 de 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, tente 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 do Google Home.