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-Kommissionierer fungieren kann und dass Sie Ihren eigenen Kommissionierer hinzufügen können:
Als primärer Matter-Beauftragter:
- In diesem Modus wird zuerst die Google-Stoffvorlage mit der Google-Benutzeroberfläche hinzugefügt.
- Sie können einen benutzerdefinierten Commissioner hinzufügen.
- Ihr Beauftragter wird aufgerufen, nachdem das Google-Framework dem Gerät hinzugefügt wurde. Anschließend wird das Matter-Fenster für die Inbetriebnahme wieder geöffnet.
- Wenn Google die Inbetriebnahme in seinem eigenen Fabric aus irgendeinem Grund nicht abschließen kann, wird Ihr benutzerdefinierter Inbetriebnahmedienst nicht ausgeführt.
Als Matter-Beauftragter:
- In diesem Modus können Sie Ihre eigene UX für die Inbetriebnahme implementieren und Geräte in Ihr eigenes Fabric oder andere Fabrics einbinden.
- Die Google Commissioning API kann später mit einem offenen Inbetriebnahmefenster aufgerufen werden, um die Google-Struktur hinzuzufügen. In diesem Modus empfiehlt Google dringend, dass die App Nutzer aktiv auffordert, das Google-Framework (über die Commissioning API) hinzuzufügen, nachdem der Inbetriebnahmefluss abgeschlossen ist, wenn ein Endnutzer Ihnen die Berechtigung zur Verwendung der Home APIs erteilt hat.
Commissioning API als primären Matter-Commissioner verwenden
In diesen Schritten wird der von Google bevorzugte Matter-Inbetriebnahmefluss mit allen Funktionen beschrieben:
Der Nutzer startet den Inbetriebnahmeprozess in der App. Er tippt beispielsweise auf die Schaltfläche Gerät hinzufügen.
Die Google-Benutzeroberfläche wird angezeigt und der Bildschirm Matter-QR-Code scannen wird eingeblendet. Der Nutzer kann den QR-Code scannen, um die Einrichtung zu starten.
Auf dem Bildschirm Dieses Gerät mit Ihrem Google-Konto verbinden tippt der Nutzer auf Ich stimme zu, um dem Google-Ökosystem ein Gerät hinzuzufügen. Tippt der Nutzer stattdessen auf diesem Bildschirm auf Abbrechen, wird die 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 erstellt. Wenn keine geeigneten Hubs im Zuhause gefunden werden oder der Nutzer keine Berechtigungen hat, wird die Einrichtung beendet.
Als Nächstes sollte der Bildschirm Gerät verbunden angezeigt werden und die Matter-Einrichtung 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 die Matter-Plattform eingebunden wird.
Ihre App übernimmt wieder die Steuerung und der benutzerdefinierte Commissioner wird ausgeführt, sofern er registriert ist.
Commissioning API als sekundärer Matter-Commissioner verwenden
In diesen Schritten wird der Matter-Inbetriebnahmefluss gezeigt, bei dem Ihr Inbetriebnahmeprozess vor dem Inbetriebnahmeprozess von Google stattfindet:
Der Nutzer startet den Inbetriebnahmeprozess in Ihrer App, indem er beispielsweise auf Gerät hinzufügen tippt.
Der Prozess für die Inbetriebnahme-Benutzeroberfläche wird ausgeführt, um Ihrem Fabric ein Gerät hinzuzufügen.
Anschließend können Sie das weitere Verhalten festlegen, indem Sie es auf Ihr Wissen über den Nutzer stützen. Wenn der Nutzer beispielsweise die Google Home APIs aktiviert hat, was wahrscheinlich darauf hindeutet, dass er die Inbetriebnahme über Google durchführen möchte, können Sie den Inbetriebnahmevorgang auslösen.
In Ihrem Prozess wird die Commissioning API aufgerufen und die Nutzlast bereitgestellt, die den Sicherheitscode, den Diskriminator und andere verfügbare Informationen enthält.
Beim Google-Inbetriebnahmeprozess wird das Gerät dem Google-Fabric hinzugefügt.