L'API Commissioning supporta la multi-amministrazione (o multi-amministratore) per Matter, il che significa che l'API Commissioning può fungere da commissario Matter principale o secondario e che puoi aggiungere il tuo commissario:
Come Matter principale:
- In questa modalità, viene aggiunto prima il fabric di Google, utilizzando l'esperienza utente di Google.
- Puoi aggiungere un commissario personalizzato.
- Il tuo amministratore viene chiamato dopo che il componente Google è stato aggiunto al dispositivo, quindi la finestra di Mattercommissioning viene riaperta.
- Se per qualsiasi motivo Google non riesce a completare prima la messa in servizio nel proprio cloud, il servizio di messa in servizio personalizzata non verrà eseguito.
In qualità di commissario Matter secondario:
- In questa modalità, puoi implementare la tua UX di messa in servizio e eseguire l'onboarding nel tuo proprio fabric (o in altri fabric).
- L'API Google Commissioning può essere chiamata in un secondo momento con una finestra di messa in servizio aperta per aggiungere la struttura di Google. In questa modalità, Google consiglia vivamente che, quando un utente finale ti ha concesso l'autorizzazione a utilizzare le API Home, l'app chieda attivamente agli utenti di aggiungere la piattaforma di Google (utilizzando l'API Commissioning) al termine del flusso di messa in servizio.
Come utilizzare l'API Commissioning come commissioning manager principale
Questi passaggi mostrano il flusso di messa in servizio Matter preferito da Google, completo di funzionalità:
L'utente avvia il flusso di messa in servizio nell'app. Ad esempio, l'utente tocca un pulsante denominato Aggiungi dispositivo.
L'esperienza utente di Google prende il controllo e mostra la schermata Scansiona Mattercodice QR, consentendo all'utente di scansionare il codice QR per avviare la procedura di configurazione.
Nella schermata Collega questo dispositivo al tuo Account Google, l'utente tocca Accetto per aggiungere un dispositivo all'ecosistema Google. Se invece l'utente tocca Annulla in questa schermata, tutta la messa in servizio del dispositivo termina immediatamente.
Nella schermata Scegli una casa, l'utente seleziona la casa da cui può controllare il dispositivo. Se non è disponibile nessuna casa, ne viene creata una nuova. Se in casa non vengono trovati hub appropriati o se l'utente non dispone delle autorizzazioni, la procedura di messa in servizio termina.
Dovresti visualizzare la schermata Dispositivo connesso e iniziare la procedura di configurazioneMatter. In questa schermata l'utente può scegliere una stanza e il nome del dispositivo.
La schermata Preparazione del dispositivo viene visualizzata durante l'inizializzazione del dispositivo nel Matter.
L'app riprende il controllo e il commissario personalizzato, se registrato, viene eseguito.
Come utilizzare l'API Commissioning come commissario Matter secondario
Questi passaggi mostrano il Matter flusso di messa in servizio in cui la procedura di messa in servizio avviene prima della procedura di messa in servizio di Google:
L'utente avvia il flusso di messa in servizio nella tua app. Ad esempio, l'utente tocca Aggiungi dispositivo.
La procedura UX di messa in servizio viene eseguita per aggiungere un dispositivo al tuo iperstruttura.
Una volta completata, puoi dettare il comportamento successivo basandolo sulla tua conoscenza dell'utente. Ad esempio, se l'utente ha attivato le API Google Home, il che probabilmente indica che vuole effettuare la messa in servizio per Google, puoi attivare la procedura di messa in servizio.
Il processo chiama l'API Commissioning e fornisce il payload, che contiene il passcode, il discriminatore e altre informazioni disponibili.
La procedura di messa in servizio di Google aggiunge il dispositivo alla struttura di Google.