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 d'association express. Cette section décrit l'expérience utilisateur (UX) pour chacun d'eux.
Initié par l'application
Dans ce scénario, l'utilisateur lance la mise en service dans votre application, généralement à partir d'un incitation à l'action (CTA) "Ajouter un appareil". Nous vous recommandons de présenter le bouton Ajouter un appareil comme suit :
- Où les utilisateurs voient tous leurs appareils, comme une page Commandes
- Où les utilisateurs peuvent gérer la maison, comme 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 affiche le contrôleur de l'appareil qu'il vient de configurer ou une liste complète de tous les appareils, y compris celui qui vient d'être configuré.
L'expérience utilisateur est illustrée dans la figure 2 :
L'utilisateur de l'application clique sur Ajouter un appareil.
L'utilisateur scanne le QR code ou saisit le code d'association.
L'utilisateur est invité à accepter d'ajouter l'appareil à la structure Google (ce qui 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. Si l'utilisateur n'a pas configuré de maison, une maison nommée "Maison" est automatiquement créée.
L'API Commissioning se connecte à l'appareil.
L'utilisateur est invité à sélectionner la pièce dans laquelle 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 doit apparaître dans la maison avec les autres appareils de cette maison, et peut ê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 doit 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 sur 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é dans 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'expérience utilisateur à partir de l'écran de consentement est la même que celle de la figure 2.
L'utilisateur est invité à scanner un QR code.
L'utilisateur scanne le QR code 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 déjà 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 (ce qui 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. Si l'utilisateur n'a pas configuré de maison, une maison nommée "Maison" est automatiquement créée.
L'API Commissioning se connecte à l'appareil.
L'utilisateur est invité à sélectionner la pièce dans laquelle 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 doit apparaître dans l'application Home avec les autres appareils de cette maison, et peut ê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 doit 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'appli
Votre application peut s'afficher 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.
- Le premier 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 créent pas d'appareils Matter.)
Deux scénarios sont possibles lorsque les applications se trouvent sur l'écran Sélectionner une application.
- Installée : Google Play services vérifie 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ée : l'utilisateur est redirigé vers le Play Store pour installer l'application avant de continuer.