Matter Da cloud a cloud SDK Local Home SDK per dispositivi
Google Home Extension for Visual Studio Code è stato progettato e creato per gli sviluppatori della piattaforma Google Home. Questa estensione ti dà accesso a Google Assistant Simulator, Google Cloud Logging, Visualizzatore Home Graph e altri strumenti per semplificare il tuo processo di sviluppo della smart home e Matter.
![Estensione Google Home per VS Code](https://developers.home.google.com/static/tools/images/google-home-extension-overview.png?authuser=2&hl=it)
Funzionalità dell'estensione 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.
Analogamente al Simulatore esistente fornito nella console di Actions, Assistant Simulator ti consente di controllare facilmente i tuoi dispositivi digitando le tue query, ad esempio "Accendi la luce". All'interno di VS Code, Assistant Simulator risponde con messaggi in base ai tuoi comandi, ad esempio "Ok, accendo la luce". Per ulteriori dettagli, vedi Usa il Simulatore dell'Assistente Google.
Pronuncia in batch
Per testare l'integrazione di Google Home come un automa, puoi inviare enunciati batch al Simulatore dell'Assistente Google eseguendo uno script di enunciati. Per ulteriori dettagli, consulta Eseguire frasi batch.
Strumenti di registrazione delle pratiche
Gli strumenti di registrazione Matter possono raccogliere tutti i log relativi al debug di Matter, inclusi i log Google Home app (GHA) e i log di Google Play Services (GMS Core). I log possono essere visualizzati su VS Code con ricerche di filtri e parole chiave. Puoi scaricare i log con ulteriori informazioni di debug, come Android e versione dell'app, e inviarli a Google per segnalare problemi.
![Registrazione delle pratiche nelle estensioni di Google Home](https://developers.home.google.com/static/tools/images/google-home-extension-matter-logging.png?authuser=2&hl=it)
Cloud Logging
Cloud Logging fornisce informazioni di debug e metriche chiave per darti insight sull'utilizzo dell'azione. Per semplificare lo sviluppo, l'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.
Visualizzatore Home Graph
Il visualizzatore Home Graph è 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 Visualizza l'home Graph ed esegui test.
Installa l'estensione Google Home per VS Code
Per installare Google Home Extension, segui questi passaggi da VS Code:
- Fai clic sull'icona Estensioni nella barra delle attività.
Cerca
google home
, poi fai clic su Installa.
Puoi anche scaricare Google Home Extension direttamente da VS Code Marketplace.
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.
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.
Fai clic sull'icona di Google Home nella barra delle attività per aprire Google Home Extension.
Fai clic su Accedi con Google per avviare la visualizzazione di accesso nel browser.
Seleziona l'account collegato ai tuoi dispositivi per la smart home.
Nella pagina delle autorizzazioni di Accedi con Google, fai clic su Consenti.
Viene visualizzata una scheda del browser e viene visualizzata la finestra di dialogo Apri codice Visual Studio. Per continuare, fai clic su Apri Visual Studio Code.
Si aprirà VS Code, dove è necessaria la tua autorizzazione per consentire all'estensione Google Home di aprire un URI. Fai clic su Apri per completare la procedura di accesso.
Dopo l'accesso, Google Home Extension caricherà i tuoi progetti. Al termine, fai clic su Seleziona un progetto.
Nella finestra a discesa Cerca e seleziona un progetto che viene visualizzata, seleziona il progetto per la smart home.
Installa lo strumento Android Debug Bridge (ADB)
Per visualizzare i log di Matter su un telefono Android, devi installare ADB:
- Installa ADB sul tuo computer.
- Attiva le Opzioni sviluppatore e Debug USB sul tuo smartphone Android.
Installa gli strumenti SoC del dispositivo Matter
Per visualizzare i log di debug da Matter dispositivi:
- La maggior parte dei SoC dei dispositivi esporta le 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. - Alcuni tipi di SoC, come NXP o Silicon Labs, potrebbero richiedere l'installazione di strumenti esterni (ad esempio JLink). Per ulteriori informazioni, vedi Dispositivi supportati.
Usa 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, in cui puoi trovare informazioni utili per lo sviluppo dell'ecosistema Google Home.
![Risorse per l'ecosistema di Google Home](https://developers.home.google.com/static/tools/images/google-home-extension-resources.png?authuser=2&hl=it)
Usa il Simulatore dell'Assistente Google
Per aprire Assistant Simulator in VS Code, fai clic su SIMULATORI ASSISTENTE GOOGLE nella barra laterale. Nella casella Messaggio, digita la query e premi Enter
.
Puoi visualizzare Assistant Simulator risposte, quindi fare clic sul pulsante dopo la query per inviarla di nuovo.
![Usa il Simulatore dell'Assistente Google](https://developers.home.google.com/static/tools/images/google-home-extension-assistant-resend.png?authuser=2&hl=it)
Esegui espressioni batch
Passa il mouse sulla barra dei menu GOOGLE ASSISTANT SIMULATOR e scegli una delle seguenti opzioni per impostare gli script:
Fai clic su
per aprire gli script enunciati esistenti.Fai clic su
per salvare la cronologia in uno script*.utterance
.
Per iniziare a inviare frasi batch, scegli una delle seguenti opzioni:
- Fai clic su per selezionare uno script enunciato dalla finestra a discesa.
Apri direttamente un file
*.utterance
e fai clic su .
Visualizza Cloud Logging
In ACCESSO RAPIDO, fai clic su Log di Cloud per aprire la pagina Log di Cloud, dove puoi trovare i log appartenenti al progetto selezionato.
![Usa Cloud Logging](https://developers.home.google.com/static/tools/images/google-home-extension-cloud-logging.png?authuser=2&hl=it)
Gli utenti possono filtrare i log in base alla gravità e all'intervallo di tempo.
![Filtra i log per gravità e ora](https://developers.home.google.com/static/tools/images/google-home-extension-filter-logs.png?authuser=2&hl=it)
Per impostazione predefinita, i log sono limitati a 50 righe. Per visualizzare altri log, scorri fino in fondo e fai clic su Altro per visualizzare altri log.
![Visualizza altri log](https://developers.home.google.com/static/tools/images/google-home-extension-logs-rows.png?authuser=2&hl=it)
Visualizza Home Graph ed esegui test
In ACCESSO RAPIDO, fai clic su Visualizzatore di Home Graph per aprire il riquadro Visualizzatore di Home Graph, in cui puoi trovare i dispositivi che appartengono al progetto selezionato. Puoi anche fare clic su Esegui test per eseguire test per il dispositivo.
![Visualizzatore Home Graph](https://developers.home.google.com/static/tools/images/google-home-extension-home-graph-viewer.png?authuser=2&hl=it)
La suite di test verrà avviata nel browser con il dispositivo selezionato e pronto per il test. Fai clic su Avvia e attendi i risultati del test.
Puoi consultare i dettagli dei test e visualizzare i log al termine di tutti i test.
![Risultati del test](https://developers.home.google.com/static/tools/images/google-home-extension-test-results.png?authuser=2&hl=it)
Utilizzare l'estensione Google Home per il debug di Matter
Registrazione Android
In STRUMENTI DI REGISTRAZIONE DEI MATTER, fai clic su Android Log per aprire la pagina Android Log, seleziona lo smartphone Android a cui vuoi connetterti e inizia a mostrare i log.
![Registrazione Android](https://developers.home.google.com/static/tools/images/google-home-extension-android-logging.png?authuser=2&hl=it)
Dopo aver connesso lo smartphone Android, potrai visualizzare i log riga per riga. Tieni presente che i log vengono filtrati, il che significa che vengono visualizzati solo i log relativi a GHA e al modulo Matter di Google Play services. Puoi anche impostare Gravità per filtrare i log o cercare la parola chiave nei log.
![Android Logging filtrato](https://developers.home.google.com/static/tools/images/google-home-extension-android-logging-filtered.png?authuser=2&hl=it)
Registrazione dei dispositivi Matter
In STRUMENTI DI REGISTRAZIONE DEI MATTER, fai clic su Log dei dispositivi per aprire la pagina Risorse, quindi seleziona prima Tipo di SoC:
![Logging dei dispositivi Matter](https://developers.home.google.com/static/tools/images/google-home-extension-matter-device-logging.png?authuser=2&hl=it)
Quindi, seleziona il dispositivo Matter:
![Dispositivo Matter selezionato per il logging](https://developers.home.google.com/static/tools/images/google-home-extension-matter-device-logging-select.png?authuser=2&hl=it)
In seguito potrai recuperare tutti i log del dispositivo e utilizzare filtri come Gravità e Ricerca per trovare le informazioni che ti interessano.
![Logging filtrato del dispositivo Matter](https://developers.home.google.com/static/tools/images/google-home-extension-matter-device-logging-filtered.png?authuser=2&hl=it)
Scarica 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 di Matter](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs.png?authuser=2&hl=it)
Seleziona la cartella in cui scaricare i log e fai clic su Salva:
![Salvataggio log Matter](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs-save.png?authuser=2&hl=it)
Quindi i log verranno salvati nella cartella di destinazione:
![Cartella di destinazione del log delle pratiche](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs-dest.png?authuser=2&hl=it)
Estrai il file ZIP salvato: verranno visualizzate le informazioni sul dispositivo e i file di log.
![File ZIP del log Matter](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs-zip.png?authuser=2&hl=it)
Il file con le informazioni sul dispositivo includerà tutte le informazioni sulla versione necessarie per il debug dei problemi.
![Debug log Matter](https://developers.home.google.com/static/tools/images/google-home-extension-download-matter-logs-debug.png?authuser=2&hl=it)
Invia feedback
Per inviare la tua opinione o feedback su come possiamo migliorare l'esperienza di sviluppo con Google Home Extension, scegli tra le seguenti opzioni:
- Nel riquadro GUIDA E FEEDBACK, fai clic su Invia feedback per fornirci suggerimenti.
- Nel riquadro GUIDA E FEEDBACK, fai clic su Segnala problema per segnalare il problema riscontrato con Google Home Extension.
![Icona Invia feedback](https://developers.home.google.com/static/tools/images/google-home-extension-feedback.png?authuser=2&hl=it)
- Abbiamo fornito anche un'icona per il feedback nella pagina Risorse.