Para ajudar você a criar aplicativos Android que interajam com Matter, o Google desenvolveu o Google Home Mobile SDK. A O Mobile SDK inclui duas APIs principais que permitem que seus apps comissionar e compartilhar dispositivos com a estrutura do Google.
Depois que um dispositivo é adicionado à estrutura do Google, seus usuários podem controlar dispositivos pelo Google Home app (GHA), controles liga/desliga do Android, voz, e dispositivos com tela touch do Nest.
O Mobile SDK também permite definir serviço de comissionamento personalizado que você pode usar para comissionar dispositivos a mais Matter ecossistemas.
Integrar o SDK para dispositivos móveis ao seu app Android
Para começar, siga estas etapas:
Siga as instruções fornecidas em Configure 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 o envio do módulo
O módulo Play services home
é opcional e, portanto,
A funcionalidade Matter só estará presente no
do dispositivo se um aplicativo nesse dispositivo especificar as
Dependência do módulo Play services no arquivo AndroidManifest.xml
.
GHA e Google Home Sample App for Matter incluem isso
de módulo no manifesto. Se você estiver integrando
Mobile SDK no app Android para garantir
Matter para os usuários do seu app, adicione o
seguinte bloco service
para a declaração application
em sua
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>
Compatível apenas com Android dispositivos que executam Play services 22.50.14 ou mais recente.
Consulte a Sample App for Matter manifesto um exemplo de implementação.
É possível verificar a disponibilidade do módulo Home no tempo de execução usando
ModuleInstallClient
: Consulte a
Como garantir a disponibilidade da API com ModuleInstallClient
para mais informações.
Ligar para outros apps Android
Se você estiver usando o Android 11 ou mais recente, inclua o seguinte:
Bloco queries
no AndroidManifest.xml
para que o app possa fazer chamadas para
e 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 a Artigo Filtragem da visibilidade de pacotes no Android.
Usar o app de exemplo 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, abrimos o código aberto do Sample App for Matter e disponibilizou um codelab complementar, personalizar 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 do Google Play" do SDK do Home para dispositivos móveis.