Pour vous aider à créer des applications Android qui interagissent avec les appareils Matter, Google a développé Google Home Mobile SDK. Mobile SDK inclut deux API principales qui permettent à vos applications de mettre en service et de partager des appareils avec Google Fabric.
Une fois un appareil ajouté à Google Fabric, vos utilisateurs peuvent le contrôler via Google Home app (GHA), les commandes d'alimentation Android, la voix 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 des écosystèmes Matter supplémentaires.
Intégrer le SDK Mobile à votre application Android
Pour commencer, procédez comme suit :
Suivez les instructions fournies dans 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 des modules
Le module Play services home 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 assurer la compatibilité de Matter 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 fonctionnalité n'est disponible que sur les appareils Android équipés de Play services 22.50.14 ou version ultérieure.
Pour obtenir un exemple d'implémentation, consultez le manifeste de Sample App for Matter.
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 le 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 comment fonctionne Mobile SDK à partir d'une application Android, essayez notre Sample App for Matter.
Créer votre propre application
Pour vous aider à démarrer rapidement, nous avons rendu Sample App for Matter Open Source et fourni un atelier de programmation associé. Vous pouvez ainsi 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 pour le SDK Home Mobile.