SDK do Home para dispositivos móveis para Android

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:

  1. Siga as instruções fornecidas em Configure o 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 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.

Teste o 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.