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à:
- Esegui la messa in servizio di dispositivi Matter fisici e virtuali nel fabbricato Android locale
- Commissione dispositivi fisici e virtuali a un'infrastruttura di sviluppo
- Controllare i dispositivi nel tuo fabric di sviluppo, ad esempio accendere una lampada
- Le funzionalità di più amministrazione ti consentono di condividere i dispositivi nell'infrastruttura di sviluppo con altre app e al contrario di includerli nel tessuto di sviluppo dei 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 Mobile SDK e personalizzare le schermate in Android Studio, prova il nostro codelab su Mobile SDK.
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 sul tuo dispositivo sia installata l'ultima versione dell'assistenza Matter, consulta la guida alla verifica dei moduli e dei servizi di Matter.
- Crea un dispositivo Matter con funzionalità On/Off. Questa
app di esempio funziona con un dispositivo virtuale e un ESP32.
- Matter Virtual Device (MVD). Per ridurre al minimo i problemi legati all'ambiente, ti consigliamo vivamente di iniziare con un MVD. Se dovessi riscontrare problemi, sarà molto più facile indagare se l'app di esempio viene utilizzata contro il MVD.
- Crea un dispositivo virtuale Matter con l'app
rootnode_dimmablelight_bCwGYSDpoe. Quando crei un'integrazione Matter in Google Home Developer Console, usa0xFFF1come ID fornitore e0x8000come ID prodotto. - Crea un dispositivo Espressif
con
all-clusters-app. Quando crei un'integrazione Matter in Developer Console, utilizza0xFFF1come ID fornitore e0x8001come ID prodotto.
Non è necessario un hub, ad esempio un Google Nest Hub (2nd gen), per commissionare e controllare i dispositivi con il Sample App for Matter.
Installa
Vai alla sezione Uscite 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, quindi 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 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 al Matterfabric Android locale, insieme a un fabric di sviluppo locale solo per l'app di esempio.
Che cosa sono i componenti Matter?
Un'infrastruttura Matter è un dominio condiviso di attendibilità tra i dispositivi in una rete di casa 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 set di credenziali e un'autorità di certificazione (CA). Queste credenziali vengono assegnate durante la Mattercommissione.
Per mettere in servizio un dispositivo Matter, svolgi 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 viene avviato da una chiamata al Mobile SDK. Per dimostrare di essere il proprietario, scansiona il codice QR o tocca Utilizza il codice di accoppiamento.
Al termine della messa in servizio, inserisci un nome del dispositivo e tocca Fine.
Il tuo dispositivo è ora connesso sia all'infrastruttura Android locale sia alla struttura di sviluppo.
Tutto il lavoro di messa in servizio e le schermate associate vengono gestiti da Play services al momento della messa in servizio dei dispositivi. In questo modo, viene offerta 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 dispositiviMatter direttamente dall'app di esempio.
Dalla schermata Home, puoi attivare o disattivare il dispositivo impostandolo su On o Off. Tocca il dispositivo per accedere ai relativi dettagli.
Condividi dispositivi
La condivisione di un dispositivo è indicata come flusso con più amministratori nella Matter specifica. Una volta che un dispositivo viene commissionato all'app di esempio, puoi facilmente condividerlo 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 commissionario target. Abbiamo creato un'altra istanza dell'app di esempio che puoi utilizzare come committente di destinazione.
Vai alla sezione Release nel repository GitHub Sample App for Matter. Per la release più recente, individua nella sezione Asset l'APK denominato
GHSAFM-version-targetcommissioner-debug.apk. Non selezionaredefault.Installa il commissario target.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkDalla schermata Home, tocca il dispositivo per visualizzare le relative informazioni. Tocca Condividi.
L'app di esempio chiama l'API di condivisione Mobile SDK e, di nuovo, il controllo viene trasferito a Play services.
Viene visualizzato un foglio di condivisione in cui puoi 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 commissarioMatter
L'app del commissario target è denominata GHSAFM-TC. Tocca questa istanza dell'app di esempio per condividere il tuo dispositivo.
Successivamente, l'app esterna (commissione di destinazione) 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 actualizare le preferenze utente, ricevere assistenza e scoprire di più sull'app.
Notifica half-sheet
Nella schermata Impostazioni, puoi scegliere di disattivare le notifiche di rilevamento proattivo commissionabili per i dispositivi Matter.
Se la tua applicazione fornisce il proprio Matterflusso di scoperta o commissioning, ti consigliamo di eliminare queste notifiche per evitare interruzioni. Per ulteriori informazioni, consulta Sopprimere le notifiche di rilevamento delle commissioni.
Utilità per sviluppatori
Dalla schermata Impostazioni, puoi anche accedere a Utilità per sviluppatori.
Per esaminare i contenuti dei repository DataStore delle preferenze utente e del dispositivo in Logcat, svolgi i seguenti passaggi:
Fai clic su Registra i contenuti dei repository.
Fai clic su OK nella finestra di dialogo, quindi seleziona Logcat.
Feedback e assistenza
Per inviare la tua opinione 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 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 scopri un bug nel codice, puoi inviare i problemi al tracker dei problemi 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: