Esempio di app Google Home per la pratica

Il Google Home Sample App for Matter utilizza Google Home Mobile SDK per creare un'app per Android simile a Google Home app (GHA). Questa app di esempio fornisce le seguenti funzionalità:

• Metti in servizio i dispositivi Matter fisici e virtuali Matter nel fabric Android locale
• Metti in servizio i dispositivi fisici e virtuali in un fabric di sviluppo
• Controlla i dispositivi nel fabric di sviluppo, ad esempio accendi una luce
• Le funzionalità multi-amministratore ti consentono di condividere i dispositivi nel fabric di sviluppo con altre app e, viceversa, di includere nel fabric di sviluppo i dispositivi condivisi da altre app
• Utilità per sviluppatori

Questa guida descrive come installare l'APK Sample App for Matter e come utilizzarlo per mettere in servizio, controllare e condividere i dispositivi Matter.

Per scaricare il codice sorgente, scoprire come integrare il Mobile SDK e personalizzare le schermate in Android Studio, prova il nostro Sample App for Matter codelab.

Vai al Sample App for Matter codelab

Prerequisiti

• Un dispositivo Android O (8.1, livello API 27) o versioni successive disponibile per i test. Per assicurarti che il tuo dispositivo supporti la versione più recente di Matter supporto, consulta la guida Verificare i Matter moduli e i servizi.
• Crea un dispositivo Matter con funzionalità On/Off. Questa app di esempio funziona con un dispositivo virtuale e un ESP32.
  • Dispositivo virtuale Matter (MVD). Per ridurre al minimo i problemi ambientali, ti consigliamo vivamente di iniziare a utilizzare MVD. Se riscontri problemi, sarà molto più facile esaminarli se l'app di esempio viene utilizzata con MVD.
  • Crea un Matter dispositivo virtuale con l'app rootnode_dimmablelight_bCwGYSDpoe. Quando crei un'Matter integrazione nella Google Home Developer Console, utilizza 0xFFF1 come ID fornitore e 0x8000 come ID prodotto.
  • Crea un dispositivo Espressif con all-clusters-app. Quando crei un'integrazione Matternella Developer Console, utilizza 0xFFF1 come ID fornitore e 0x8001 come ID prodotto.

Non hai bisogno di un hub, ad esempio un Google Nest Hub (2nd gen), per mettere in servizio e controllare i dispositivi con l'Sample App for Matter.

Installazione

1. Vai alla sezione Releases nel Sample App for Matter repository GitHub. Per la release più recente, individua nella sezione Assets l'APK denominato GHSAFM-version-default-debug.apk. Non selezionare targetcommissioner.

2. Installa Android Debug Bridge (adb):

   Installa adb

3. Collega il dispositivo Android con USB e attiva Trasferimento file, quindi installa l'APK:

   $ adb unroot && adb install GHSAFM-version-default-debug.apk
   

Mettere in servizio i dispositivi

Quando avvii l'app di esempio per la prima volta, viene visualizzata una finestra di dialogo con un link al Sample App for Matter codelab. Se selezioni Non mostrare più questo messaggio, puoi ripristinare la finestra di dialogo in qualsiasi momento aggiornando le preferenze nella sezione Amministrazione dell'app.

Nei passaggi successivi, aggiungerai un dispositivo Matter al fabric Android locale, insieme a un fabric di sviluppo locale solo per l'app di esempio.

Che cosa sono i fabric Matter?

Un fabric Matter è un dominio di fiducia condiviso tra i dispositivi di una rete domestica che consente loro di comunicare tra loro.

I dispositivi possono avere uno o più fabric che corrispondono a una piattaforma, un'app o un gruppo di dispositivi che interagiscono tra loro. I fabric hanno un ID univoco e i dispositivi condividono lo stesso insieme di credenziali e autorità di certificazione (CA). Queste credenziali vengono assegnate durante Matter la messa in servizio.

Per mettere in servizio un dispositivo Matter:

1. Tocca il pulsante add Aggiungi dispositivo per avviare la procedura di messa in servizio.

   

2. Il controllo viene quindi trasferito a Google Play services, che viene avviato da una chiamata a Mobile SDK. Per stabilire la prova di proprietà, Scansiona il codice QR o tocca Utilizza il codice di accoppiamento.

   

