Le Google Home Sample App for Matter utilise le Google Home Mobile SDK pour créer une application Android semblable à Google Home app (GHA). Cette application exemple offre les fonctionnalités suivantes :
- Mettre en service des appareils Matter physiques et virtuels Matter sur le réseau Android local
- Mettre en service des appareils physiques et virtuels sur un réseau de développement
- Contrôler les appareils de votre réseau de développement, par exemple allumer une lumière
- Les fonctionnalités multi-administrateurs vous permettent de partager des appareils sur le réseau de développement avec d'autres applications, et inversement d'inclure dans le réseau de développement des appareils partagés à partir d'autres applications
- Utilitaires pour les développeurs
Ce guide explique comment installer l'APK Sample App for Matter et l'utiliser pour mettre en service, contrôler et partager des appareils Matter.
Pour télécharger le code source, découvrez comment intégrer le Mobile SDK, et personnaliser les écrans dans Android Studio. Essayez notre Sample App for Matter atelier de programmation.
Accéder à l'atelier de programmationSample App for Matter
Prérequis
- Un appareil Android O (8.1, niveau d'API 27) ou version ultérieure disponible pour les tests. Pour vous assurer que votre appareil est compatible avec la dernière version de Matter, consultez le guide Matter Modules & Services.
- Créez un Matter appareil avec des fonctionnalités On/Off. Cette application exemple fonctionne avec un appareil virtuel et un ESP32.
- Appareil virtuel Matter (AVM). Pour minimiser les problèmes d'environnement, nous vous recommandons vivement d'utiliser l'AVM pour commencer. Si vous rencontrez des problèmes, il sera beaucoup plus facile d'enquêter si l'application exemple est utilisée avec l'AVM.
- Créez un Matter appareil virtuel
avec l'application
rootnode_dimmablelight_bCwGYSDpoe. Lorsque vous créez une intégration Matter dans la Google Home Developer Console, utilisez0xFFF1comme ID de fournisseur et0x8000comme ID de produit. - Créez un appareil Espressif
avec le
all-clusters-app. Lorsque vous créez une intégrationMatter dans la Developer Console, utilisez0xFFF1comme ID de fournisseur et0x8001comme ID de produit.
Vous n'avez pas besoin de hub, par exemple un Google Nest Hub (2nd gen), pour mettre en service et contrôler des appareils avec l'Sample App for Matter.
Sample App for MatterInstaller
Accédez à la section Releases (Versions) du dépôt Sample App for Matter GitHub. Pour la version la plus récente, recherchez dans la section "Assets" (Ressources) l'APK nommé
GHSAFM-version-default-debug.apk. Ne sélectionnez pastargetcommissioner.Installez Android Debug Bridge (adb) :
Connectez votre appareil Android via USB et activez File Transfer (Transfert de fichiers), puis installez l'APK :
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Mettre en service des appareils
Lorsque vous lancez l'application exemple pour la première fois, une boîte de dialogue s'affiche avec un lien vers l'atelier de programmation Sample App for Matter. Si vous sélectionnez Don't show this message again (Ne plus afficher ce message), vous pouvez afficher à nouveau la boîte de dialogue à tout moment en mettant à jour vos préférences dans la section "Admin" (Admin) de l'application.
Au cours des étapes suivantes, vous ajouterez un appareil Matter au réseau Android local, ainsi qu'un réseau de développement local à l'application exemple uniquement.
Que sont les réseaux Matter ?
Un réseau Matter est un domaine de confiance partagé entre les appareils d'un réseau domestique, qui leur permet de communiquer entre eux.
Les appareils peuvent avoir un ou plusieurs réseaux correspondant à une plate-forme, une application ou un groupe d'appareils interagissant ensemble. Les réseaux ont un ID unique, et les appareils partagent le même ensemble d'identifiants et d'autorité de certification (AC). Ces identifiants sont attribués lors de la Matter mise en service.
Pour mettre en service un appareil Matter, procédez comme suit :
Appuyez sur le bouton Ajouter un appareil pour lancer le processus de mise en service.
Le contrôle est ensuite transféré vers Google Play services, qui est lancé à partir d'un appel au Mobile SDK. Pour établir une preuve de possession, Scannez le code QR ou appuyez sur Utiliser le code d'association.
Une fois la mise en service terminée, saisissez un Nom de l'appareil, puis appuyez sur OK.
Votre appareil est désormais connecté au réseau Android local et au réseau de développement.
Tous les travaux de mise en service et les écrans associés sont gérés par Play services lors de la mise en service des appareils. Cela offre une expérience utilisateur cohérente et élimine la nécessité de gérer des autorisations sensibles, par exemple les identifiants Wi-Fi et Thread.
Contrôler des appareils
Le réseau de développement crée les identifiants permettant de contrôler Matter appareils directement depuis l'application exemple.
Sur l'écran d'accueil, vous pouvez activer ou désactiver votre appareil. Appuyez sur le appareil pour accéder à ses détails.
Partager les appareils
Le partage d'un appareil est appelé flux multi-administrateurs dans la Matter spécification. Une fois qu'un appareil est mis en service dans l'application exemple, vous pouvez facilement le partager avec d'autres écosystèmes.
Pour partager votre appareil Matter avec d'autres écosystèmes, vous devez installer une autre plate-forme sur votre appareil Android. Cette plate-forme externe devient le commissionnaire cible. Nous avons créé une autre instance de l'application exemple que vous pouvez utiliser comme commissionnaire cible.
Accédez à la section Releases (Versions) du dépôt Sample App for Matter GitHub. Pour la version la plus récente, recherchez dans la section "Assets" (Ressources) l'APK nommé
GHSAFM-version-targetcommissioner-debug.apk. Ne sélectionnez pasdefault.Installez le commissionnaire cible.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkSur l'écran d'accueil, appuyez sur l'appareil pour afficher ses informations. Appuyez sur Partager.
L'application exemple appelle l'API de partage Mobile SDK, et le contrôle est à nouveau transféré vers Play services.
Une feuille de partage s'affiche, ce qui vous permet de choisir l'application ou la plate-forme à laquelle vous souhaitez associer l'appareil. Cet écran vous offre deux façons de partager l'appareil :
- Manuellement via un code de configuration à partager avec l'application commissionnaire cible
- Avec une application Android locale enregistrée en tant que Matter commissionnaire
L'application commissionnaire cible est libellée GHSAFM-TC. Appuyez sur cette instance de l'application exemple pour partager votre appareil.
Ensuite, l'application externe (commissionnaire cible) termine la mise en service de l'appareil dans son propre réseau.
Paramètres
Sur l'écran d'accueil, cliquez sur l'icône settings Paramètres. Vous pouvez y mettre à jour les préférences utilisateur, obtenir de l'aide et en savoir plus sur l'application.
Notification en demi-feuille
Sur l'écran "Settings" (Paramètres), vous pouvez choisir de désactiver les notifications proactives de découverte des appareils pouvant être mis en service Matter.
Si votre application fournit son propre flux de découverte Matter ou de mise en service, vous pouvez supprimer ces notifications pour éviter les interruptions. Pour en savoir plus, consultez la section Supprimer les notifications de découverte des appareils pouvant être mis en service.
Utilitaires pour les développeurs
Sur l'écran "Settings" (Paramètres), vous pouvez également accéder aux Utilitaires pour les développeurs.
Pour examiner le contenu des dépôts Device and User Preferences DataStore dans Logcat, procédez comme suit :
Cliquez sur Log repositories content (Enregistrer le contenu des dépôts).
Cliquez sur OK dans la boîte de dialogue, puis cochez Logcat.
Commentaires et aide
Pour nous faire part de vos commentaires sur la façon dont nous pouvons améliorer l'expérience de développement avec Sample App for Matter, remplissez notre formulaire de commentaires.
Si vous rencontrez des problèmes avec le Sample App for Matter, essayez de suivre les étapes pour vérifier votre environnement :
Si vous avez des questions sur l'utilisation de l'application exemple ou si vous découvrez un bug dans le code, vous pouvez signaler les problèmes dans l'outil de suivi des problèmes du dépôt GitHub :
Pour obtenir des conseils officiels de Google sur les questions techniques, utilisez le forum des développeurs pour la maison connectée :
Pour obtenir une assistance technique de la communauté, utilisez le tag google-smart-home sur Stack Overflow :