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 principali che consentono alle tue app di commissionare e condividere dispositivi con il tessuto Google.
Una volta aggiunto un dispositivo al tessuto Google, gli utenti possono controllarlo tramite Google Home app (GHA), controlli di accensione Android, comandi vocali e dispositivi con touchscreen Nest.
Mobile SDK ti consente anche di definire un servizio di provisioning personalizzato che puoi utilizzare per eseguire il provisioning dei dispositivi in altri ecosistemi Matter.
Integra l'SDK mobile nella tua app per Android
Per iniziare, completa i seguenti 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 pubblicazione del modulo
Il modulo Play services home è facoltativo, pertanto
la funzionalità Matter sarà presente sul dispositivo
dell'utente solo se un'app sul dispositivo specifica la dipendenza
dal modulo Play services appropriato nel file AndroidManifest.xml.
GHA e Google Home Sample App for Matter includono questa
dipendenza del modulo nel manifest. Se stai integrando
Mobile SDK nella tua app Android, per garantire
il supporto Matter per gli utenti della tua app, aggiungi il
seguente blocco service alla dichiarazione application all'interno del tuo
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 dell'Sample App for Matter.
Puoi verificare la disponibilità del modulo Home in fase di runtime utilizzando
ModuleInstallClient. Per saperne di più, consulta la pagina
Garantire la disponibilità dell'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 Filtraggio 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.
Crea la tua app
Per aiutarti a iniziare rapidamente, abbiamo reso open source Sample App for Matter e fornito un codelab di accompagnamento, che ti consente di personalizzare il nostro codice campione per i tuoi progetti Android.
Vai al codelab Sample App for Matter
Risorse
Per saperne di più su Mobile SDK, consulta il riferimento API.
Per scoprire come questo SDK gestisce i dati degli utenti finali, consulta la sezione Sicurezza dei dati di Google Play dell'SDK Home Mobile.