3. Al termine della messa in servizio, inserisci un nome dispositivo, quindi tocca Fine.

Il dispositivo è ora connesso sia al fabric Android locale sia al fabric di sviluppo.

Tutte le operazioni di messa in servizio e le schermate associate vengono gestite da Play services durante la messa in servizio dei dispositivi. In questo modo, si offre un'esperienza utente coerente e non è necessario gestire autorizzazioni sensibili, ad esempio le credenziali Wi-Fi e Thread.

Controllare i dispositivi

Il fabric di sviluppo crea le credenziali per controllare Matter dispositivi direttamente dall'app di esempio.

Dalla schermata Home, puoi attivare o disattivare il dispositivo. Tocca il dispositivo per accedere ai dettagli.

Condividere i dispositivi

La condivisione di un dispositivo è definita flusso multi-amministratore nella Matter specifica. Una volta messo in servizio un dispositivo nell'app di esempio, puoi condividerlo facilmente con altri ecosistemi.

Per condividere il tuo dispositivo Matter con altri ecosistemi, devi avere un'altra piattaforma installata sul tuo dispositivo Android. Questa piattaforma esterna diventa il commissioner di destinazione. Abbiamo creato un'altra istanza dell'app di esempio che puoi utilizzare come commissioner di destinazione.

1. Vai alla sezione Releases nel Sample App for Matter repository GitHub. Per la release più recente, individua nella sezione Assets l'APK denominato GHSAFM-version-targetcommissioner-debug.apk. Non selezionare default.

2. Installa il commissioner di destinazione.

   $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
   

3. Dalla schermata Home, tocca il dispositivo per visualizzarne le informazioni. Tocca Condividi.

   

L'app di esempio chiama l'API Share Mobile SDK e, ancora una volta, il controllo viene trasferito a Play services.

Viene visualizzato un foglio di condivisione che ti consente di scegliere l'app o la piattaforma a cui vuoi accoppiare il dispositivo. Questa schermata offre due modi per condividere il dispositivo:

1. Manualmente tramite un codice di configurazione da condividere con l'app commissioner di destinazione
2. Con un'app Android locale registrata come Matter commissioner

L'app commissioner di destinazione è etichettata GHSAFM-TC. Tocca questa istanza dell'app di esempio per condividere il dispositivo.

L'app esterna (commissioner di destinazione) completa quindi la messa in servizio del dispositivo nel proprio fabric.

Impostazioni

Dalla schermata Home, fai clic sull'icona delle impostazioni settings Qui puoi aggiornare le preferenze utente, ricevere assistenza e scoprire di più sull'app.

Notifica a metà schermo

Dalla schermata Impostazioni, puoi scegliere di disattivare le notifiche di rilevamento proattivo dei dispositiviMatter che possono essere messi in servizio.

Se la tua applicazione fornisce il proprio Matter flusso di rilevamento o messa in servizio, potresti voler sopprimere queste notifiche per evitare interruzioni. Per saperne di più, consulta la sezione Sopprimere le notifiche di rilevamento dei dispositivi che possono essere messi in servizio.

Utilità per sviluppatori

Dalla schermata Impostazioni, puoi anche accedere a Utilità per sviluppatori.

Per esaminare i contenuti dei repository Device e User Preferences DataStore in Logcat:

1. Fai clic su Registra contenuti repository.

2. Fai clic su OK nella finestra di dialogo, quindi controlla Logcat.

Feedback e assistenza

Per inviare i tuoi pensieri o feedback su come possiamo migliorare l'esperienza di sviluppo con Sample App for Matter, compila il nostro modulo di feedback.

Inviaci il tuo feedback

Se riscontri problemi con il Sample App for Matter, prova a completare i passaggi per verificare il tuo ambiente:

• Verificare Matter i moduli e i servizi

Se hai domande sull'utilizzo dell'app di esempio o scopri un bug nel codice, puoi inviare i problemi all'Issue Tracker nel repository GitHub:

• sample-apps-for-matter-android/issues

Per ricevere indicazioni ufficiali da Google su domande tecniche, utilizza il forum degli sviluppatori per la smart home:

• Forum degli sviluppatori per la smart home

Per ricevere assistenza tecnica dalla community, utilizza il tag google-smart-home su Stack Overflow:

• Stack Overflow: google-smart-home