Il Google Home Sample App for Matter utilizza il Google Home Mobile SDK per creare un'app per Android simile Google Home app (GHA). Questa app di esempio fornisce le seguenti funzionalità:
- Commissione dispositivi Matter fisici e virtuali al fabric Android locale
- Commissione dispositivi fisici e virtuali a un'infrastruttura di sviluppo
- Controllare i dispositivi nella tua struttura di sviluppo, ad esempio l'attivazione di un leggero
- Le funzionalità di più amministratori ti consentono di condividere i dispositivi nel fabric di sviluppo con altre app e, viceversa, di includere nel fabric di sviluppo i 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 Matter dispositivi.
Per scaricare il codice sorgente, scopri come integrare Mobile SDK e personalizza le schermate in Android Studio, prova le nostre Codelab su 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. A assicurati che sul dispositivo sia installata la versione più recente di Matter assistenza, consulta Verifica Matter moduli e Servizi guida.
- Crea un dispositivo Matter con funzionalità On/Off. Questo
l'app di esempio funziona con un dispositivo virtuale e un ESP32.
- Dispositivo virtuale Matter (MVD). Per ridurre al minimo i problemi relativi all'ambiente, ti consigliamo vivamente di utilizzare inizialmente MVD. Se dovessi avere problemi, sarà molto più facile verifica se l'app di esempio viene utilizzata rispetto al MVD.
- Crea un dispositivo virtuale Matter
con l'app
rootnode_dimmablelight_bCwGYSDpoe. Quando Crea un'integrazione Matter in Google Home Developer Console, utilizza0xFFF1come ID fornitore e0x8000come ID prodotto. - Crea un dispositivo Espressif
con
all-clusters-app. Quando Crea un'integrazione Matter nel Developer Console, utilizza0xFFF1come ID fornitore e0x8001come ID prodotto.
Non hai bisogno di un hub, ad esempio un Google Nest Hub (2nd gen), per effettuare commissioni e controllare i dispositivi con Sample App for Matter.
Installa
Vai alla sezione Release nel Sample App for MatterGitHub repository Git. Per la versione più recente, individua la sezione Risorse l'APK denominato
GHSAFM-version-default-debug.apk. Non selezionare l'opzionetargetcommissioner.Installa Android Debug Bridge (adb):
Collega il dispositivo Android con un cavo USB e attiva Trasferimento file, quindi installa l'APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Dispositivi commissioni
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 visualizzare di nuovo 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 per il campione solo nell'app.
Cosa sono i tessuti Matter?
Un'infrastruttura Matter è un dominio condiviso di fiducia tra i dispositivi in una rete domestica che consenta loro di comunicare tra loro.
I dispositivi possono avere uno o più tessuti che corrispondono a una piattaforma, un'app o di dispositivi mobili che interagiscono tra loro. I tessuti hanno un'interfaccia e i dispositivi condividono lo stesso set di credenziali e autorità di certificazione (CA). Queste credenziali vengono assegnate durante Matter e la messa in servizio.
Per mettere in servizio un dispositivo Matter, svolgi i seguenti passaggi:
Tocca Aggiungi di Pulsante del dispositivo per avviare il processo di messa in servizio.
Successivamente, il controllo viene trasferito a Google Play services, che viene avviato da una chiamata al Mobile SDK. Per produrre la prova posseduto, Scansiona 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 all'infrastruttura Android locale sia alla di sviluppo.
Tutto il lavoro di messa in servizio e le schermate associate vengono gestiti Play services durante la messa in servizio dei dispositivi. Questo fornisce un'esperienza utente coerente ed elimina la necessità di gestire dati autorizzazioni, ad esempio le credenziali Wi-Fi e Thread.
Controllare i dispositivi
L'infrastruttura di sviluppo crea le credenziali per controllare Matter dispositivi direttamente dall'app di esempio.
Dalla schermata Home puoi attivare o disattivare il dispositivo. Tocca l'icona dispositivo per accedere ai dettagli del dispositivo.
Condividi dispositivi
La condivisione di un dispositivo è detta flusso con più amministratori nel specifica Matter. 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 un'altra piattaforma installata sul tuo dispositivo Android. Questo piattaforma esterna diventa il commissione target. Abbiamo creato un'altra istanza dell'app di esempio che puoi utilizzare come committente di destinazione.
Vai alla sezione Release nel Sample App for MatterGitHub repository Git. Per la release più recente, individua nella sezione Asset l'APK denominato
GHSAFM-version-targetcommissioner-debug.apk. Non selezionare l'opzionedefault.Installa il commissario obiettivo.
$ 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 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 desideri accoppiare il dispositivo. Questa schermata ti offre due modi per condividere 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 è denominata GHSAFM-TC. Tocca questa istanza app di esempio per condividere il tuo dispositivo.
L'app esterna (commissione di destinazione) completa la messa in servizio del dispositivo in un proprio tessuto.
Impostazioni
Dalla schermata Home, fai clic sulle impostazioni Icona di . Qui hai la possibilità di aggiornare le preferenze utente, ricevere assistenza e scoprire di più sull'app.
Notifica semifoglio
Dalla schermata Impostazioni, puoi scegliere di disattivare la funzione di messa in servizio proattiva notifiche di rilevamento per Matter dispositivi.
Se la tua applicazione fornisce il proprio rilevamento Matter o flusso di messa in servizio, ti consigliamo di eliminare queste notifiche per impedire interruzioni. Vedi Ignorare il rilevamento commissionabile notifiche per ulteriori informazioni.
Utilità per sviluppatori
Dalla schermata Impostazioni, puoi anche accedere a Utilità per sviluppatori.
a esaminare i contenuti dei repository del datastore delle preferenze utente e del dispositivo in Logcat, completa i seguenti passaggi:
Fai clic su Log dei contenuti dei repository.
Fai clic su OK nella finestra di dialogo, quindi seleziona Logcat.
Feedback e assistenza
Per inviare i tuoi commenti 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 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 la smart home Forum degli sviluppatori:
Per ricevere assistenza tecnica dalla community, utilizza il tag google-smart-home su
Stack Overflow: