L'API Commissioning su Android supporta la multi-amministrazione (o multi-admin) 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 commissario Matter principale:
- In questa modalità, l'infrastruttura Google viene aggiunta per prima, utilizzando l'esperienza utente di Google.
- Puoi aggiungere un commissario personalizzato.
- Il commissario viene chiamato dopo che l'infrastruttura Google è stata aggiunta al dispositivo, quindi la Matter finestra di messa in servizio viene riaperta.
- Se Google non riesce a completare la messa in servizio della propria infrastruttura per qualsiasi motivo, il servizio di messa in servizio personalizzato non verrà eseguito.
Come commissario Matter secondario:
- In questa modalità, puoi implementare la tua esperienza utente di messa in servizio ed eseguire l'onboarding sulla tua infrastruttura (o su altre infrastrutture).
- L'API Commissioning di Google può essere chiamata in un secondo momento con una finestra di messa in servizio aperta per aggiungere l'infrastruttura Google. In questa modalità, Google consiglia vivamente che, quando un utente finale ti ha concesso l'autorizzazione a utilizzare le API Home, l'app inviti attivamente gli utenti ad aggiungere l'infrastruttura di Google (utilizzando l'API Commissioning) al termine del flusso di messa in servizio.
Come utilizzare l'API Commissioning come commissario Matter principale
Questi passaggi mostrano il flusso di messa in servizio Matter completo di Matter preferito da Google:
L'utente avvia il flusso di messa in servizio nell'app. Ad esempio, l'utente tocca un pulsante con l'etichetta Aggiungi dispositivo.
L'esperienza utente di Google prende il controllo e visualizza la schermata Scansiona Matter codice QR, che consente 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 l'utente tocca invece Annulla in questa schermata, la messa in servizio di tutti i dispositivi termina immediatamente.
Nella schermata Scegli una casa, l'utente seleziona la casa da cui può controllare il dispositivo. Se non è disponibile alcuna casa, ne viene creata una nuova. Se nella casa non vengono trovati hub appropriati o se l'utente non dispone delle autorizzazioni, la procedura di messa in servizio termina.
Dovrebbe essere visualizzata la schermata Dispositivo connesso e inizia la procedura di configurazione Matter. L'utente può scegliere una stanza e un nome del dispositivo in questa schermata.
Viene visualizzata la schermata Preparazione del dispositivo in corso mentre il dispositivo viene sottoposto a onboarding nell'Matter infrastruttura.
L'app riprende il controllo e il commissario personalizzato, se registrato, viene eseguito ora.
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 viene eseguita 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.
Viene eseguita la procedura di esperienza utente di messa in servizio per aggiungere un dispositivo all'infrastruttura.
Una volta completata, puoi dettare il comportamento successivo in base alla tua conoscenza dell'utente. Ad esempio, se l'utente ha attivato le API Google Home, il che indica che probabilmente vuole eseguire la messa in servizio su Google, puoi attivare la procedura di messa in servizio.
La procedura 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 all'infrastruttura Google.