Pour vous aider à créer des applications Android qui interagissent avec les appareils Matter, Google a développé le Google Home Mobile SDK. Mobile SDK inclut deux API principales qui permettent à vos applications de mettre en service et de partager des appareils avec le tissu Google.
Une fois qu'un appareil a été ajouté au tissu Google, vos utilisateurs peuvent le contrôler via Google Home app (GHA), les commandes d'alimentation Android, la commande vocale et les appareils Nest à écran tactile.
Mobile SDK vous permet également de définir un service de mise en service personnalisé que vous pouvez utiliser pour mettre en service des appareils dans d'autres écosystèmes Matter.
Intégrer le SDK Mobile à votre application Android
Pour commencer, procédez comme suit:
Suivez les instructions fournies dans la section Configurer Google Play services.
Ajoutez la dépendance Play services à votre fichier
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Assurer la diffusion du module
Le module home Play services est facultatif. Par conséquent, la fonctionnalité Matter ne sera présente sur l'appareil d'un utilisateur que si une application sur l'appareil spécifie la dépendance de module Play services appropriée dans son fichier AndroidManifest.xml.
GHA et Google Home Sample App for Matter incluent tous deux cette dépendance de module dans leur fichier manifeste. Si vous intégrez Mobile SDK à votre application Android, pour vous assurer que Matter est compatible avec les utilisateurs de votre application, ajoutez le bloc service suivant à la déclaration application dans votre fichier 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>
Cette option n'est compatible qu'avec les appareils Android exécutant Play services 22.50.14 ou version ultérieure.
Consultez le fichier manifeste de Sample App for Matter pour obtenir un exemple d'implémentation.
Vous pouvez vérifier la disponibilité du module Home au moment de l'exécution à l'aide de ModuleInstallClient. Pour en savoir plus, consultez la page Assurer la disponibilité de l'API avec ModuleInstallClient.
Appeler d'autres applications Android
Si vous utilisez Android 11 ou version ultérieure, vous devez inclure le bloc queries suivant dans AndroidManifest.xml pour que votre application puisse appeler d'autres applications.
<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>
Pour en savoir plus, consultez l'article Filtrer la visibilité des packages sur Android.
Utiliser l'application exemple Google Home pour Matter
Pour découvrir le fonctionnement de Mobile SDK à partir d'une application Android, consultez notre Sample App for Matter.
Créer votre propre application
Pour vous aider à démarrer rapidement, nous avons partagé Sample App for Matter en Open Source et proposé un atelier de programmation associé, qui vous permet de personnaliser notre exemple de code pour vos propres projets Android.
Accéder à l'atelier de programmation Sample App for Matter
Ressources
Pour en savoir plus sur Mobile SDK, consultez la documentation de référence de l'API.
Pour savoir comment ce SDK gère les données des utilisateurs finaux, consultez la section Sécurité des données de Google Play du SDK Home Mobile.