Die Commissioning API unter Android unterstützt die Multi-Administration (oder Multi-Admin) für Matter. Das bedeutet, dass die Commissioning API entweder als primärer oder sekundärer Matter Commissioner dienen kann und dass Sie Ihren eigenen Commissioner hinzufügen können:
Als primärer Matter Commissioner:
- In diesem Modus wird das Google-Fabric zuerst über die Google-Benutzeroberfläche hinzugefügt.
- Sie können einen benutzerdefinierten Commissioner hinzufügen.
- Ihr Commissioner wird aufgerufen, nachdem das Google-Fabric dem Gerät hinzugefügt wurde. Anschließend wird das Matter Commissioning-Fenster wieder geöffnet.
- Wenn Google die Inbetriebnahme für das eigene Fabric aus irgendeinem Grund nicht zuerst abschließen kann, wird Ihr benutzerdefinierter Inbetriebnahmedienst nicht ausgeführt.
Als sekundärer Matter Commissioner:
- In diesem Modus können Sie Ihre eigene Inbetriebnahmemethode implementieren und Geräte in Ihrem eigenen Fabric (oder in anderen Fabrics) einbinden.
- Die Google Commissioning API kann später mit einem offenen Inbetriebnahmefenster aufgerufen werden, um das Google-Fabric hinzuzufügen. In diesem Modus empfiehlt Google dringend, dass die App Nutzer aktiv auffordert, das Google-Fabric (über die Commissioning API) hinzuzufügen, nachdem Ihr Inbetriebnahmeprozess abgeschlossen ist, wenn ein Endnutzer Ihnen die Berechtigung zur Verwendung der Home APIs erteilt hat.
Commissioning API als primärer Matter-Commissioner verwenden
In diesen Schritten wird der von Google bevorzugte Matter vollständige Matter-Inbetriebnahmeprozess beschrieben:
Der Nutzer startet den Inbetriebnahmeprozess in der App. Dazu tippt er beispielsweise auf eine Schaltfläche mit der Bezeichnung Gerät hinzufügen.
Die Google-Benutzeroberfläche übernimmt die Steuerung und zeigt den QR-Code scannen-Bildschirm an. Der Nutzer kann den QR-Code scannen, um den Einrichtungsprozess zu starten.Matter
Auf dem Bildschirm Dieses Gerät mit Ihrem Google-Konto verbinden tippt der Nutzer auf Ich stimme zu, um ein Gerät dem Google-Ökosystem hinzuzufügen. Wenn der Nutzer stattdessen auf diesem Bildschirm auf Abbrechen tippt, wird die gesamte Geräteinbetriebnahme sofort beendet.
Auf dem Bildschirm Zuhause auswählen wählt der Nutzer das Zuhause aus, über das 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 der Nutzer keine Berechtigungen hat, wird der Inbetriebnahmeprozess beendet.
Als Nächstes sollte der Bildschirm Gerät verbunden angezeigt werden und der Matter Einrichtung sprozess beginnt. Der Nutzer kann auf diesem Bildschirm einen Raum und einen Gerätenamen auswählen.
Der Bildschirm Gerät wird eingerichtet wird angezeigt, während das Gerät in das Matter Fabric eingebunden wird.
Ihre App übernimmt wieder die Steuerung und der benutzerdefinierte Commissioner wird jetzt ausgeführt, sofern er registriert ist.
Commissioning API als sekundärer Matter-Commissioner verwenden
In diesen Schritten wird der Matter Inbetriebnahmeprozess beschrieben, bei dem Ihr Inbetriebnahmeprozess vor dem Google-Inbetriebnahmeprozess stattfindet:
Der Nutzer startet den Inbetriebnahmeprozess in Ihrer App. Dazu tippt er beispielsweise auf Gerät hinzufügen.
Ihr Inbetriebnahmeprozess wird ausgeführt, um ein Gerät Ihrem Fabric hinzuzufügen.
Nach Abschluss können Sie das weitere Verhalten festlegen, indem Sie es auf Ihren Kenntnissen des Nutzers basieren. Wenn der Nutzer beispielsweise die Google Home APIs aktiviert hat, was wahrscheinlich darauf hindeutet, dass er die Inbetriebnahme für Google durchführen möchte, können Sie den Inbetriebnahmeprozess auslösen.
Ihr Prozess ruft die Commissioning API auf und stellt die Nutzlast bereit, die den Passcode, den Diskriminator und andere verfügbare Informationen enthält.
Der Google-Inbetriebnahmeprozess fügt das Gerät dem Google-Fabric hinzu.