Appli Google Home pour Matter

Exemple d'application 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). Cet exemple d'application offre les fonctionnalités suivantes:

  • Mettre en service des appareils Matter physiques et virtuels sur la plate-forme Android locale
  • Mettre en service des appareils physiques et virtuels dans une data fabric de développement
  • Contrôlez les appareils de votre plate-forme 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 dans la structure 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, apprendre à 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 Sample App for Matter

Prérequis

Vous n'avez pas besoin d'un hub (Google Nest Hub (2nd gen), par exemple) pour mettre en service et contrôler des appareils avec le Sample App for Matter.

Installer

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

  2. Installez Android Debug Bridge (adb):

    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 Don't show this message again (Ne plus afficher ce message), vous pouvez afficher la boîte de dialogue à tout moment en mettant à jour vos préférences dans la section "Admin" de l'application.

Au cours des étapes suivantes, vous allez ajouter un appareil Matter à la structure Android locale, ainsi qu'une plate-forme de développement locale uniquement dans l'application exemple.

Que sont les tissus Matter ?

Exemple d'application Google Home pour Matter

Une structure 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 tissus correspondant à une plate-forme, une application ou un groupe d'appareils qui interagissent les uns avec les autres. Les tissus ont un identifiant unique, et les appareils partagent le même ensemble d'identifiants et la même autorité de certification (CA). Ces identifiants sont attribués lors de la mise en service du Matter.

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é à partir d'un appel à Mobile SDK. Pour fournir une preuve de propriété, Scannez le code QR ou appuyez sur Utiliser un code d'association.

    Scanner un code QR

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

Votre appareil est maintenant connecté à la fois à la plate-forme Android locale et à la plate-forme de développement.

L'ensemble des tâches de mise en service et des é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 évite d'avoir à gérer des autorisations sensibles, telles que 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.

Vous pouvez activer ou désactiver votre appareil depuis l'écran d'accueil. Appuyez dessus pour accéder à ses informations.

Appareil ajouté

Partager les appareils

Le partage d'un appareil est appelé flux multi-administrateur dans la spécification Matter. Une fois qu'un appareil est 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 Versions du dépôt GitHub Sample App for Matter. Pour la version la plus récente, recherchez l'APK nommé GHSAFM-version-targetcommissioner-debug.apk dans la section "Assets" (Éléments). Ne sélectionnez pas default.

  2. Installez le préparateur 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'appareil

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, vous permettant de choisir l'application ou la plate-forme à laquelle vous souhaitez associer l'appareil. Cet écran vous propose deux façons de partager l'appareil:

  1. Manuellement, via un code de configuration à partager avec l'application du commissaire cible
  2. Avec une application Android locale enregistrée en tant que commissaire Matter

L'application du commissaire cible porte le nom 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 sa propre infrastructure.

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.

Paramètres

Notification de demi-feuille

Sur l'écran "Paramètres", vous pouvez choisir de désactiver les notifications proactives de découverte ouvrant droit à commission pour Matter appareils.

Si votre application fournit son propre flux de découverte ou de mise en service Matter, vous pouvez souhaiter supprimer ces notifications pour éviter toute interruption. Pour en savoir plus, consultez Supprimer les notifications de découverte ouvrant droit à commission.

Utilitaires pour les développeurs

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 de préférences utilisateur et d'appareil 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 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.

Envoyez-nous vos commentaires

Si vous rencontrez des problèmes avec Sample App for Matter, suivez les étapes ci-dessous 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 à l'outil Issue Tracker du dépôt GitHub:

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

Pour bénéficier de l'assistance technique de la communauté, utilisez le tag google-smart-home sur Stack Overflow: