SDK Home Mobile per Android

Per aiutarti a creare applicazioni Android che interagiscano con Matter dispositivi, Google ha sviluppato l'Google Home Mobile SDK. L'API Mobile SDK include due API principali che consentono alle tue app di inviare e condividere dispositivi con l'infrastruttura Google.

Dopo aver aggiunto un dispositivo al tessuto di Google, gli utenti possono controllare i propri dispositivi tramite Google Home app (GHA), il controllo dell'alimentazione di Android, i comandi vocali e i dispositivi touchscreen.

Mobile SDK consente inoltre di definire un servizio di commissione personalizzato che puoi utilizzare per eseguire la commissione di dispositivi su ulteriori ecosistemi Matter.

Integra l'SDK Mobile nella tua app Android

Per iniziare, procedi come indicato di seguito:

  1. Segui le istruzioni fornite in Configurare 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'
    

Garantisci la distribuzione del modulo

Il modulo Play services home è facoltativo e 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 relativo file AndroidManifest.xml.

GHA e Google Home Sample App for Matter includono entrambi questa dipendenza del modulo nel loro manifest. Se stai integrando Mobile SDK nell'app Android, per garantire il supporto di Matter per gli utenti della tua app, aggiungi il seguente blocco service alla dichiarazione application nel 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 funzionalità è supportata solo per i dispositivi Android con Play services 22.50.14 o versioni successive.

Consulta il file manifest di Sample App for Matter per un esempio di implementazione.

Puoi controllare la disponibilità del modulo Home in fase di esecuzione utilizzando ModuleInstallClient. Per ulteriori informazioni, consulta la pagina Assicurare la disponibilità delle API con ModuleInstallClient.

Chiamare altre app per Android

Se usi 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 visibilità dei pacchetti su Android.

Utilizzare l'app Google Home di esempio per Matter

Per scoprire come funziona Mobile SDK da un'app Android, prova le nostre Sample App for Matter.

Prova Sample App for Matter

Crea la tua app

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

Vai al codelab di Sample App for Matter

Risorse

Per scoprire di più su Mobile SDK, consulta la documentazione di riferimento per le API.

Per scoprire come questo SDK gestisce i dati degli utenti finali, consulta la sezione Sicurezza dei dati di Google Play nell'SDK Home Mobile