Pour vous aider à créer des applications Android qui interagissent avec Matter, Google a développé le Google Home Mobile SDK La Mobile SDK inclut deux API principales qui permettent à vos applications de de commander et de partager des appareils avec la structure Google.
Une fois qu'un appareil est ajouté à la structure Google, vos utilisateurs peuvent contrôler leurs appareils via le Google Home app (GHA), commandes d'alimentation Android, commandes vocales, et les appareils à écran tactile Nest.
Mobile SDK vous permet également de définir service de mise en service personnalisé que vous pouvez utiliser pour mettre des appareils en service afin d'ajouter des Matter de ces écosystèmes.
Intégrer le SDK pour mobile à votre application Android
Pour commencer, procédez comme suit:
Suivez les instructions fournies sur la page Configurez 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 distribution des modules
Le module home Play services est facultatif. Par conséquent,
La fonctionnalité Matter ne sera disponible que dans la version
appareil si une application sur l'appareil spécifie
Dépendance du module Play services dans son fichier AndroidManifest.xml.
GHA et Google Home Sample App for Matter incluent tous deux ceci
dans leur fichier manifeste. Si vous intégrez le
Mobile SDK dans votre application Android, pour vous assurer
Matter pour les utilisateurs de votre application, ajoutez le
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>
Ceci n'est compatible qu'avec les appareils Android en cours d'exécution Play services 22.50.14 ou version ultérieure.
Découvrez les Sample App for Matter fichier manifeste pour obtenir un exemple d'implémentation.
Vous pouvez vérifier la disponibilité du module Home au moment de l'exécution en utilisant
ModuleInstallClient Consultez le
Garantir la disponibilité de l'API avec ModuleInstallClient
pour en savoir plus.
Appeler d'autres applications Android
Si vous utilisez Android 11 ou une version ultérieure, vous devez inclure les éléments suivants :
Bloc queries dans AndroidManifest.xml pour que votre application puisse passer des appels vers
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 les Article Filtrer la visibilité des packages sur Android
Utiliser l'application exemple Google Home pour Matter
Pour savoir 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 partagé le Sample App for Matter et fourni un atelier de programmation associé vous permettant 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 les Documentation de référence de l'API
Pour savoir 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.