App di esempio Google Home per Matter

App di esempio Google Home per Matter

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 commissioning di dispositivi Matter fisici e virtuali nel fabric Android locale
  • Esegui il commissioning di dispositivi fisici e virtuali in un fabric di sviluppo
  • Controllare i dispositivi sul tuo fabric di sviluppo, ad esempio accendere una luce
  • Le funzionalità multi-amministratore 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 utilizzarlo per commissionare, 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 codelab Sample App for Matter

Prerequisiti

Non è necessario un hub, ad esempio un Google Nest Hub (2nd gen), per mettere in funzione e controllare i dispositivi con Sample App for Matter.

Installa

  1. Vai alla sezione Releases nel repository GitHub Sample App for Matter. Per la release più recente, individua nella sezione Asset l'APK denominato GHSAFM-version-default-debug.apk. Non selezionare targetcommissioner.

  2. Installa Android Debug Bridge (adb):

    Installa adb

  3. Collega il tuo dispositivo Android tramite USB e attiva Trasferimento file, quindi installa l'APK:

    $ adb unroot && adb install GHSAFM-version-default-debug.apk

Configura 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 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 fabric Android locale, insieme a un fabric di sviluppo locale solo per l'app di esempio.

Che cosa sono i fabric Matter?

App di esempio Google Home per Matter

Un fabric 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ù 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 insieme di credenziali e la stessa autorità di certificazione (CA). Queste credenziali vengono assegnate durante la messa in servizio di Matter.

Per commissionare un dispositivo Matter, completa i seguenti passaggi:

  1. Tocca il pulsante Aggiungi dispositivo per avviare la procedura di messa in servizio.

    Aggiungi dispositivo

  2. Successivamente, il controllo viene 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.

    Esegui scansione codice QR

  3. Al termine della configurazione, inserisci un nome del dispositivo, quindi tocca Fine.

Il tuo dispositivo è ora connesso sia alla rete locale Android sia alla rete di sviluppo.

Tutte le operazioni di commissione e le schermate associate vengono gestite da Play services durante la commissione dei dispositivi. In questo modo, viene offerta un'esperienza utente coerente e non è necessario gestire autorizzazioni sensibili, ad esempio le credenziali Wi-Fi e Thread.

Controllare i dispositivi

La piattaforma di sviluppo crea le credenziali per controllare i dispositivi Matter direttamente dall'app di esempio.

Dalla schermata Home, puoi attivare o disattivare il dispositivo toccando On o Off. Tocca il dispositivo per accedere ai relativi dettagli.

Dispositivo aggiunto

Condividi dispositivi

La condivisione di un dispositivo è definita flusso multi-amministratore nella specifica Matter. Una volta commissionato un dispositivo 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 commissioner di destinazione. Abbiamo creato un'altra istanza dell'app di esempio che puoi utilizzare come commissionatore di destinazione.

  1. Vai alla sezione Releases 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 selezionare default.

  2. Installa il commissioner di destinazione.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. Dalla schermata Home, tocca il dispositivo per visualizzare le relative informazioni. Tocca Condividi.

    Condividi dispositivo

L'app di esempio chiama l'API Share di Mobile SDK 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:

  1. Manualmente tramite un codice di configurazione da condividere con l'app del gestore di accoppiamento di destinazione
  2. Con un'app per Android locale registrata come commissioner Matter

L'app del commissioner di destinazione è etichettata come GHSAFM-TC. Tocca questa istanza dell'app di esempio per condividere il tuo dispositivo.

Successivamente, l'app esterna (commissioner di destinazione) completa la messa in servizio del dispositivo nel proprio fabric.

Impostazioni

Nella schermata Home, fai clic sull'icona delle impostazioni . Qui puoi aggiornare le preferenze utente, ricevere assistenza e scoprire di più sull'app.

Impostazioni

Notifica a metà schermo

Dalla schermata Impostazioni, puoi scegliere di disattivare le notifiche di rilevamento proattivo dei dispositivi Matter commissionabili.

Se la tua applicazione fornisce il proprio flusso di rilevamento o commissionamento Matter, potresti voler sopprimere queste notifiche per evitare interruzioni. Per saperne di più, consulta Elimina le notifiche di rilevamento commissionabili.

Utilità per sviluppatori

Dalla schermata Impostazioni, puoi anche accedere alle Utilità per sviluppatori.

Per esaminare i contenuti dei repository DataStore delle preferenze del dispositivo e dell'utente in Logcat, completa i seguenti passaggi:

  1. Fai clic su Registra i contenuti dei repository.

  2. Fai clic su OK nella finestra di dialogo, quindi seleziona Logcat.

Feedback e assistenza

Per inviare le tue opinioni o i tuoi feedback su come possiamo migliorare l'esperienza di sviluppo con Sample App for Matter, compila il nostro modulo di feedback.

Inviaci il tuo feedback

Se hai 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 scopri un bug nel codice, puoi inviare i problemi a Issue Tracker nel repository GitHub:

Per ricevere indicazioni ufficiali da Google su domande tecniche, utilizza il forum per gli sviluppatori di smart home:

Per ricevere assistenza tecnica dalla community, utilizza il tag google-smart-home su Stack Overflow: