L'API Commissioning sur Android est compatible avec la multi-administration (ou multi-admin) pour Matter. Cela signifie qu'elle 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 fabric 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 du fabric Google est ajouté à l'appareil, puis la Matter fenêtre de mise en service est rouverte.
- Si Google ne peut pas effectuer la mise en service sur son propre fabric pour une raison quelconque, votre service de mise en service personnalisé ne s'exécute 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 le fabric Google. Dans ce mode, Google vous recommande vivement de demander activement aux utilisateurs d'ajouter le fabric Google (à l'aide de l'API Commissioning) une fois votre flux de mise en service terminé, lorsque l'utilisateur vous a autorisé à utiliser les API Home.
Utiliser l'API Commissioning en tant que commissaire Matter principal
Ces étapes décrivent le flux de mise en service complet et préféré de Google pour Matter :Matter
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, ce qui permet à l'utilisateur de scanner le code QR pour lancer le processus de configuration.Matter
Sur l'écran Associer cet appareil à votre compte Google, l'utilisateur appuie sur J'accepte pour ajouter un appareil à l'écosystème Google. S'il appuie sur Annuler sur cet écran, toute la mise en service de l'appareil 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 s'arrête.
L'écran Appareil connecté doit s'afficher ensuite, et le Matter processus de configuration commence. L'utilisateur peut choisir une pièce et un nom d'appareil sur cet écran.
L'écran Préparation de votre appareil s'affiche lorsque l'appareil est intégré au Matter fabric.
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 décrivent le Matter flux de mise en service dans lequel 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.
Votre processus d'expérience utilisateur de mise en service est exécuté pour ajouter un appareil à votre fabric.
Une fois cette opération terminée, vous pouvez dicter le comportement qui en résulte 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 Google ajoute l'appareil au fabric Google.