L'API Commissioning su Android supporta l'amministrazione multipla (o multi-amministrazione) per Matter, il che significa che l'API Commissioning può fungere da commissario Matter principale o secondario e che puoi aggiungere il tuo commissario:
In qualità di commissario principale Matter:
- In questa modalità, Google Fabric viene aggiunto per primo, utilizzando Google UX.
- È possibile aggiungere un commissario personalizzato.
- Il tuo commissario viene chiamato dopo che il tessuto Google è stato aggiunto al dispositivo, quindi la finestra di commissioning viene riaperta.Matter
- Se Google non riesce a completare il provisioning del proprio tessuto per primo per qualsiasi motivo, il tuo servizio di provisioning personalizzato non verrà eseguito.
In qualità di commissario secondario Matter:
- In questa modalità, puoi implementare la tua UX di commissioning ed eseguire l'onboarding nel tuo fabric (o in altri fabric).
- L'API di messa in servizio di Google può essere richiamata in un secondo momento con una finestra di messa in servizio aperta per aggiungere Google Fabric. 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 il tessuto di Google (utilizzando l'API Commissioning) dopo il completamento del flusso di commissioning.
Come utilizzare l'API di Commissioning come commissario principale di Matter
Questi passaggi mostrano il flusso di commissioning completo e ricco di funzionalità Matter preferito da Google:
L'utente avvia il flusso di messa in servizio nell'app. Ad esempio, tocca il pulsante Aggiungi dispositivo.
Google UX prende il controllo e visualizza la schermata Scansiona codice QR Matter, consentendo all'utente di scansionare il codice QR per avviare il processo 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, la messa in servizio di tutti i dispositivi termina immediatamente.
Nella schermata Scegli una home, l'utente seleziona la home da cui può controllare il dispositivo. Se non è disponibile alcuna casa, ne viene creata una nuova. Se non vengono trovati hub appropriati in casa o se l'utente non ha le autorizzazioni necessarie, il processo di messa in servizio termina.
Dovrebbe apparire la schermata Dispositivo connesso e iniziare il processo di configurazione di Matter. In questa schermata l'utente può scegliere una stanza e un nome per il dispositivo.
Durante l'onboarding del dispositivo nel fabric Matter, viene visualizzata la schermata Preparazione del dispositivo in corso.
La tua app riprende il controllo e il commissario doganale, se registrato, viene eseguito ora.
Come utilizzare l'API Commissioning come commissario Matter secondario
Questi passaggi mostrano il flusso di messa in servizio di Matter, in cui il processo di messa in servizio avviene prima del processo di messa in servizio di Google:
L'utente avvia il flusso di provisioning nella tua app. Ad esempio, l'utente tocca Aggiungi dispositivo.
Il processo di messa in servizio UX viene eseguito per aggiungere un dispositivo al fabric.
Una volta completato, 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 eseguire il commissioning su Google, puoi attivare la procedura di commissioning.
Il processo richiama l'API di messa in servizio e fornisce il payload, che contiene il codice di accesso, il discriminatore e altre informazioni disponibili.
Il processo di messa in servizio di Google aggiunge il dispositivo al Google Fabric.