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 a estrutura do Google.
Depois que um dispositivo é adicionado à estrutura do Google, os usuários podem controlar os dispositivos deles usando o Google Home app (GHA), os controles de energia do Android, a voz e os dispositivos com tela sensível ao toque Nest.
O Mobile SDK também permite definir um serviço de provisionamento personalizado que pode ser usado para provisionar dispositivos em 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 o 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 Play services home é 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 apropriada no arquivo AndroidManifest.xml.
Os GHA e 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>
Isso só é compatível com dispositivos Android que executam o 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 Home no tempo de execução usando
ModuleInstallClient. Consulte a página
Como garantir a disponibilidade da API com ModuleInstallClient
para mais informações.
Como chamar outros apps Android
Se você estiver usando o Android 11 ou versões mais recentes, inclua o seguinte bloco
queries no AndroidManifest.xml para que seu 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 Matter
Para saber como o Mobile SDK funciona em um app Android, teste nosso Sample App for Matter.
Criar seu próprio app
Para ajudar você a começar rapidamente, disponibilizamos o código aberto do Sample App for Matter e um codelab complementar, permitindo que você personalize nosso exemplo de código para seus próprios projetos Android.
Acesse o codelab Sample App for Matter
Recursos
Para saber mais sobre o 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 no Google Play" do SDK para dispositivos móveis do Home.