Esempio di app Google Home per la pratica

Esempio di app Google Home per Matter

L'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à:

  • Commissione dispositivi Matter fisici e virtuali al Infrastruttura Android locale
  • Commissiona dispositivi fisici e virtuali a un tessuto di sviluppo
  • Controlla i dispositivi sul fabric di sviluppo, ad esempio accendendo una luce
  • Le funzionalità multi-amministratore ti consentono di condividere i dispositivi nel tessuto di sviluppo con altre app e, viceversa, di includerli nel tessuto di sviluppo 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 di 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 la messa in servizio e il controllo dei dispositivi con Sample App for Matter.

Installa

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

  2. Installa Android Debug Bridge (adb):

    Installa adb

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

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

Commissione 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 all'infrastruttura Android locale, insieme a un fabric di sviluppo locale solo dell'app di esempio.

Quali sono i tessuti Matter?

Esempio di app 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 corrispondenti 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 autorità di certificazione (CA). Queste credenziali vengono assegnate durante la messa in servizio di Matter.

Per mettere in servizio un dispositivo Matter, completa i seguenti passaggi:

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

    Aggiungi dispositivo

  2. In seguito, il controllo viene trasferito a Google Play services, che viene avviato da una chiamata a Mobile SDK. Per dimostrare di essere in possesso, Scansiona il codice QR o tocca Usa codice di accoppiamento.

    Esegui scansione codice QR

  3. Al termine della messa in servizio, inserisci un Nome dispositivo, quindi tocca Fine.

Il tuo dispositivo è ora connesso sia al fabric Android locale sia al tessuto di sviluppo.

Tutto il lavoro di messa in servizio e le schermate associate vengono gestiti da Play services durante la 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

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

Dalla schermata Home puoi impostare il dispositivo su On o Off. Tocca il dispositivo per accedere ai relativi dettagli.

Dispositivo aggiunto

Condividi dispositivi

La condivisione di un dispositivo è definita come flusso multi-amministratore nella specifica Matter. Dopo aver commissionato un dispositivo all'app di esempio, puoi condividerlo facilmente 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 commissario target. Abbiamo creato un'altra istanza dell'app di esempio che puoi usare come commissario di destinazione.

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

  2. Installa il commissioner target.

    $ 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 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 ti offre due modi per condividere il dispositivo:

  1. Manualmente tramite un codice di configurazione da condividere con l'app Commissioner target
  2. Con un'app Android locale che si è registrata come Matter Commissioner

L'app del Commissioner target è etichettata come 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 nella propria infrastruttura.

Impostazioni

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

Impostazioni

Notifica mezzo foglio

Nella schermata Impostazioni puoi scegliere di disabilitare le notifiche proattive di rilevamento della commissione per i dispositivi Matter.

Se l'applicazione fornisce un proprio flusso di rilevamento o di invio in Matter, ti consigliamo di eliminare queste notifiche per evitare interruzioni. Per ulteriori informazioni, consulta Ignora le notifiche di rilevamento commissionabile.

Utilità per sviluppatori

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

Per esaminare i contenuti dei repository DataStore relativi alle preferenze dei dispositivi e degli utenti in Logcat, completa i seguenti passaggi:

  1. Fai clic su Registra contenuti repository.

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

Feedback e assistenza

Per inviare le tue opinioni o 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 il tuo ambiente:

Se hai domande sull'utilizzo dell'app di esempio o scopri un bug del codice, puoi inviare problemi a Issue Tracker 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: