Estensione Google Home per codice VS

Matter    Cloud-to-cloud    SDK Local Home    SDK per dispositivi

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

Funzionalità delle estensioni di 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 basati sui tuoi comandi, ad esempio "Ok, accendo la luce". Per maggiori dettagli, consulta Utilizzare il simulatore dell'Assistente Google.

Frasi batch

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

Strumenti di logging Matter

Gli strumenti di logging Matter possono raccogliere tutti i log relativi al debug di Matter, inclusi i log di Matter e di Google Play Services (GMS Core).Google Home app (GHA) I log possono essere visualizzati in VS Code con ricerche di filtri e 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.

Cloud Logging

Cloud Logging fornisce informazioni di debug e metriche chiave per fornirti approfondimenti sull'utilizzo della tua azione. Per semplificare lo sviluppo, Google Home Extension mostra i messaggi di Google Cloud Logging in tempo reale proprio 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, in modo da poter verificare lo stato del dispositivo nel tuo Home Graph all'interno di VS Code. Per ulteriori dettagli, consulta la sezione Visualizzare il grafico della casa 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.

   

Puoi anche scaricare Google Home Extension direttamente dal marketplace di VS Code.

Scarica Google Home Extension

Configurare l'estensione Google Home per VS Code

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

Accedi con Google e seleziona 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 aprireGoogle Home Extension.

   

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

   

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.

   

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

   

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

   

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

Installa lo strumento Android Debug Bridge (ADB)

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

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

Installa gli strumenti SoC per i dispositivi 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

Visualizza Risorse per sviluppatori

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

Utilizzare il simulatore dell'Assistente Google

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

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

Esegui frasi batch

Passa il mouse sopra la barra dei menu di GOOGLE ASSISTANT SIMULATOR e scegli tra le seguenti opzioni per configurare gli script:

• Fai clic su file_upload per aprire gli script di frasi esistenti.

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

  

Per iniziare a inviare frasi collettive, scegli una delle seguenti opzioni:

• Fai clic su play_arrow per selezionare un script di frase dalla finestra a discesa.

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

  

Visualizza Cloud Logging

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

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

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.

Visualizza grafico della casa ed esegui test

In ACCESSO RAPIDO, fai clic su Visualizzatore grafico della casa per aprire il riquadro Visualizzatore grafico della casa, in cui puoi trovare i dispositivi appartenenti al progetto selezionato. Puoi anche fare clic su Esegui test per eseguire test per il dispositivo.

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.

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

Utilizzare l'estensione Google Home per il debug di Matter

Log di Android

In STRUMENTI DI LOG DI MATTER, fai clic su Android Log per aprire la pagina Android Log, seleziona lo smartphone Android a cui vuoi connetterti e inizia a visualizzare i log.

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 a GHA e al modulo Google Play services Matter. Puoi anche impostare Gravità per filtrare i log o Cerca la parola chiave nei log.

Logging dei dispositivi Matter

In MATTER LOGGING TOOLS (STRUMENTI DI LOG DI MATTER), fai clic su Device Logs (Log dispositivo) per aprire la pagina Resources (Risorse), poi seleziona SoC Type (Tipo di SoC):

Quindi, seleziona il dispositivo Matter:

Puoi quindi recuperare tutti i log del dispositivo e utilizzare filtri come Gravità e Ricerca per trovare le informazioni che ti interessano.

Scarica tutti i log 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.

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

I log verranno salvati nella cartella di destinazione:

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

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

Invia feedback

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

• Nel riquadro GUIDA E FEEDBACK, fai clic su Fornisci feedback per inviarci i tuoi suggerimenti.
• Nel riquadro GUIDA E FEEDBACK, fai clic su Segnala un problema per segnalare qualsiasi problema riscontrato con Google Home Extension

• Abbiamo anche fornito un'icona per i feedback nella pagina Risorse.