SDK Home Mobile per Android

Per aiutarti a creare applicazioni per Android che interagiscono con i dispositivi Matter, Google ha sviluppato Google Home Mobile SDK. Mobile SDK include due API di base che consentono alle tue app di commissionare e condividere dispositivi con la piattaforma Google.

Una volta aggiunto un dispositivo alla piattaforma Google, gli utenti possono controllarli tramite Google Home app (GHA), i controlli dell'alimentazione di Android, i comandi vocali e i dispositivi Nest con touchscreen.

Mobile SDK ti consente anche di definire un servizio di messa in servizio personalizzato che puoi utilizzare per mettere in servizio i dispositivi in altri ecosistemi Matter.

Integrare l'SDK mobile nell'app per Android

Per iniziare, segui questi passaggi:

  1. Segui le istruzioni riportate in Configura Google Play services.

  2. Aggiungi la dipendenza Play services al file build.gradle:

    implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'

Garantire la pubblicazione del modulo

Il modulo Play services home è facoltativo, pertanto la funzionalità Matter sarà presente sul dispositivo di un utente solo se un'app sul dispositivo specifica la dipendenza del modulo Play services appropriata nel file AndroidManifest.xml.

GHA e Google Home Sample App for Matter includono entrambi questa dipendenza dal modulo nel manifest. Se stai integrando Mobile SDK nella tua app Android, per garantire il supporto di Matter per gli utenti della tua app, aggiungi il seguente blocco service alla dichiarazione application all'interno del file 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>

Questa opzione è supportata solo per i dispositivi Android con Play services 22.50.14 o versioni successive.

Per un esempio di implementazione, consulta il file manifest di Sample App for Matter.

Puoi verificare la disponibilità del modulo Home in fase di esecuzione utilizzando ModuleInstallClient. Per ulteriori informazioni, consulta la pagina Garantire la disponibilità dell'API con ModuleInstallClient.

Chiamate ad altre app per Android

Se utilizzi Android 11 o versioni successive, devi includere il seguente blocco queries in AndroidManifest.xml in modo che la tua app possa effettuare chiamate ad altre app.

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

Per ulteriori informazioni, consulta l'articolo Filtro della visibilità dei pacchetti su Android.

Utilizzare l'app di esempio Google Home per Matter

Per scoprire come funziona Mobile SDK da un'app per Android, prova il nostro Sample App for Matter.

Prova Sample App for Matter

Creare la tua app

Per aiutarti a iniziare rapidamente, abbiamo reso open source il Sample App for Matter e fornito un codelab complementare, che ti consente di personalizzare il nostro codice di esempio per i tuoi progetti Android.

Vai al codelab Sample App for Matter

Risorse

Per scoprire di più su Mobile SDK, consulta il riferimento API.

Per scoprire in che modo questo SDK gestisce i dati degli utenti finali, consulta la sezione Sicurezza dei dati di Google Play dell'SDK Home Mobile.