L'API Commissioning sur Android est compatible avec la multi-administration (ou multi-administrateur) 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 principal Matter :
- 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 Google Fabric à l'appareil, puis la fenêtre de mise en service Matter est rouverte.
- Si Google ne peut pas effectuer la mise en service sur son propre réseau en premier pour quelque raison que ce soit, votre service de mise en service personnalisé ne fonctionnera pas.
En tant que commissaire Matter secondaire :
- Dans ce mode, vous pouvez implémenter votre propre UX 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 d'association ouverte pour ajouter le réseau Google. Dans ce mode, Google recommande vivement que, lorsqu'un utilisateur final vous a accordé l'autorisation d'utiliser les API Home, l'application invite activement les utilisateurs à ajouter le fabric de Google (à l'aide de l'API Commissioning) une fois votre flux de mise en service terminé.
Utiliser l'API Commissioning comme principal outil de mise en service Matter
Les étapes suivantes présentent le flux 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'UX Google prend le contrôle et affiche l'écran Scanner le code QR Matter, ce qui permet à l'utilisateur de scanner le code QR 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 configuration de l'appareil prend immédiatement fin.
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 requises, le processus de configuration se termine.
L'écran Appareil connecté devrait s'afficher ensuite, et la procédure de configuration Matter commence. Sur cet écran, l'utilisateur peut choisir le nom d'une pièce et d'un appareil.
L'écran Préparation de l'appareil s'affiche lorsque l'appareil est intégré à la structure Matter.
Votre application reprend le contrôle et le commissaire personnalisé, s'il est enregistré, s'exécute maintenant.
Utiliser l'API Commissioning comme commissaire Matter secondaire
Les étapes suivantes décrivent le flux de mise en service Matter où votre processus de mise en service a lieu avant le processus de mise en service Google :
L'utilisateur lance le flux de mise en service dans votre application. Par exemple, il appuie sur Ajouter un appareil.
Le processus d'expérience utilisateur de mise en service est exécuté pour ajouter un appareil à votre réseau.
Une fois cette étape terminée, vous pouvez dicter le comportement qui en découle 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 mettre en service l'appareil 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 Google ajoute l'appareil au fabric Google.