Le flux de mise en service dans votre application à l'aide de l'API Commissioning peut être lancé de deux manières : directement dans votre application ou via un sélecteur d'applications dans le processus Fast Pair. Cette section décrit l'expérience utilisateur pour chacun d'eux.
Initié par l'application
Dans ce scénario, l'utilisateur commence la mise en service dans votre application, généralement à partir d'un bouton d'incitation à l'action (CTA) "Ajouter un appareil". Nous vous recommandons d'afficher le bouton Ajouter un appareil comme suit :
- Où les utilisateurs voient tous leurs appareils, comme sur une page Contrôles
- Où les utilisateurs peuvent gérer la maison, comme sur une page Paramètres
- La page Accueil de votre application
Une fois la mise en service terminée, nous vous recommandons de rediriger l'utilisateur vers la page d'accueil de l'application ou vers un emplacement de l'application qui lui montre le contrôleur d'appareil qu'il vient de configurer ou une liste complète de tous les appareils, y compris celui qui vient d'être configuré.
L'UX est illustrée dans la figure 2 :
L'utilisateur de l'application clique sur Ajouter un appareil.
L'utilisateur scanne le code QR ou saisit le code d'association.
L'utilisateur est invité à accepter d'ajouter l'appareil à la structure Google (cela correspond à "Consentement + Métadonnées" dans la figure 1) et à sélectionner le compte Google à utiliser.
Si l'utilisateur possède plusieurs maisons, il est invité à en sélectionner une. S'il n'a pas configuré de maison, une maison nommée "Maison" est créée automatiquement.
L'API Commissioning se connecte à l'appareil.
L'utilisateur est invité à sélectionner la pièce où se trouve l'appareil.
L'utilisateur est invité à renommer l'appareil.
L'API Commissioning génère des identifiants Matter, vérifie la connectivité réseau, puis exécute le processus de mise en service, en connectant l'appareil au tissu choisi.
Si l'autorisation d'accéder à la structure et aux appareils de l'utilisateur a déjà été accordée, l'appareil devrait apparaître dans la maison avec les autres appareils de cette maison, et il pourra être contrôlé à l'aide de l'application.
Si l'autorisation d'accéder à la structure et aux appareils de l'utilisateur n'a pas encore été accordée, l'appareil ne devrait pas encore être visible ni contrôlable dans l'application. Une autorisation est requise pour accéder à l'appareil et le contrôler dans une application.
Émis par l'Association express
La mise en service peut également être lancée à l'aide de l'Association express dans Android. Après avoir scanné le code QR Matter de l'appareil, l'utilisateur est invité à sélectionner une application pour poursuivre le processus de mise en service. La sélection de votre application utilise l'API Commissioning de l'application, comme illustré à la figure 3.
Si l'utilisateur n'a pas installé l'application sur son appareil mobile, il est invité à le faire avant de continuer. L'UX à partir de l'écran de consentement est la même que celle de la figure 2.
L'utilisateur est invité à scanner un code QR.
L'utilisateur scanne le code QR Matter de l'appareil.
L'utilisateur est invité à sélectionner une application pour poursuivre le processus de mise en service.
Si l'application n'est pas encore installée, l'utilisateur est invité à l'installer.
L'application est téléchargée depuis le Google Play Store.
L'application est installée.
Une fois l'application installée, l'utilisateur est invité à continuer.
L'utilisateur est invité à accepter d'ajouter l'appareil à la structure Google (cela correspond à "Consentement + Métadonnées" dans la figure 1) et à sélectionner le compte Google à utiliser.
Si l'utilisateur possède plusieurs maisons, il est invité à en sélectionner une. S'il n'a pas configuré de maison, une maison nommée "Maison" est créée automatiquement.
L'API Commissioning se connecte à l'appareil.
L'utilisateur est invité à sélectionner la pièce où se trouve l'appareil.
L'utilisateur est invité à renommer l'appareil.
L'API Commissioning génère des identifiants Matter, vérifie la connectivité réseau, puis exécute le processus de mise en service, en connectant l'appareil au tissu choisi.
Si l'autorisation d'accéder à la structure et aux appareils de l'utilisateur a déjà été accordée, l'appareil devrait apparaître dans la maison avec les autres appareils de cette maison, et il devrait pouvoir être contrôlé à l'aide de l'application.
Si l'autorisation d'accéder à la structure et aux appareils de l'utilisateur n'a pas encore été accordée, l'appareil ne devrait pas encore être visible ni contrôlable dans l'application. Une autorisation est requise pour accéder à l'appareil et le contrôler dans une application.
Sélecteur d'applications
Votre application peut apparaître de deux manières dans le sélecteur d'applications lors du processus de mise en service :
- Sur l'écran Choisir une application.
- Si les utilisateurs sélectionnent Choisir une autre application, l'application s'affiche sur l'écran Autres applications installées.
Applications suggérées
Le sélecteur d'applications affiche deux applications suggérées.
- La première est toujours Google Home app (GHA).
- La seconde concerne l'application préférée du fabricant de l'appareil, si elle est définie dans un projet Google Home Developer Console associé au VID ou au PID de l'appareil. (Cette option ne s'applique pas aux développeurs d'applications qui ne conçoivent pas d'appareils Matter.)
Il existe deux scénarios dans lesquels les applications s'affichent sur l'écran Choisir une application.
- Installée : Google Play services vérifiez que l'application est compatible avec le filtre d'intent
ACTION_COMMISSION_DEVICE. Si le filtre d'intent est manquant, l'utilisateur est redirigé vers le Play Store pour mettre à jour l'application. - Non installé : l'utilisateur est redirigé vers le Play Store pour installer l'application avant de continuer.