Estensione Google Home per codice VS

SDK Local Home    da cloud a cloud    di Matter

Google Home Extension for Visual Studio Code è progettato e creato per gli sviluppatori di Google Home Platform. Questa estensione ti dà accesso a Google Assistant Simulator, Google Cloud Logging, a Home Graph Viewer e ad altri strumenti per semplificare il processo di sviluppo di Matter e della smart home.

Estensione Google Home per VS Code

Funzionalità dell'estensione Google Home

Simulatore dell'Assistente Google

Per verificare se i tuoi dispositivi per la smart home funzionano correttamente con l'ecosistema Google Home, puoi interagire con Assistant Simulator in qualsiasi momento senza uscire da VS Code.

Assistant Simulator ti consente di controllare facilmente i tuoi dispositivi digitando le query, ad esempio "Accendi la luce." In VS Code, Assistant Simulator risponde con messaggi di testo in base ai tuoi comandi, ad esempio "Ok, accendo la luce." Per ulteriori dettagli, consulta Utilizzare il simulatore dell'Assistente Google.

Espressioni batch

Per testare l'integrazione di Google Home come un automa, puoi inviare espressioni batch al simulatore dell'Assistente Google eseguendo uno script di espressioni. Per ulteriori dettagli, consulta Eseguire espressioni batch.

Strumenti di logging di Matter

Gli strumenti di logging di Matter possono raccogliere tutti i log relativi al debug Matter, inclusi i log Google Home app (GHA) e i log di Google Play Services (GMS Core). I log possono essere visualizzati in VS Code con filtri e ricerche per parole chiave. I log possono essere scaricati con informazioni di debug aggiuntive, come Android e la versione dell'app, e inviati a Google per segnalare i problemi.

Registrazione di log di Google Home Extension Matter

Cloud Logging

Cloud Logging fornisce informazioni di debug e metriche chiave per darti informazioni sull'utilizzo della tua Action. Per semplificare lo sviluppo, Google Home Extension mostra i messaggi di Google Cloud Logging in tempo reale accanto al codice durante la risoluzione dei problemi. Per ulteriori dettagli, consulta Visualizzare Cloud Logging.

Home Graph Viewer

Home Graph Viewer è ora disponibile direttamente in Google Home Extension così puoi verificare lo stato del dispositivo in Home Graph all'interno di VS Code. Per ulteriori dettagli, consulta Visualizzare Home Graph ed eseguire test.

Installare l'estensione Google Home per VS Code

Per installare Google Home Extension, segui questi passaggi da VS Code:

  1. Fai clic sull'icona Estensioni nella barra delle attività.

  2. Cerca google home, quindi fai clic su Installa.

    Google Home Extension Marketplace

Puoi anche scaricare il Google Home Extension direttamente da il VS Code Marketplace.

Scarica Google Home Extension

Configurare l'estensione Google Home per VS Code

Dopo aver installato Google Home Extension e ricaricato VS Code, dovrai accedere e selezionare un progetto prima di poter utilizzare Assistant Simulator e visualizzare Cloud Logging.

Accedere con Google e selezionare un progetto cloud

Puoi accedere al tuo account sviluppatore da Google Home Extension, autorizzando VS Code a comunicare con i servizi Google per tuo conto.

  1. Fai clic sull'icona Google Home nella barra delle attività per aprire Google Home Extension.

    Icona dell'estensione Google Home

  2. Fai clic su Accedi con Google per avviare la visualizzazione di accesso nel browser.

    Accesso a Google in VS Code

  3. Seleziona l'account collegato ai tuoi dispositivi per la smart home.

  4. Nella pagina di autorizzazione Accedi con Google, fai clic su Consenti.

  5. Si aprirà una scheda del browser e verrà visualizzata una finestra di dialogo Apri Visual Studio Code. Fai clic su Apri Visual Studio Code per continuare.

    Apri la finestra di dialogo di VS Code

  6. Verrà visualizzata la pagina di VS Code, dove è richiesta l'autorizzazione per consentire all'estensione Google Home di aprire un URI. Fai clic su Apri per completare la procedura di accesso.

    Consenti all'estensione Google Home di aprire un URI

  7. Dopo l'accesso, Google Home Extension caricherà i tuoi progetti. Al termine, fai clic su Seleziona un progetto.

    Seleziona un progetto

  8. Nella finestra a discesa Cerca e seleziona un progetto visualizzata, seleziona il tuo progetto per la smart home.

Installare lo strumento Android Debug Bridge (ADB)

Per visualizzare i log Matter su uno smartphone Android, devi installare ADB:

  1. Installa ADB sul computer.
  2. Attiva Opzioni sviluppatore e Debug USB sullo smartphone Android.

Installare gli strumenti SoC del dispositivo Matter

Per visualizzare i log di debug dei dispositivi Matter:

  1. La maggior parte dei SoC dei dispositivi esporta porte seriali come /dev/ttyUSBx su Linux o /dev/tty.SLAB_USBtoUART o /dev/tty.usbserial su macOS. LogViewer può leggere il log direttamente dal dispositivo.
  2. Alcuni tipi di SoC, come NXP o Silicon Labs, potrebbero richiedere l'installazione di strumenti esterni (ad esempio JLink). Per ulteriori informazioni, consulta Dispositivi supportati.

