Google Home Sample App for Matter utilizza Google Home Mobile SDK per creare un'app Android simile a Google Home app (GHA). Questa app di esempio fornisce le seguenti funzionalità:
- Commissioni per i dispositivi Matter fisici e virtuali nel tessuto Android locale
- Commissione i dispositivi fisici e virtuali a un'infrastruttura di sviluppo
- Controlla i dispositivi sul tessuto di sviluppo, ad esempio accendendo una luce
- Le funzionalità di amministrazione multipla ti consentono di condividere dispositivi sul tessuto di sviluppo con altre app e di includere anche nei tessuti di sviluppo condivisi da altre app
- Utilità dello sviluppatore
Questa guida descrive come installare l'APK Sample App for Matter e come utilizzarlo per eseguire commissioni, controllare e condividere dispositivi Matter.
Per scaricare il codice sorgente, scopri come integrare Mobile SDK e personalizzare le schermate in Android Studio, prova il nostro codelab su Sample App for Matter.
Vai al codelab di Sample App for Matter
Prerequisiti
- Un dispositivo Android O (8.1, livello API 27) o successivo disponibile per i test. Per assicurarti che sul tuo dispositivo sia supportato l'assistenza Matter più recente, consulta la guida Verifica i moduli e i servizi Matter.
- Creare un dispositivo Matter con le funzionalità di accensione e spegnimento. Questa
app di esempio funziona con un dispositivo virtuale e un ESP32.
- 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.
- Crea un dispositivo virtuale Matter con l'app
Non hai bisogno di un hub, ad esempio Google Nest Hub (2nd gen), per commissionare e controllare i dispositivi con il Sample App for Matter.
Installa
Vai alla sezione Release nel repository GitHub Sample App for Matter. Individua l'APK denominato
GHSAFM-1.4.1-default-debug.apk
. Non selezionare:targetcommissioner
:Installa Android Debug Bridge (adb):
Collega il dispositivo Android tramite USB e attiva File Transfer, quindi installa l'APK:
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
Dispositivi con commissione
Al primo avvio dell'app, viene visualizzata una finestra di dialogo con un link al codelab di Sample App for Matter. Se selezioni Non mostrare più questo messaggio, puoi tornare alla finestra di dialogo in qualsiasi momento aggiornando le preferenze nella sezione Amministratore dell'app.
Nei passaggi successivi, aggiungerai un dispositivo Matter al tessuto Android locale, oltre a un tessuto di sviluppo locale solo per l'app di esempio.
Cosa sono i tessuti Matter?
Un tessuto 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ù tessuti che corrispondono a una piattaforma, un'app o un gruppo di dispositivi che interagiscono tra loro. I tessuti hanno un ID univoco e i dispositivi condividono lo stesso insieme di credenziali e autorità di certificazione (CA). Queste credenziali vengono assegnate durante la licenza 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.Successivamente, il controllo viene trasferito a Google Play services, che è stato lanciato da una chiamata al Mobile SDK. Per stabilire la prova di possedimento, Scansiona codice QR o tocca Utilizza il codice di accoppiamento.
Al termine della messa in servizio, inserisci un Nome dispositivo, quindi tocca Fine.
Il dispositivo è ora collegato sia al tessuto Android locale sia al tessuto di sviluppo.
Tutto il lavoro di messa in servizio e le schermate associate vengono gestite da Play services durante la messa in servizio dei dispositivi. In questo modo puoi garantire un'esperienza utente coerente ed eliminare la necessità di gestire autorizzazioni sensibili, ad esempio Wi-Fi e credenziali Thread.
Controllare i dispositivi
L'infrastruttura di sviluppo crea le credenziali per controllare Matter i dispositivi direttamente dall'app di esempio.
Dalla schermata Home puoi impostare il tuo dispositivo su On o Off. Tocca il dispositivo per accedere ai relativi dettagli.
Condividi dispositivi
La condivisione di un dispositivo è detta 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 utilizzare come commissario target.
Vai alla sezione Release nel repository GitHub Sample App for Matter. Individua l'APK più recente denominato
GHSAFM-[version]-targetcommissioner
, ad esempioGHSAFM-1.4.1-targetcommissioner-debug.apk
:Installa il commissario target.
$ adb unroot && adb install GHSAFM-1.4.1-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 offre due modi per condividere il dispositivo:
- Manualmente tramite un codice di configurazione da condividere con l'app del commissario target
- Con un'app Android locale registrata come commissario Matter
L'app del commissario 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 struttura.
Impostazioni
Nella schermata Home, fai clic sull'icona delle impostazioni
. Qui hai la possibilità di aggiornare le preferenze utente, ricevere assistenza e scoprire di più sull'app.Notifica a metà foglio
Dalla schermata Impostazioni, puoi scegliere di disattivare le notifiche di rilevamento proattive commissionabili per i dispositivi Matter.
Se la tua applicazione fornisce un proprio flusso di rilevamento o messa in servizio Matter, potrebbe essere opportuno eliminare queste notifiche per evitare interruzioni. Per ulteriori informazioni, consulta la pagina Elimina le notifiche di rilevamento commissionabili.
Utilità dello sviluppatore
Dalla schermata Impostazioni puoi anche accedere alle Utilità sviluppatore.
Per esaminare i contenuti dei repository DataStore dispositivo e preferenze utente in Logcat, completa i seguenti passaggi:
Fai clic su Registra repository di contenuti.
Fai clic su OK nella finestra di dialogo e seleziona Logcat.
Feedback e assistenza
Completa il nostro modulo per inviare un feedback per farci sapere cosa pensi del modo in cui possiamo migliorare l'esperienza di sviluppo con Sample App for Matter.
In caso di problemi con Sample App for Matter, prova a completare i passaggi per verificare l'ambiente:
Se hai domande sull'utilizzo dell'app di esempio o su un bug del codice, puoi inviare problemi allo strumento Issue Tracker nel repository GitHub:
Per ricevere indicazioni ufficiali da Google su domande tecniche, visita il forum per gli sviluppatori di soluzioni per la smart home:
Per ricevere assistenza tecnica dalla community, utilizza il tag google-smart-home
su Stack Overflow: