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 fournit les fonctionnalités suivantes:
- Mettre en service des appareils Matter physiques et virtuels pour Structure Android locale
- Mettre en service des appareils physiques et virtuels avec une structure de développement
- Contrôler les appareils de votre structure de développement, par exemple en activant un léger
- Les fonctionnalités multi-administrateurs vous permettent de partager des appareils sur la structure de développement avec d'autres applications et, à l'inverse, être en mesure d'inclure appareils fabriqués à partir d'autres applications
- Utilitaires de développement
Ce guide explique comment installer l'APK Sample App for Matter et utiliser pour mettre en service, contrôler et partager Matter appareils.
Pour télécharger le code source, découvrez comment intégrer Mobile SDK et personnaliser les écrans dans Android Studio, essayez notre Atelier de programmation Sample App for Matter.
Accéder à l'atelier de programmation Sample App for Matter
Prérequis
- Un appareil équipé d'Android O (8.1, niveau d'API 27) ou version ultérieure disponible à des fins de test. Pour vous assurer que votre appareil dispose de la dernière prise en charge de Matter, consultez le guide Vérifier les modules et services Matter.
- Créez un appareil Matter doté de fonctionnalités Marche/Arrêt. Ce
L'application exemple fonctionne avec un appareil virtuel et un proxy ESP32.
- Appareil virtuel Matter (MVD). Pour limiter les problèmes liés à l'environnement, nous vous conseillons vivement d'utiliser MVD pour commencer. Si jamais vous rencontrez des problèmes, il vous sera beaucoup plus facile de déterminez si l'application exemple est utilisée avec le MVD.
- 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 du fournisseur et0x8000comme ID du produit. - Créez un appareil Espressif avec
all-clusters-app. Lorsque vous Créer une intégration Matter dans le Developer Console, utilisez0xFFF1comme ID de fournisseur et0x8001comme ID produit.
Vous n'avez pas besoin d'un hub (un Google Nest Hub (2nd gen), par exemple) pour effectuer des commissions et contrôler les appareils avec Sample App for Matter.
Installer
Accédez à la section Versions. dans le GitHub Sample App for Matter un dépôt de clés. Dans la section "Éléments" de la version la plus récente, l'APK nommé
GHSAFM-version-default-debug.apkNe sélectionnez pas l'icônetargetcommissionerInstallez Android Debug Bridge (adb):
Connectez votre appareil Android à l'aide d'un câble USB et activez le 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 Ne plus afficher ce message, vous pouvez afficher à nouveau la boîte de dialogue à tout moment en modifiant vos préférences dans la section "Administration" de l'application.
Au cours des étapes suivantes, vous allez ajouter un appareil Matter au Plate-forme Android locale, ainsi qu'une structure de développement locale dans l'exemple app uniquement.
Qu'est-ce que le tissu Matter ?
Une structure Matter est un domaine de confiance partagé entre les appareils dans un réseau domestique qui leur permet de communiquer entre eux.
Les appareils peuvent avoir un ou plusieurs tissus correspondant à une plate-forme, une application ou un groupe d'appareils qui interagissent entre eux. Les tissus ont une et les appareils partagent le même ensemble d'identifiants et la même autorité de certification (CA). Ces identifiants sont attribués pendant Matter mise en service.
Pour mettre en service un appareil Matter, procédez comme suit:
Appuyez sur le bouton Ajouter . Bouton de l'appareil permettant de lancer le processus de mise en service.
Ensuite, le contrôle est transféré à Google Play services, qui est lancé à partir d'un appel à Mobile SDK. Pour établir la 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 d'appareil, puis appuyez sur OK.
Votre appareil est à présent connecté à la fois à la structure Android locale et au de développement d'applications.
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. Ce offre une expérience utilisateur cohérente et évite d'avoir à gérer des données (identifiants Wi-Fi et Thread, par exemple).
Contrôler des appareils
La structure de développement crée les identifiants Matter appareils directement depuis l'application exemple.
Depuis l'écran d'accueil, vous pouvez activer ou désactiver votre appareil. Appuyez sur l'icône appareil pour accéder aux détails de l'appareil.
Partager les appareils
Le partage d'un appareil est appelé flux multi-administrateur dans la Matter. Une fois qu'un appareil a été mis en service pour l'application exemple, vous pouvez facilement le partager. avec d'autres écosystèmes.
Pour partager votre appareil Matter avec d'autres écosystèmes : une autre plate-forme doit être installée sur votre appareil Android. Cette plate-forme externe devient le commissaire cible. Nous avons créé une autre une instance de l'application exemple que vous pouvez utiliser comme commissaire cible.
Accédez à la section Versions. dans le GitHub Sample App for Matter un dépôt de clés. Dans la section "Éléments" de la version la plus récente, l'APK nommé
GHSAFM-version-targetcommissioner-debug.apkNe sélectionnez pasdefaultInstallez le commissaire 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 Share Mobile SDK et, une fois de plus, le contrôle est transféré à Play services.
Une feuille de partage s'affiche, vous permettant de choisir l'application ou la plate-forme que vous voulez associer l'appareil. Cet écran vous propose deux façons de partager appareil:
- manuellement, via un code de configuration à partager avec l'application de commissaire cible ;
- Avec une application Android locale enregistrée en tant que Commissaire à Matter
L'application du commissaire cible porte le libellé GHSAFM-TC. Appuyez sur cette instance du application exemple pour partager votre appareil.
Ensuite, l'application externe (commissaire cible) termine la mise en service l'appareil dans son propre tissu.
Paramètres
Sur l'écran d'accueil, cliquez sur l'icône Paramètres . Vous pouvez y modifier les préférences utilisateur, obtenir de l'aide et en savoir plus sur l'application.
Notification de demi-feuille
Dans l'écran "Paramètres", vous pouvez choisir de désactiver l'offre proactive ouvrant droit à commission notifications de découverte pour Matter appareils.
Si votre application fournit sa propre détection ou Matter de mise en service, vous pouvez supprimer ces notifications pour éviter sans interruption. Voir Supprimer la découverte ouvrant droit à commission notifications pour en savoir plus.
Utilitaires pour les développeurs
Depuis l'écran "Paramètres", vous pouvez également accéder aux utilitaires pour les développeurs.
Examiner le contenu des dépôts DataStore des préférences utilisateur et des appareils Dans Logcat, procédez comme suit:
Cliquez sur Contenu des dépôts de journaux.
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 Sample App for Matter, essayez de terminer les étapes à suivre pour vérifier votre environnement:
Si vous avez des questions sur l'utilisation de l'application exemple ou si vous découvrez un bug de code, vous pouvez signaler les problèmes via l'outil Issue Tracker dans le dépôt GitHub:
Pour obtenir des conseils officiels de la part de Google sur des questions techniques, utilisez l'application Forum des développeurs:
Pour obtenir une assistance technique de la communauté, utilisez la balise google-smart-home sur Stack Overflow :