Utilizzare l'estensione Google Home per VS Code

Visualizzare le risorse per sviluppatori

In AIUTO E FEEDBACK, fai clic su Guida introduttiva e risorse per aprire la pagina Risorse, dove puoi trovare informazioni utili per lo sviluppo con l'ecosistema Google Home.

Risorse per l'ecosistema Google Home

Utilizzare il simulatore dell'Assistente Google

Per aprire Assistant Simulator in VS Code, fai clic su ASSISTENTE GOOGLE SIMULATORE nella barra laterale. Nella casella Messaggio, digita la query e premi Enter.

Puoi visualizzare le risposte Assistant Simulator e fare clic sul pulsante dopo la query per rinviarla.

Utilizzare il simulatore dell'Assistente Google

Eseguire espressioni batch

Passa il mouse sopra la barra del menu SIMULATORE DELL'ASSISTENTE GOOGLE e scegli una delle seguenti opzioni per configurare gli script:

  • Fai clic su per aprire gli script di espressioni esistenti.

  • Fai clic su per salvare la cronologia in uno script *.utterance.

    Icone del menu Utterances batch

Per iniziare a inviare espressioni batch, scegli una delle seguenti opzioni:

  • Fai clic su per selezionare uno script di espressioni dal menu a discesa.

  • Apri direttamente un file *.utterance e fai clic .

    Icona di esecuzione di Batch Utterances

Visualizzare Cloud Logging

In ACCESSO RAPIDO, fai clic su Log cloud per aprire la pagina Log cloud, dove puoi trovare i log appartenenti al progetto selezionato.

Utilizzare Cloud Logging

Gli utenti possono filtrare i log in base alla gravità e all'intervallo di tempo.

Filtrare i log per gravità e ora

Per impostazione predefinita, i log sono limitati a 50 righe. Se l'utente vuole visualizzare altri log, scorri verso il basso e fai clic su Altro per visualizzarli.

Visualizza altri log

Visualizzare Home Graph ed eseguire test

In ACCESSO RAPIDO , fai clic su Home Graph Viewer per aprire il riquadro Home Graph Viewer , dove puoi trovare i dispositivi appartenenti al progetto selezionato. Puoi anche fare clic su Esegui test per eseguire i test per il dispositivo.

Home Graph Viewer

Verrà avviata la suite di test nel browser con il dispositivo selezionato e pronto per il test. Fai clic su Avvia e attendi i risultati del test.

Suite di test di Google Home

Puoi controllare i dettagli del test e visualizzare i log al termine di tutti i test.

Risultati del test

Utilizzare l'estensione Google Home per il debug di Matter

Logging di Android

In STRUMENTI DI LOGGING DI MATTER, fai clic su Android Log per aprire la pagina Android Log, seleziona il Android telefono a cui vuoi connetterti e inizia a mostrare i log.

Registrazione di Android

Una volta connesso lo smartphone Android, potrai visualizzare i log riga per riga. Tieni presente che i log sono filtrati, il che significa che vengono visualizzati solo i log relativi al GHA e al Google Play services Matter modulo. Puoi anche impostare la gravità per filtrare i log o cercare la parola chiave nei log.

Android Logging Filtered

Logging del dispositivo Matter

In STRUMENTI DI LOGGING DI MATTER, fai clic su Log dispositivo per aprire la pagina Risorse, seleziona prima Tipo di SoC:

Logging dei dispositivi Matter

Quindi, seleziona il dispositivo Matter:

Registrazione dei dispositivi Matter seleziona dispositivo

A questo punto puoi recuperare tutti i log del dispositivo e utilizzare filtri come Gravità e Cerca per trovare le informazioni che ti interessano.

Logging filtrato dei dispositivi Matter

Scaricare tutti i log di Matter

In ACCESSO RAPIDO, fai clic su Scarica log per aprire la finestra di dialogo Scarica log , seleziona i log da scaricare e premi OK.

Scarica i log della pratica

Seleziona la cartella in cui scaricare i log e fai clic su Salva:

Salvataggio del log di Matter

I log verranno salvati nella cartella di destinazione:

Cartella di destinazione del log di Matter

Estrai il file ZIP salvato, che mostrerà le informazioni del dispositivo e i file di log.

File zip del log di Matter

Il file di informazioni del dispositivo includerà tutte le informazioni sulla versione necessarie per eseguire il debug dei problemi.

Debug del log di Matter

Inviare feedback

Per inviare i tuoi pensieri o feedback su come possiamo migliorare l'esperienza di sviluppo con Google Home Extension, scegli una delle seguenti opzioni:

  • Nel riquadro AIUTO E FEEDBACK, fai clic su Invia feedback per inviarci suggerimenti.
  • Nel riquadro AIUTO E FEEDBACK, fai clic su Segnala un problema per segnalare eventuali problemi riscontrati con Google Home Extension
Icona Invia feedback
  • Abbiamo anche fornito un'icona di feedback nella pagina Risorse.