Per aiutarti a creare applicazioni Android che interagiscono con i dispositivi Matter, Google ha sviluppato il Google Home Mobile SDK. Il Mobile SDK include due API principali che consentono alle tue app di eseguire il provisioning e condividere i dispositivi con il fabric Google.
Una volta aggiunto un dispositivo al fabric Google, gli utenti possono controllare i loro dispositivi tramite Google Home app (GHA), i controlli di alimentazione di Android, i comandi vocali, e i dispositivi con touchscreen Nest.
Il Mobile SDK ti consente anche di definire un servizio di commissioning personalizzato che puoi utilizzare per eseguire il commissioning dei dispositivi in altri Matter ecosistemi.
Integra Mobile SDK nella tua app per Android
Per iniziare, segui questi passaggi:
Segui le istruzioni fornite in Configurare Google Play services.
Aggiungi la dipendenza Play services al file
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Garantire la distribuzione dei moduli
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.
Sia GHA sia Google Home Sample App for Matter includono questa
dipendenza del modulo nel manifest. Se stai integrando il
Mobile SDK nella tua Android app, per garantire il
Matter supporto 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 funzionalità è supportata solo per i dispositivi Android con Play services 22.50.14 o versioni successive.
Per un esempio di implementazione, consulta il manifest Sample App for Matter's.
Puoi verificare la disponibilità del modulo Home in fase di runtime utilizzando ModuleInstallClient. Per saperne di più, consulta la
pagina Garantire la disponibilità delle API con ModuleInstallClient.
Chiamare 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.
Utilizza l'app di esempio Google Home per Matter
Per scoprire come funziona Mobile SDK da un'app per Android, prova la nostra Sample App for Matter.
Crea 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 codelabSample App for Matter
Risorse
Per saperne 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 di Home Mobile SDK.