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 offre le seguenti funzionalità:
- Esegui il provisioning di dispositivi fisici e virtuali Matter nel tessuto Android locale
- Mettere in servizio dispositivi fisici e virtuali in un fabric di sviluppo
- Controllare i dispositivi nel tuo tessuto di sviluppo, ad esempio accendere una luce
- Le funzionalità multi-amministratore ti consentono di condividere dispositivi nel tessuto di sviluppo con altre app e, viceversa, di includere nel tessuto di sviluppo dispositivi condivisi da altre app
- Utilità per sviluppatori
Questa guida descrive come installare l'APK Sample App for Matter e utilizzarlo per configurare, 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 Sample App for Matter.
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 abbia il supporto più recente per Matter, consulta la guida Verifica moduli e servizi Matter.
- Crea un dispositivo Matter con funzionalità di accensione/spegnimento. 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 dovessi riscontrare 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'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 hai bisogno di un hub, ad esempio un Google Nest Hub (2nd gen), per eseguire il provisioning e controllare i dispositivi con Sample App for Matter.
Installa
Vai alla sezione Releases nel repository Sample App for Matter GitHub. Per la release più recente, individua nella sezione Asset l'APK denominato
GHSAFM-version-default-debug.apk
. Non selezionaretargetcommissioner
.Installa Android Debug Bridge (adb):
Collega il dispositivo Android tramite USB e attiva Trasferimento file, poi installa l'APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Configurare i dispositivi
Quando avvii l'app di esempio per la prima volta, viene visualizzata una finestra di dialogo con un link al codelab 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 al tessuto Android locale, insieme a un tessuto di sviluppo locale solo per l'app di esempio.
Che cosa sono i tessuti Matter?
Un'Matterinfrastruttura è un dominio di attendibilità condiviso tra i dispositivi in 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 fabric hanno un ID univoco e i dispositivi condividono lo stesso insieme di credenziali e la stessa autorità di certificazione (CA). Queste credenziali vengono assegnate durante l'inizializzazione di Matter.
Per commissionare un dispositivo Matter:
Tocca il pulsante
Aggiungi dispositivo per avviare la procedura di configurazione.Il controllo viene quindi trasferito a Google Play services, che viene avviato da una chiamata a Mobile SDK. Per stabilire la prova di possesso, Scansiona il codice QR o tocca Usa codice di accoppiamento.
Al termine del commissioning, inserisci un nome dispositivo, quindi tocca Fine.
Il dispositivo è ora connesso sia al tessuto Android locale sia al tessuto di sviluppo.
Tutte le operazioni di configurazione e le schermate associate vengono gestite da Play services durante la configurazione dei dispositivi. In questo modo, l'esperienza utente è coerente e non è necessario gestire autorizzazioni sensibili, ad esempio le credenziali Wi-Fi e Thread.
Controllare i dispositivi
Il tessuto di sviluppo crea le credenziali per controllare i dispositivi Matter direttamente dall'app di esempio.
Dalla schermata Home, puoi attivare o disattivare il dispositivo. Tocca il dispositivo per accedere ai relativi dettagli.
Condividi dispositivi
La condivisione di un dispositivo è definita flusso multi-amministratore nella specifica Matter. Una volta che un dispositivo è stato commissionato all'app di esempio, puoi condividerlo facilmente con altri ecosistemi.
Per condividere il tuo dispositivo Matter con altri ecosistemi, devi installare 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 di destinazione.
Vai alla sezione Releases nel repository Sample App for Matter GitHub. Per la release più recente, individua nella sezione Asset l'APK denominato
GHSAFM-version-targetcommissioner-debug.apk
. Non selezionaredefault
.Installa il target commissioner.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
Dalla schermata Home, tocca il dispositivo per visualizzare le 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 di destinazione
- Con un'app per Android locale registrata come Matter commissario
L'app del commissario di destinazione è etichettata GHSAFM-TC. Tocca questa istanza dell'app di esempio per condividere il tuo dispositivo.
Successivamente, l'app esterna (commissioner di destinazione) completa il commissioning del dispositivo nel proprio tessuto.
Impostazioni
Nella schermata Home, fai clic sull'icona delle impostazioni
. Qui puoi aggiornare le preferenze utente, ricevere assistenza e scoprire di più sull'app.Notifica di metà foglio
Nella schermata Impostazioni, puoi scegliere di disattivare le notifiche di rilevamento proattivo commissionabile per i dispositivi Matter.
Se la tua applicazione fornisce un proprio flusso di rilevamento o commissione, potresti voler sopprimere queste notifiche per evitare interruzioni.Matter Per ulteriori informazioni, consulta la sezione Disattivare le notifiche di scoperta commissionabile.
Utilità per sviluppatori
Dalla schermata Impostazioni puoi anche accedere a Utilità per sviluppatori.
Per esaminare i contenuti dei repository Device and User Preferences DataStore in Logcat, completa i seguenti passaggi:
Fai clic su Registra contenuti dei repository.
Fai clic su Ok nella finestra di dialogo, quindi seleziona 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.
Se riscontri 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 nel codice, puoi inviare i problemi al Issue Tracker nel repository GitHub:
Per ricevere indicazioni ufficiali da Google su domande tecniche, utilizza il forum per sviluppatori di Smart Home:
Per ricevere assistenza tecnica dalla community, utilizza il tag google-smart-home
su
Stack Overflow: