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à, viene aggiunto prima il tessuto Google, utilizzando l'esperienza utente di Google.
- Puoi aggiungere un commissario personalizzato.
- Il tuo commissario viene chiamato dopo che il tessuto Google è stato aggiunto al dispositivo, quindi la finestra di commissioning Matter viene riaperta.
- Se Google non riesce a completare il provisioning del proprio tessuto per primo per qualsiasi motivo, il 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 al tuo fabric (o ad altri fabric).
- L'API Google Commissioning può essere chiamata in un secondo momento con una finestra di commissioning aperta per aggiungere il tessuto 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 il tessuto di Google (utilizzando l'API Commissioning) dopo il completamento del flusso di commissioning.
Come utilizzare l'API Commissioning come commissario Matter principale
Questi passaggi mostrano il flusso di commissioning completo e ricco di funzionalità Matter preferito da Google:
L'utente avvia il flusso di provisioning nell'app. Ad esempio, l'utente tocca un pulsante con l'etichetta Aggiungi dispositivo.
L'esperienza utente di Google prende il controllo e mostra la schermata Scansiona codice QR Matter, consentendo all'utente di scansionare il codice QR per iniziare 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, il provisioning del dispositivo 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 non vengono trovati hub appropriati nella casa o se l'utente non dispone delle autorizzazioni, il processo di provisioning termina.
Dovrebbe essere visualizzata la schermata Dispositivo connesso e inizia la procedura di configurazione di Matter. In questa schermata, l'utente può scegliere un nome per la stanza e il dispositivo.
Durante l'onboarding del dispositivo nel tessuto Matter, viene visualizzata la schermata Preparazione del dispositivo in corso.
La tua 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 flusso di attivazione Matter in cui la procedura di attivazione avviene prima della procedura di attivazione di Google:
L'utente avvia il flusso di provisioning nella tua app. Ad esempio, l'utente tocca Aggiungi dispositivo.
Viene eseguito il processo UX di messa in servizio per aggiungere un dispositivo all'infrastruttura.
Una volta completata, puoi dettare il comportamento successivo basando il comportamento sulla tua conoscenza dell'utente. Ad esempio, se l'utente ha attivato le API Google Home, il che probabilmente indica che vuole commissionare a Google, puoi attivare la procedura di commissione.
Il tuo 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 all'infrastruttura Google.