L'API de mise en service est compatible avec la multi-administration (ou multi-administration) pour Matter, ce qui signifie que l'API de mise en service peut servir de commissionnaire Matter principal ou secondaire, et que vous pouvez ajouter votre propre commissionnaire:
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é une fois que le tissu Google est ajouté à l'appareil, puis la fenêtre de mise en service Matter est rouverte.
- Si Google ne peut pas terminer la mise en service sur son propre fabric en premier pour une raison quelconque, votre service de mise en service personnalisée ne s'exécutera pas.
En tant que commissaire Matter secondaire:
- Dans ce mode, vous pouvez implémenter votre propre expérience 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 le tissu Google. Dans ce mode, Google recommande vivement qu'une fois qu'un utilisateur final vous a autorisé à utiliser les API Home, l'application invite activement les utilisateurs à ajouter le fabric de Google (à l'aide de l'API de mise en service) une fois le flux de mise en service terminé.
Utiliser l'API de mise en service en tant que commissionnaire Matter principal
Ces étapes 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'expérience utilisateur Google prend le contrôle et affiche l'écran Scanner le code QR Matter, qui permet à l'utilisateur de scanner le code QR pour commencer 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 l'appareil se termine 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 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 Device connected (Appareil connecté) devrait s'afficher, et le processus de configuration de Matter commence. L'utilisateur peut choisir une salle et un nom d'appareil sur cet écran.
L'écran Préparation de l'appareil s'affiche lorsque l'appareil est intégré au fabric Matter.
Votre application reprend le contrôle, et le commissaire personnalisé, s'il est enregistré, s'exécute maintenant.
Utiliser l'API de mise en service en tant que commissaire Matter secondaire
Ces étapes montrent le flux de mise en service de Matter, où votre processus de mise en service a lieu 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'expérience utilisateur de mise en service est exécuté pour ajouter un appareil à votre fabric.
Une fois cette étape terminée, vous pouvez dicter le comportement qui en découle en vous basant sur vos connaissances sur l'utilisateur. Par exemple, si l'utilisateur a activé les API Google Home, ce qui indique probablement qu'il souhaite passer une commande à Google, vous pouvez déclencher le processus de commande.
Votre processus appelle l'API de mise en service et fournit la charge utile, qui contient le code d'accès, le discriminateur et d'autres informations disponibles.
Le processus de mise en service Google ajoute l'appareil au réseau Google Fabric.