Google Home Sample App for Matter utilise Google Home Mobile SDK pour créer une application Android semblable à Google Home app (GHA). Cette application exemple fournit les fonctionnalités suivantes:
- Commander des appareils Matter physiques et virtuels sur la structure Android locale
- Construire des appareils physiques et virtuels dans une structure de développement
- Contrôler les appareils sur votre tissu de développement, par exemple en allumant une lumière
- Les fonctionnalités multi-administrateurs vous permettent de partager des appareils de la structure de développement avec d'autres applications et, à l'inverse, d'inclure les appareils de développement créés par d'autres applications.
- Utilitaires développeur
Ce guide explique comment installer l'APK Sample App for Matter et l'utiliser pour commander, contrôler et partager des appareils Matter.
Pour télécharger le code source, découvrir comment intégrer Mobile SDK et personnaliser les écrans dans Android Studio, suivez notre atelier de programmation Sample App for Matter.
Accéder à l'atelier de programmation sur Sample App for Matter
Conditions préalables
- Un appareil Android O (8.1, niveau d'API 27) ou version ultérieure pouvant être testé Pour vous assurer que votre appareil est compatible avec la dernière version de Matter, consultez le guide Vérifier les modules et services Matter.
- Créez un appareil Matter avec des fonctionnalités Activé/Désactivé. Cet exemple d'application fonctionne avec un appareil virtuel et ESP32.
- Créez un appareil virtuel Matter avec l'application
rootnode_dimmablelight_bCwGYSDpoe. Lorsque vous créez une intégration Matter dans Google Home Developer Console, utilisez0xFFF1comme ID fournisseur et0x8000comme ID produit. - Compilez un appareil Espressif avec le
all-clusters-app. Lorsque vous créez une intégration Matter dans Developer Console, utilisez0xFFF1comme ID de fournisseur et0x8001comme ID produit.
- Créez un appareil virtuel Matter avec l'application
Vous n'avez pas besoin d'un hub, par exemple un Google Nest Hub (2nd gen), pour commander et contrôler les appareils avec le Sample App for Matter.
Installer
Accédez à la section "Versions" du dépôt GitHub Sample App for Matter. Recherchez l'APK nommé
GHSAFM-1.4.1-default-debug.apk. Ne sélectionnez pas la classetargetcommissioner: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-1.4.1-default-debug.apk
Mettre des appareils en service
Lorsque vous lancez l'application exemple pour la première fois, une boîte de dialogue contenant un lien vers l'atelier de programmation Sample App for Matter s'affiche. Si vous sélectionnez Ne plus afficher ce message, vous pouvez revenir à la boîte de dialogue à tout moment en mettant à jour vos préférences dans la section "Administration" de l'application.
Dans les étapes suivantes, vous allez ajouter un appareil Matter au tissu Android local, ainsi qu'un tissu de développement local uniquement à l'exemple d'application.
Que sont les tissus Matter ?
Un tissu 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 comporter un ou plusieurs tissus correspondant à une plate-forme, une application ou un groupe d'appareils qui interagissent entre eux. Les tissus ont un ID unique, et les appareils partagent le même ensemble d'identifiants et d'autorité de certification (CA). Ces identifiants sont attribués lors de la mise en service de Matter.
Pour commander 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é à Google Play services, qui est lancé à partir d'un appel à Mobile SDK. Pour établir une preuve de possession, Scannez le code QR ou appuyez sur Utiliser un code d'association.
Une fois la mise en service terminée, saisissez un nom d'appareil, puis appuyez sur OK.
Votre appareil est maintenant connecté au tissu local Android et au tissu de développement.
Toutes les tâches 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 vous évite de devoir gérer des autorisations sensibles (par exemple, les identifiants Wi-Fi et Thread).
Contrôler des appareils
La structure de développement crée les identifiants permettant de contrôler les appareils Matter directement depuis l'application exemple.
Sur l'écran d'accueil, vous pouvez activer ou désactiver votre appareil. Appuyez sur l'appareil pour accéder aux informations le concernant.
Partager les appareils
Le partage d'un appareil est appelé flux multi-administrateur dans la spécification Matter. Une fois qu'un appareil est commandé 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 disposer d'une autre plate-forme sur votre appareil Android. Cette plate-forme externe devient le commissaire cible. Nous avons créé une autre instance de l'application exemple que vous pouvez utiliser en tant que commissionnaire cible.
Accédez à la section "Versions" du dépôt GitHub Sample App for Matter. Recherchez l'APK le plus récent nommé
GHSAFM-[version]-targetcommissioner, par exempleGHSAFM-1.4.1-targetcommissioner-debug.apk:Installez le commissaire cible.
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apkSur l'écran d'accueil, appuyez sur l'appareil pour afficher les informations le concernant. Appuyez sur Partager.
L'application exemple appelle l'API Share Mobile SDK, et une fois encore, le contrôle est transféré à 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 permet de partager l'appareil de deux manières:
- Manuellement, via un code de configuration à partager avec l'application cible du commissaire
- Avec une application Android locale enregistrée en tant que commissaire Matter
L'application de commissionneur cible est nommée GHSAFM-TC. Appuyez sur cette instance de l'application exemple pour partager votre appareil.
Ensuite, l'application externe (commissaire cible) finalise la mise en service de l'appareil dans son propre tissu.
Paramètres
Sur l'écran d'accueil, cliquez sur l'icône Paramètres . Vous pouvez alors mettre à jour les préférences utilisateur, obtenir de l'aide et en savoir plus sur l'application.
Notification de demi-feuille
Sur l'écran "Paramètres", vous pouvez choisir de désactiver les notifications de découverte proactives pour commission pour les appareils Matter.
Si votre application fournit son propre flux de découverte ou de mise en service Matter, vous pouvez supprimer ces notifications pour éviter toute interruption. Pour en savoir plus, consultez la section Supprimer les notifications de découverte composables.
Utilitaires développeur
Depuis l'écran "Paramètres", vous pouvez également accéder aux utilitaires pour les développeurs.
Pour examiner le contenu des dépôts DataStore des préférences relatives aux appareils et aux utilisateurs dans Logcat, procédez comme suit:
Cliquez sur Journal des dépôts.
Cliquez sur OK dans la boîte de dialogue, puis cochez la case Logcat.
Commentaires et aide
Pour nous envoyer des commentaires sur la façon dont nous pouvons améliorer l'expérience de développement avec Sample App for Matter, veuillez remplir notre formulaire de commentaires.
Si vous rencontrez des problèmes avec Sample App for Matter, essayez de suivre la procédure pour valider votre environnement:
Si vous avez des questions sur l'utilisation de l'application exemple ou pour détecter un bug de code, vous pouvez envoyer des problèmes à Issue Tracker dans le dépôt GitHub:
Pour obtenir les conseils officiels de Google sur les questions techniques, consultez 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: