Para ajudar você a criar aplicativos Android que interajam com dispositivos Matter, o Google desenvolveu o Google Home Mobile SDK. O Mobile SDK inclui duas APIs principais que permitem que os apps ativem e compartilhem dispositivos com a malha do Google.
Depois que um dispositivo é adicionado ao tecido do Google, os usuários podem controlá-lo por meio do Google Home app (GHA), dos controles de energia do Android, da voz e dos dispositivos touchscreen touchscreen Nest.
O Mobile SDK também permite definir um serviço de comissionamento personalizado que pode ser usado para encomendar dispositivos a outros ecossistemas de Matter.
Integrar o SDK para dispositivos móveis ao seu app Android
Para começar, siga estas etapas:
Siga as instruções fornecidas 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 Play services home
é opcional e, portanto, a funcionalidade Matter só estará presente no dispositivo de um usuário se um app no dispositivo especificar a dependência de módulo Play services adequada no arquivo AndroidManifest.xml
.
O GHA e o Google Home Sample App for Matter incluem essa
dependência do módulo no manifesto. Se você estiver integrando o
Mobile SDK ao seu app Android, adicione o
bloco service
a seguir à declaração application
no arquivo
AndroidManifest.xml
para garantir a compatibilidade com Matter:
<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 Android dispositivos com Play services 22.50.14 ou mais recente.
Consulte o manifesto do Sample App for Matter para ver um exemplo de implementação.
É possível verificar a disponibilidade do módulo inicial no ambiente 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 uma versão mais recente, vai precisar incluir o bloco
queries
a seguir no AndroidManifest.xml
para que o app possa fazer chamadas para
outros.
<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.
Use o app de amostra do Google Home para casos
Para saber como o Mobile SDK funciona em um app Android, teste nosso Sample App for Matter.
Criar seu próprio aplicativo
Para ajudar você a começar rapidamente, disponibilizamos o Sample App for Matter de código aberto e fornecemos 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 o SDK lida com dados do usuário final, consulte a seção "Segurança dos dados" do SDK do Google Play para dispositivos móveis.