Per aiutarti a creare app 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 nella tua app per Android
Per iniziare, completa i seguenti passaggi:
Segui le istruzioni riportate in Configura Google Play services.
Aggiungi la dipendenza Play services al tuo 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 Assicurarsi 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 saperne di più, consulta l'articolo Filtro della visibilità dei pacchetti su Android.
Utilizzare l'app di esempio di Google Home per Matter
Per scoprire come funziona Mobile SDK da un'app per Android, prova il nostro Sample App for Matter.
Creare la tua app
Per aiutarti a iniziare rapidamente, abbiamo reso open source 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.