L'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à:
- Commissione dispositivi Matter fisici e virtuali al Infrastruttura Android locale
- Commissiona dispositivi fisici e virtuali a un tessuto di sviluppo
- Controlla i dispositivi sul fabric di sviluppo, ad esempio accendendo una luce
- Le funzionalità multi-amministratore ti consentono di condividere i dispositivi nel tessuto di sviluppo con altre app e, viceversa, di includerli nel tessuto di sviluppo condivisi da altre app
- Utilità per sviluppatori
Questa guida descrive come installare l'APK Sample App for Matter e utilizzarlo per commissionare, controllare e condividere i dispositivi Matter.
Per scaricare il codice sorgente, scoprire come integrare Mobile SDK e personalizzare le schermate in Android Studio, prova il nostro codelab di Sample App for Matter.
Vai al codelab Sample App for Matter
Prerequisiti
- Un dispositivo Android O (8.1, livello API 27) o versioni successive disponibile per i test. Per assicurarti che il tuo dispositivo disponga della versione più recente di Matter, consulta la guida Verifica moduli e servizi Matter.
- Crea un dispositivo Matter con funzionalità di accensione e spegnimento. Questa app di esempio funziona con un dispositivo virtuale e un ESP32.
- Dispositivo virtuale Matter (MVD). Per ridurre al minimo i problemi di ambiente, consigliamo vivamente di utilizzare MVD per iniziare. In caso di problemi, sarà molto più facile investigare se l'app di esempio viene utilizzata contro l'MVD.
- Crea un dispositivo virtuale Matter
con l'app
rootnode_dimmablelight_bCwGYSDpoe
. Quando crei un'integrazione Matter in Google Home Developer Console, utilizza0xFFF1
come ID fornitore e0x8000
come ID prodotto. - Crea un dispositivo Espressif
con
all-clusters-app
. Quando crei un'integrazione Matter in Developer Console, utilizza0xFFF1
come ID fornitore e0x8001
come ID prodotto.
Non è necessario un hub, ad esempio un Google Nest Hub (2nd gen), per la messa in servizio e il controllo dei dispositivi con Sample App for Matter.
Installa
Vai alla sezione Release nel repository GitHub di Sample App for Matter. Per la release più recente, individua l'APK denominato
GHSAFM-version-default-debug.apk
nella sezione Asset. Non selezionaretargetcommissioner
.Installa Android Debug Bridge (adb):
Collega il tuo dispositivo Android tramite USB e abilita Trasferimento file, quindi installa l'APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Commissione dispositivi
Quando avvii l'app di esempio per la prima volta, viene visualizzata una finestra di dialogo con un link al codelab di Sample App for Matter. 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 all'infrastruttura Android locale, insieme a un fabric di sviluppo locale solo dell'app di esempio.
Quali sono i tessuti Matter?
Un fabric Matter è un dominio di attendibilità condiviso tra i dispositivi di una rete di casa che consente loro di comunicare tra loro.
I dispositivi possono avere uno o più fabric corrispondenti 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 set di credenziali e autorità di certificazione (CA). Queste credenziali vengono assegnate durante la messa in servizio di Matter.
Per mettere in servizio un dispositivo Matter, completa i seguenti passaggi:
Tocca il pulsante Aggiungi dispositivo
per avviare la procedura di messa in servizio.In seguito, il controllo viene trasferito a Google Play services, che viene avviato da una chiamata a Mobile SDK. Per dimostrare di essere in possesso, Scansiona il codice QR o tocca Usa codice di accoppiamento.
Al termine della messa in servizio, inserisci un Nome dispositivo, quindi tocca Fine.
Il tuo dispositivo è ora connesso sia al fabric Android locale sia al tessuto di sviluppo.
Tutto il lavoro di messa in servizio e le schermate associate vengono gestiti da Play services durante la messa in servizio dei dispositivi. Ciò fornisce un'esperienza utente coerente ed elimina la necessità di gestire autorizzazioni sensibili, ad esempio le credenziali Wi-Fi e Thread.
Controllare i dispositivi
Il fabric di sviluppo crea le credenziali per controllare i dispositivi Matter direttamente dall'app di esempio.
Dalla schermata Home puoi impostare il dispositivo su On o Off. Tocca il dispositivo per accedere ai relativi dettagli.
Condividi dispositivi
La condivisione di un dispositivo è definita come flusso multi-amministratore nella specifica Matter. Dopo aver commissionato un dispositivo all'app di esempio, puoi condividerlo facilmente con altri ecosistemi.
Per condividere il tuo dispositivo Matter con altri ecosistemi, devi avere installato un'altra piattaforma sul tuo dispositivo Android. Questa piattaforma esterna diventa il commissario target. Abbiamo creato un'altra istanza dell'app di esempio che puoi usare come commissario di destinazione.
Vai alla sezione Release nel repository GitHub di Sample App for Matter. Per la release più recente, individua l'APK denominato
GHSAFM-version-targetcommissioner-debug.apk
nella sezione Asset. Non selezionaredefault
.Installa il commissioner target.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
Dalla schermata Home, tocca il dispositivo per visualizzare le relative informazioni. Tocca Condividi.
L'app di esempio chiama l'API Mobile SDK Share 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 ti offre due modi per condividere il dispositivo:
- Manualmente tramite un codice di configurazione da condividere con l'app Commissioner target
- Con un'app Android locale che si è registrata come Matter Commissioner
L'app del Commissioner target è etichettata come GHSAFM-TC. Tocca questa istanza dell'app di esempio per condividere il tuo dispositivo.
Successivamente, l'app esterna (commissario target) completa la messa in servizio del dispositivo nella propria infrastruttura.
Impostazioni
Dalla schermata Home, fai clic sull'icona delle impostazioni
. Qui hai le opzioni per aggiornare le preferenze utente, ricevere assistenza e scoprire di più sull'app.Notifica mezzo foglio
Nella schermata Impostazioni puoi scegliere di disabilitare le notifiche proattive di rilevamento della commissione per i dispositivi Matter.
Se l'applicazione fornisce un proprio flusso di rilevamento o di invio in Matter, ti consigliamo di eliminare queste notifiche per evitare interruzioni. Per ulteriori informazioni, consulta Ignora le notifiche di rilevamento commissionabile.
Utilità per sviluppatori
Dalla schermata Impostazioni puoi anche accedere alle Utilità per sviluppatori.
Per esaminare i contenuti dei repository DataStore relativi alle preferenze dei dispositivi e degli utenti in Logcat, completa i seguenti passaggi:
Fai clic su Registra contenuti repository.
Fai clic su OK nella finestra di dialogo e seleziona Logcat.
Feedback e assistenza
Per inviare le tue opinioni o feedback su come possiamo migliorare l'esperienza di sviluppo con Sample App for Matter, compila il nostro modulo di feedback.
Se hai problemi con Sample App for Matter, prova a completare i passaggi per verificare il tuo ambiente:
Se hai domande sull'utilizzo dell'app di esempio o scopri un bug del codice, puoi inviare problemi a Issue Tracker nel repository GitHub:
Per ricevere indicazioni ufficiali di Google in merito a domande tecniche, utilizza il Forum per gli sviluppatori per la smart home:
Per ricevere assistenza tecnica dalla community, utilizza il tag google-smart-home
su Stack Overflow: