SDK Home Mobile pour Android

Pour vous aider à créer des applications Android qui interagissent avec les appareils Matter, Google a développé Google Home Mobile SDK. Le Mobile SDK comprend 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 est ajouté au tissu Google, vos utilisateurs peuvent contrôler leurs appareils via Google Home app (GHA), les commandes d'alimentation Android, la voix et les appareils à écran tactile Nest.

Le Mobile SDK vous permet également de définir un service de mise en service personnalisé que vous pouvez utiliser pour mettre les appareils en service dans d'autres écosystèmes de Matter.

Intégrer le SDK Mobile dans votre application Android

Pour commencer, procédez comme suit:

  1. Suivez les instructions fournies dans Configurer Google Play services.

  2. 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 n'est présente sur l'appareil d'un utilisateur que si une application de 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 les deux cette dépendance de module dans leur fichier manifeste. Si vous intégrez Mobile SDK dans votre application Android, pour garantir la prise en charge de Matter pour 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 compatibilité n'est disponible que pour les appareils Android exécutant la version Play services 22.50.14 ou 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 d'accueil au moment de l'exécution à l'aide de ModuleInstallClient. Pour en savoir plus, consultez la page Garantir la disponibilité de l'API avec ModuleInstallClient.

Appeler d'autres applications Android

Si vous utilisez Android 11 ou une 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 comment Mobile SDK fonctionne à partir d'une application Android, essayez notre Sample App for Matter.

Essayer Sample App for Matter

Créer votre propre application

Pour vous aider à démarrer rapidement, nous avons publié l'Sample App for Matter en Open Source et fourni un atelier de programmation associé. Il vous permet de personnaliser notre exemple de code pour vos propres projets Android.

Accéder à l'atelier de programmation sur Sample App for Matter

Ressources

Pour en savoir plus sur Mobile SDK, consultez la documentation de référence de l'API.

Pour découvrir comment ce SDK traite les données des utilisateurs finaux, consultez la section sur la sécurité des données de Google Play dans le SDK Home Mobile.