Die Commissioning API unterstützt die Mehrfachverwaltung (Multi-Admin-Verwaltung) für Matter. Das bedeutet, dass die Commissioning API entweder als primärer oder sekundärer Matter-Beauftragter fungieren kann und dass Sie einen eigenen Beauftragten hinzufügen können:
Als primärer Matter-Beauftragter:
- In diesem Modus wird zuerst die Google-Fabric mithilfe der Google-UX hinzugefügt.
- Sie können einen benutzerdefinierten Auftraggeber hinzufügen.
- Ihr Kunde wird angerufen, nachdem Google Fabric dem Gerät hinzugefügt wurde. Anschließend wird das Matter-Fenster für die Inbetriebnahme wieder geöffnet.
- Wenn Google die Inbetriebnahme in seiner eigenen Fabric aus irgendeinem Grund nicht zuerst abschließen kann, wird Ihr benutzerdefinierter Inbetriebnahmedienst nicht ausgeführt.
Als sekundärer Matter-Beauftragter:
- In diesem Modus können Sie Ihre eigene UX für die Inbetriebnahme implementieren und in der eigenen Fabric (oder in anderen Fabrics) einbinden.
- Die Google Commissioning API kann später mit einem geöffneten Einrichtungsfenster aufgerufen werden, um Google Fabric hinzuzufügen. In diesem Modus empfiehlt Google dringend, dass Nutzer nach Abschluss des Einrichtungsvorgangs in der App aktiv aufgefordert werden, die Google-Fabric (mithilfe der Commissioning API) hinzuzufügen, wenn ein Endnutzer Ihnen die Berechtigung zur Verwendung der Home APIs erteilt hat.
Commissioning API als primären Matter-Komissionär verwenden
Diese Schritte zeigen den von Google bevorzugten Matter Vollfunktions-Inbetriebnahmevorgang:
Der Nutzer startet die Einrichtung in der App. Dazu tippt er beispielsweise auf die Schaltfläche Gerät hinzufügen.
Die Google-UX übernimmt die Kontrolle und zeigt den Bildschirm Scannen Sie den QR-Code Matter an. Der Nutzer kann den QR-Code scannen, um mit der Einrichtung zu beginnen.
Auf dem Bildschirm Dieses Gerät mit Ihrem Google-Konto verbinden tippt der Nutzer auf Ich stimme zu, um dem Google-System ein Gerät hinzuzufügen. Wenn der Nutzer stattdessen auf diesem Bildschirm auf Abbrechen tippt, wird die Geräteeinrichtung sofort beendet.
Auf dem Bildschirm Zuhause auswählen wählt der Nutzer das Zuhause aus, von dem aus er das Gerät steuern kann. Wenn kein Zuhause verfügbar ist, wird ein neues Zuhause erstellt. Wenn im Zuhause keine geeigneten Hubs gefunden werden oder dem Nutzer die erforderlichen Berechtigungen fehlen, wird die Einrichtung beendet.
Als Nächstes sollte der Bildschirm Gerät verbunden angezeigt werden und die Einrichtung von Matter beginnt. Auf diesem Bildschirm kann der Nutzer einen Raum und einen Gerätenamen auswählen.
Der Bildschirm Gerät wird vorbereitet wird angezeigt, während das Gerät in der Matter-Umgebung eingerichtet wird.
Ihre App übernimmt die Kontrolle und der benutzerdefinierte Auftragnehmer wird ausgeführt, sofern er registriert ist.
Commissioning API als sekundärer Matter-Koordinator verwenden
In diesen Schritten wird der Matter-Inbetriebnahmevorgang veranschaulicht, bei dem Ihre Inbetriebnahme vor der Inbetriebnahme durch Google erfolgt:
Der Nutzer startet die Einrichtung in Ihrer App. Er tippt beispielsweise auf Gerät hinzufügen.
Der UX-Prozess für die Inbetriebnahme wird ausgeführt, um Ihrer Fabric ein Gerät hinzuzufügen.
Anschließend können Sie das nachfolgende Verhalten festlegen, indem Sie es auf Ihrem Wissen über den Nutzer basieren lassen. Wenn der Nutzer beispielsweise die Google Home APIs aktiviert hat, was wahrscheinlich ein Hinweis darauf ist, dass er eine Inbetriebnahme durch Google wünscht, kannst du den Inbetriebnahmevorgang auslösen.
Ihr Prozess ruft die Commissioning API auf und stellt die Nutzlast bereit, die den Sicherheitscode, den Discriminator und andere verfügbare Informationen enthält.
Bei der Google-Inbetriebnahme wird das Gerät der Google-Fabric hinzugefügt.