La pagina Google Home Sample App for Matter uses the Google Home Mobile SDK to create an Android app that's similar to Google Home app (GHA) . This sample app provides the following features:
- Commissione fisica e virtuale Matter devices to the Local Android fabric
- Esegui la commissione di dispositivi fisici e virtuali in una struttura di sviluppo
- Controlla i dispositivi sul tessuto di sviluppo, ad esempio accendendo una luce
- Le funzionalità di amministrazione multipla ti consentono di condividere i dispositivi nell'infrastruttura di sviluppo con altre app e, al contrario, di poter essere inclusi nel tessuto di sviluppo condiviso da altre app
- Utilità degli sviluppatori
Questa guida descrive come installare l'APK Sample App for Matter e utilizzarlo per commissionare, controllare e condividere Matter dispositivi.
Per scaricare il codice sorgente, scopri come integrare Mobile SDK e personalizzare gli schermi in Android Studio, prova il nostro codelab su Sample App for Matter.
Vai al Sample App for Matter codelab
Prerequisiti
- Un dispositivo Android O (8.1, livello API 27) o successivo disponibile per i test. Per assicurarti che il tuo dispositivo sia aggiornato sul servizio di supporto Matter, consulta la guida Verificare moduli e servizi Matter.
- Crea un
dispositivo Matter con funzionalità on/off. 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) , to commission and control devices with the 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 selezionaretargetcommissioner
:Installa Android Debug Bridge (adb):
Collega il dispositivo Android con USB e attiva File Transfer, quindi installa l'APK:
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
Commissione di dispositivi
La prima volta che avvii l'app di esempio, viene visualizzata una finestra di dialogo con un link al codelab su Sample App for Matter. Se selezioni Non mostrare più questo messaggio, puoi richiamare la finestra di dialogo in qualsiasi momento aggiornando le preferenze nella sezione Amministrazione 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?
tessuto è un dominio condiviso di attendibilità tra i dispositivi di una rete domestica 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 Matter.
Per mettere in servizio un dispositivo Matter:
Tocca il pulsante Aggiungi dispositivo
per avviare la procedura di messa in servizio.Successivamente, il controllo viene trasferito a Google Play services , which is launched from a call to the Mobile SDK. To establish proof of possession, Scan QR code or tap Use pairing code.
Al termine della messa in servizio, inserisci un Nome dispositivo, quindi tocca Fine.
Il tuo dispositivo è ora collegato sia al tessuto Android locale sia al tessuto di sviluppo.
Tutto il lavoro e le schermate associate sono gestite da Play services al momento della 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
L'infrastruttura di sviluppo crea le credenziali per controllare i dispositivi Matter dall'app di esempio.
Dalla schermata Home, puoi attivare o disattivare il dispositivo. Toccalo per accedere ai relativi dettagli.
Condividi dispositivi
La condivisione di un dispositivo è definita flusso multi-amministratore nella specifica Matter. Una volta che il dispositivo viene commissionato all'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 commissario target. Abbiamo creato un'altra istanza dell'app di esempio che puoi utilizzare come commissione di destinazione.
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 di destinazione.
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
Dalla schermata Home, tocca il dispositivo per visualizzarne le informazioni. Tocca Condividi.
L'app di esempio chiama l'API Mobile SDK Share e di nuovo, 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 della commissione di destinazione
- Con un'app Android locale registrata come Matter commissario
L'app Commissioner target è denominata 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 nel proprio tessuto.
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, potresti voler eliminare queste notifiche per evitare interruzioni. Per saperne di più, elimina le notifiche di rilevamento con commissione.
Utilità per sviluppatori
Dalla schermata Impostazioni puoi anche accedere alle Utilità dello sviluppatore.
Per esaminare i contenuti dei repository dispositivo e preferenze utente DataStore in Logcat, procedi nel seguente modo:
Fai clic su Registra repository.
Fai clic su OK nella finestra di dialogo, quindi seleziona Logcat.
Feedback e assistenza
Per inviare la tua opinione o il tuo feedback su come possiamo migliorare l'esperienza di sviluppo con Sample App for Matter, compila il nostro modulo di feedback.
Se hai problemi con il Sample App for Matter, prova a completare i passaggi per verificare il tuo ambiente:
Se hai domande sull'utilizzo dell'app di esempio o su un bug del codice, puoi inviare problemi a Issue Tracker nel repository GitHub:
Per ricevere indicazioni ufficiali da Google su domande tecniche, visita il forum per gli sviluppatori di smart home:
Per ricevere assistenza tecnica dalla community, utilizza il tag google-smart-home
su Stack Overflow: