Aiutarti a creare app Android che interagiscono con Matter, Google ha sviluppato Google Home Mobile SDK. La Mobile SDK include due API principali che consentono alle tue app di mettere in servizio e condividere dispositivi con la struttura di Google.
Dopo aver aggiunto un dispositivo alla struttura Google, gli utenti possono controllare dispositivi tramite Google Home app (GHA), controlli risparmio energia di Android, comandi vocali, e i dispositivi touchscreen Nest.
Il Mobile SDK consente inoltre di definire servizio di messa in servizio personalizzato che puoi usare per commissionere i dispositivi ad altri Matter ecosistemi.
Integra l'SDK per dispositivi mobili nella tua app per Android
Per iniziare, completa i seguenti passaggi:
Segui le istruzioni fornite all'indirizzo 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 consegna dei moduli
Il modulo home Play services è facoltativo, pertanto
La funzionalità Matter sarà presente solo nella
dispositivo, se un'app sul dispositivo specifica
Dipendenza del modulo Play services nel relativo file AndroidManifest.xml.
GHA e Google Home Sample App for Matter includono questo
del modulo nel file manifest. Se integri il
Mobile SDK nell'app Android per assicurarti
Matter per gli utenti della tua app, aggiungi il
dopo il blocco service alla dichiarazione application in
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 azione è supportata solo per Android dispositivi in esecuzione Play services 22.50.14 o successiva.
Leggi le Sample App for Matter file manifest per un'implementazione di esempio.
Puoi verificare la disponibilità del modulo Home in fase di runtime utilizzando
ModuleInstallClient. Consulta le
Garanzia della disponibilità dell'API con ModuleInstallClient
pagina per ulteriori informazioni.
Chiamata ad altre app Android
Se usi Android 11 o versioni successive, devi includere quanto segue.
Blocco di queries in AndroidManifest.xml affinché la tua app possa effettuare chiamate a
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 Articolo Filtro di 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 le nostre Sample App for Matter.
Crea la tua app
Per aiutarti a iniziare rapidamente, abbiamo reso open source Sample App for Matter e ti ha fornito un codelab companion, che ti consente di personalizzare il nostro codice campione per i tuoi progetti Android.
Vai al codelab Sample App for Matter
Risorse
Per scoprire di più su Mobile SDK, consulta le Riferimento API.
Per informazioni su come questo SDK gestisce i dati degli utenti finali, consulta la sezione Sicurezza dei dati di Google Play relativa all'SDK Home Mobile.