Appli Google Home pour Matter

Application exemple Google Home pour Matter

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:

  • Mettre en service des appareils Matter physiques et virtuels sur le tissu Android local
  • Mettre en service des appareils physiques et virtuels sur un tissu de développement
  • Contrôler les appareils de votre canevas de développement, par exemple allumer une lumière
  • 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 pour les développeurs

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.

<ph type="x-smartling-placeholder"></ph> Accéder à l'atelier de programmation Sample App for Matter

Prérequis

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

  1. Accédez à la section Releases (Versions) du dépôt GitHub Sample App for Matter. Pour la version la plus récente, recherchez dans la section "Composants" l'APK nommé GHSAFM-version-default-debug.apk. Ne sélectionnez pas targetcommissioner

  2. Installez Android Debug Bridge (adb):

    <ph type="x-smartling-placeholder"></ph> Installer adb

  3. 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 à tout moment afficher à nouveau la boîte de dialogue en mettant à jour 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.

Que sont les matières Matter ?

Application exemple Google Home pour 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 fabrics disposent d'un ID unique, 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:

  1. Appuyez sur le bouton  Ajouter un appareil pour lancer le processus de mise en service.

    Ajouter un appareil

  2. Ensuite, le contrôle est transféré à Google Play services, qui est lancé d'un appel à Mobile SDK. Pour fournir une preuve de possession, Scannez le code QR ou appuyez sur Utiliser le code d'association.

    Scanner le code QR

  3. Une fois la mise en service terminée, saisissez un nom d'appareil, puis appuyez sur OK.

Votre appareil est maintenant connecté à la fois à la structure Android locale et au de développement d'applications.

Tout le travail 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

Le fabric de développement crée les identifiants permettant de contrôler les appareils Matter directement à partir de 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.

Appareil ajouté

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, vous devez installer 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 comme commissaire cible.

  1. Accédez à la section Releases (Versions) du dépôt GitHub Sample App for Matter. Dans la section "Éléments" de la version la plus récente, l'APK nommé GHSAFM-version-targetcommissioner-debug.apk Ne sélectionnez pas default.

  2. Installez le commissaire cible.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. Sur l'écran d'accueil, appuyez sur l'appareil pour afficher les informations le concernant. Appuyez sur Partager.

    Partager l&#39;appareil

L'application exemple appelle l'API Mobile SDK Share et, là encore, 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:

  1. manuellement, via un code de configuration à partager avec l'application de commissaire cible ;
  2. 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 de l'application exemple pour partager votre appareil.

Ensuite, l'application externe (commissaire cible) termine la mise en service de l'appareil dans son propre fabric.

Paramètres

Sur l'écran d'accueil, cliquez sur l'icône Paramètres . Ici, vous avez les options pour mettre à jour les préférences des utilisateurs, obtenir de l'aide et en savoir plus sur l'application.

Paramètres

Notification demi-feuille

Sur l'écran "Paramètres", vous pouvez choisir de désactiver les notifications de découverte proactive pouvant générer des commissions 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 les interruptions. Voir Supprimer la découverte ouvrant droit à commission notifications pour en savoir plus.

Utilitaires pour les développeurs

Sur 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:

  1. Cliquez sur Contenu des dépôts de journaux.

  2. Cliquez sur OK dans la boîte de dialogue, puis cochez Logcat.

Commentaires et aide

Pour nous envoyer vos idées ou commentaires sur la façon dont nous pourrions améliorer le développement votre expérience de Sample App for Matter, remplissez notre formulaire de commentaires.

Envoyer vos commentaires

Si vous rencontrez des problèmes avec Sample App for Matter, essayez de suivre la procédure de validation de 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 dans l'outil de suivi des problèmes du dépôt GitHub :

Pour obtenir des conseils officiels de Google sur des questions techniques, utilisez le forum des développeurs de la maison connectée :

Pour obtenir l'assistance technique de la communauté, utilisez la balise google-smart-home sur Stack Overflow: