SDK do Home para dispositivos móveis para Android

Para ajudar você a criar aplicativos Android que interagem com Matter dispositivos, o Google desenvolveu o Google Home Mobile SDK. O Mobile SDK inclui duas APIs principais que permitem que seus apps provisionem e compartilhem dispositivos com o Google fabric.

Depois que um dispositivo é adicionado ao Google fabric, os usuários podem controlar os dispositivos pelo Google Home app (GHA), controles de energia do Android, voz, e dispositivos com tela sensível ao toque do Nest.

O Mobile SDK também permite definir um serviço de provisionamento personalizado que pode ser usado para provisionar dispositivos em outros Matter ecossistemas.

Integrar o SDK Mobile ao seu app Android

Para começar, siga estas etapas:

  1. Siga as instruções fornecidas em Configurar Google Play services.

  2. 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, Matter funcionalidade 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 seu Android app, para garantir o Matter suporte 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 Android dispositivos que executam Play services 22.50.14 ou mais recente.

Consulte o Sample App for Matter's manifesto para conferir um exemplo de implementação.

É possível verificar a disponibilidade do módulo Home no ambiente de execução usando ModuleInstallClient. Consulte a página Garantir a disponibilidade da API com ModuleInstallClient para mais informações.

Chamar 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 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 Matter

Para saber como o Mobile SDK funciona em um app Android, teste nosso Sample App for Matter.

Testar o 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 fornecemos um codelab complementar, permitindo que você personalize nosso exemplo de código para seus próprios projetos Android.

Acesse o codelabSample App for Matter

Recursos

Para saber mais sobre o Mobile SDK, consulte a referência da API.

Para saber como esse SDK processa os dados do usuário final, consulte a seção Segurança dos dados do SDK do Google Home Mobile no Google Play.