L'API Commissioning sur Android est compatible avec l'administration multiple (ou multi-admin) pour Matter. Cela signifie que l'API Commissioning peut servir de commissaire Matter principal ou secondaire, et que vous pouvez ajouter votre propre commissaire :
En tant que commissaire Matter principal :
- Dans ce mode, le tissu Google est ajouté en premier, à l'aide de l'expérience utilisateur Google.
- Vous pouvez ajouter un commissaire personnalisé.
- Votre commissaire est appelé après l'ajout de la structure Google à l'appareil, puis la fenêtre de mise en service Matter est rouverte.
- Si, pour une raison quelconque, Google ne peut pas effectuer la mise en service sur son propre fabric en premier, votre service de mise en service personnalisé ne s'exécutera pas.
En tant que commissaire Matter secondaire :
- Dans ce mode, vous pouvez implémenter votre propre expérience utilisateur de mise en service et intégrer votre propre fabric (ou d'autres fabrics).
- L'API Google Commissioning peut être appelée ultérieurement avec une fenêtre de mise en service ouverte pour ajouter la structure Google. Dans ce mode, Google recommande vivement que, lorsqu'un utilisateur final vous a autorisé à utiliser les API Home, l'application invite activement les utilisateurs à ajouter la structure de Google (à l'aide de l'API Commissioning) une fois votre flux de mise en service terminé.
Utiliser l'API Commissioning en tant que commissaire Matter principal
Ces étapes illustrent le processus de mise en service complet Matter recommandé par Google :
L'utilisateur lance le flux de mise en service dans l'application. Par exemple, il appuie sur un bouton intitulé Ajouter un appareil.
L'expérience utilisateur Google prend le contrôle et affiche l'écran Scanner le QR code Matter, ce qui permet à l'utilisateur de scanner le QR code pour lancer le processus de configuration.
Sur l'écran Connecter cet appareil à votre compte Google, l'utilisateur appuie sur J'accepte pour ajouter un appareil à l'écosystème Google. Si l'utilisateur appuie sur Annuler sur cet écran, la mise en service de tous les appareils s'arrête immédiatement.
Sur l'écran Choisir une maison, l'utilisateur sélectionne la maison à partir de laquelle il peut contrôler l'appareil. Si aucune maison n'est disponible, une nouvelle maison est créée. Si aucun hub approprié n'est trouvé dans la maison ou si l'utilisateur ne dispose pas des autorisations nécessaires, le processus de mise en service se termine.
L'écran Appareil connecté devrait s'afficher, et le processus de configuration de Matter commence. L'utilisateur peut choisir un nom de pièce et d'appareil sur cet écran.
L'écran Préparation de l'appareil s'affiche pendant l'intégration de l'appareil au réseau Matter.
Votre application reprend le contrôle et le commissaire personnalisé, s'il est enregistré, s'exécute maintenant.
Utiliser l'API Commissioning en tant que commissaire Matter secondaire
Ces étapes illustrent le flux de mise en service Matter, où votre processus de mise en service se produit avant le processus de mise en service de Google :
L'utilisateur lance le flux de mise en service dans votre application. Par exemple, il appuie sur Ajouter un appareil.
Votre processus d'UX de mise en service est exécuté pour ajouter un appareil à votre fabric.
Une fois l'opération terminée, vous pouvez dicter le comportement qui s'ensuit en vous basant sur votre connaissance de l'utilisateur. Par exemple, si l'utilisateur a activé les API Google Home, ce qui indique probablement qu'il souhaite effectuer la mise en service sur Google, vous pouvez déclencher le processus de mise en service.
Votre processus appelle l'API Commissioning et fournit la charge utile, qui contient le code secret, le discriminateur et d'autres informations disponibles.
Le processus de mise en service de Google ajoute l'appareil à la structure Google.