Google Home Plugin for Android Studio è progettato e creato per gli sviluppatori di Google Home Platform. Questo plug-in consente di accedere a Google Assistant Simulator, Cloud Logging e altri strumenti per semplificare il processo di sviluppo della tua smart home.
Avviso di sicurezza
Per impedire a Android Studio di archiviare secret e password, completa i seguenti passaggi:
- Fai clic su File e poi su Impostazioni....
- In Aspetto e comportamento, espandi Impostazioni di sistema, quindi fai clic su Password.
- Seleziona Non salvare, elimina le password dopo il riavvio.
Funzionalità
Simulatore dell'assistente
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 Android Studio.
Analogamente al simulatore esistente fornito nella console Actions on Google Console, Assistant Simulator ti consente di controllare facilmente i tuoi dispositivi digitando le tue query, ad esempio "Accendi la luce". All'interno di Android Studio, Assistant Simulator risponde con SMS in base ai tuoi comandi, ad esempio "Ok, accendo la luce".
Visualizza Cloud Logging
Google Cloud Logging fornisce informazioni di debug e metriche chiave per fornirti insight sull'utilizzo dell'azione. Per semplificare lo sviluppo, Google Home Plugin mostra i messaggi Cloud Logging in tempo reale accanto al codice durante la risoluzione dei problemi.
Puoi visualizzare i log in tempo reale o selezionare un intervallo di date.
Espressioni batch
Le risposte Assistant Simulator a una singola espressione non sono deterministiche. Ad esempio, una risposta potrebbe essere una delle seguenti frasi:
- Ok, accendo due luci.
- Certo, accendo due luci.
- Ok, accendo due luci.
- Ok, accendo due luci.
Per eseguire test automatici e verificare come funzionano le integrazioni di Google con queste varie risposte, puoi inviare frasi collettive a Assistant Simulator eseguendo script di enunciati. Dopo aver salvato uno script, puoi raccogliere le risposte ed eseguire più test sulle tue query.
Visualizzatore grafico Home
Il Visualizzatore del grafico Home ti consente di visualizzare lo stato dei dispositivi e avviare la Suite di test di Google Home nel browser.
Visualizzatore log Android Debug Bridge (adb)
Il visualizzatore log di AdMob è uno strumento per visualizzare e analizzare i file di log, ad esempio file di log del dispositivo Matter, log di Google Home e log Android.
Installa
Per installare Google Home Plugin in Android Studio, segui questi passaggi:
- Scarica o aggiorna Android Studio. Scarica Android Studio
- Vai a File > Impostazioni (Android Studio > Preferenze su macOS).
- Nella sezione Plugin, vai a Marketplace e cerca
google home. - Installa lo strumento e riavvia Android Studio.
Puoi anche scaricare il plug-in direttamente da JetBrains Marketplace.
Configurazione
Dopo aver installato il plug-in, devi completare i seguenti passaggi prima di poter utilizzare Assistant Simulator e visualizzare Cloud Logging:
Accedi con Google
Puoi accedere al tuo account sviluppatore dal riquadro Google Home, autorizzando Android Studio a comunicare con i servizi Google per tuo conto.
Fai clic sulla scheda Google Home nella colonna della scheda verticale sul lato sinistro della finestra Android Studio.
In Accedi con, fai clic su Google per avviare il browser.
Scegli l'account collegato ai tuoi dispositivi per la smart home.
Nella pagina di autorizzazione Accedi con Google, fai clic su Consenti.
Chiudi la finestra del browser e torna a Android Studio.
A questo punto, dovresti aver eseguito l'accesso e l'opzione per disconnetterti.
Seleziona un progetto Cloud
Dopo aver eseguito l'accesso, seleziona un progetto dal menu a discesa. Per filtrare l'elenco di progetti, digita un'espressione di Filtro, ad esempio matter, quindi premi Enter.
Il menu a discesa Progetto carica i primi 100 progetti in base al tuo Filtro. Le selezioni vengono mantenute quando esci da Android Studio.
Per assistenza con i filtri del progetto, consulta Parametri di ricerca in Riferimento Google Cloud.
Usare il Simulatore dell'assistente
Per aprire il Assistant Simulator in Android Studio, fai clic su Riquadro delle espressioni nel riquadro Google Home Plugin.
Esistono diversi modi per inviare query a Assistant Simulator. Quindi, vedremo le opzioni.
Digita le query e raccogli le risposte
Per interagire con Assistant Simulator, digita la query e premi Invio.
Puoi inviare nuovamente una query facendo clic sull'icona Invia di nuovo alla fine della query.
Dopo aver inviato una o più query, fai clic su Riproduzione per eseguire nuovamente le query e controllare le risposte. Il riquadro Emissioni tiene traccia delle query e delle risposte in una cache archiviata. La riproduzione aggiunge nuove risposte alla cache interna e non duplica le query ogni volta che fai clic sul pulsante.
Fai clic su Salva per salvare le query e le risposte che hai inserito nel riquadro Urgenze. Le interazioni vengono convertite in JSON nel seguente formato:
ask: la query.answers: un array di possibili risposte con Assistant Simulator.
Puoi modificare questo file JSON in Android Studio.
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
Raccogli risposte in batch
Nel riquadro Google Home Plugin, fai clic su File espressioni per aprire i file JSON salvati in una nuova scheda. Per Seleziona percorso, puoi scegliere un file o una cartella. Se scegli una cartella, Raccogli e Prova funzioneranno su tutte le frasi .json file al suo interno.
Puoi aprire più schede per lo stesso file o file diversi, ad esempio lights, lights(1) e plug.
La barra di stato mostra i risultati dell'ultimo test (se applicabile), un punto giallo o verde per indicare se il file è stato raccolto e il percorso file .json. Dopo aver fatto clic su
Raccogli,
il Assistant Simulator esegue le tue query.
Riceverai una notifica quando viene raccolta una nuova risposta e la barra di stato mostra un contatore durante l'elaborazione delle query.
Al termine della procedura collect, la barra di stato si aggiorna con un segno di spunta verde davanti al percorso .json e i file di frasi vengono completati con possibili risposte.
{
"collected": true,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights.",
"Sure, turning 2 lights on.",
"Got it, turning 2 lights on.",
"Alright, turning on 2 lights.",
"OK, turning on 2 lights.",
"Got it, turning on 2 lights.",
"Alright, turning 2 lights on."
]
}
]
}
Se interrompi la raccolta in anticipo, il percorso .json non verrà contrassegnato come
raccolto.
Testare le frasi batch
Dopo aver raccolto le risposte, fai clic su Test per riprodurre le query e controllare le risposte e i log. Quando testi le frasi in batch, Assistant Simulator prevede che le risposte vengano salvate nel file JSON. Se il test restituisce una risposta che non è stata raccolta, riceverai una notifica simile alla seguente:
Expected one of: "Got it, turning on
2 lights."
Questo scenario indica un test non riuscito. In caso contrario, Assistant Simulator eseguirà tutte le tue query e restituirà una risposta. Un controllo viene visualizzato nella barra di stato se il test ha esito positivo.
Visualizza Cloud Logging
Per aprire una scheda del progetto nella finestra dello strumento Cloud Logging, fai clic su Cloud Logs dal riquadro Google Home Plugin. Puoi aprire schede Cloud Log separate per ciascuno dei tuoi progetti.
Termini di ricerca
Per il progetto selezionato, puoi anche filtrare i log utilizzando il campo Query.
Ad esempio, per filtrare i log per una parola chiave di light:
Seleziona Utilizza QL per utilizzare il linguaggio di query di Logging.
Ecco alcuni esempi di query QL utili per iniziare:
severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"
Query su data e ora
Anche i log delle query per data sono facoltativi e possono essere attivati facendo clic su Dopo e Prima. Puoi digitare la data e l'ora nel campo di testo fornito, ad esempio 5/11/22, 12:37 PM, oppure utilizzare i selettori delle date
per selezionare la data, quindi inserire l'ora nel campo di testo.
- Per selezionare una data successiva al giorno
5/1/22, seleziona Dopo e fai clic sull'icona della data . - Per selezionare una data antecedente al giorno
5/1/22, seleziona Prima e fai clic sull'icona della data . - Per selezionare una data compresa tra
5/1/22e6/30/22, seleziona Prima e Dopo e scegli le date dall'icona delle date .
Seleziona In tempo reale per recuperare i log del progetto in tempo reale. Fai clic su Interrompi per terminare un feed in tempo reale.
Livello di gravità
Puoi anche selezionare un livello di gravità minima dal menu a discesa.
Risultati delle query
Fai clic su Recupera per inviare i parametri di ricerca.
Una volta caricati i log, fai clic su qualsiasi record per espandere il payload JSON completo. Fai di nuovo clic su per visualizzare il messaggio completo.
Facoltativamente, puoi digitare una parola chiave nella casella Filtro per restringere i risultati del log. Fai clic su x per rimuovere il filtro e tornare ai risultati di recupero originali.
Visualizza il grafico Home ed esegui test
Per elencare i dispositivi, seleziona Grafico a casa dal riquadro Google Home Plugin.
Fai clic su Aggiorna per visualizzare Nome dispositivo, ID dispositivo e Tipo di dispositivo per i dispositivi associati al progetto selezionato. Puoi avere più riquadri Google Home Graph aperti per progetti separati.
Una volta caricati i dispositivi, fai clic su un record per espandere il payload JSON completo.
Puoi anche usare le opzioni Espandi e Comprimi per visualizzare e nascondere i payload JSON per i tuoi dispositivi.
Per avviare la Test Suite per un dispositivo specifico, fai clic su Test. Viene avviata la Test Suite nel browser con il dispositivo selezionato e pronto per il test. Fai clic su Avvia e attendi i risultati del test.
Al termine dei test, puoi esaminare i dettagli e visualizzare i log.
Visualizzatore log Android Debug Bridge (adb)
Per aprire una scheda del progetto nella finestra dello strumento Log di AdMob, fai clic sul comando Log Adb nella barra degli strumenti del plug-in di Google Home (a sinistra). Puoi aprire schede di log Adb separate per ciascuno dei tuoi file di log. Per eliminare una scheda, fai clic sull'icona .
Utilizza il campo Seleziona per selezionare un componente di logging specifico da visualizzare e il menu a discesa Gravità per visualizzare solo le voci con la gravità del log corrispondente.
Per il log adb selezionato, puoi filtrare le voci di log utilizzando il campo Filtro con i modificatori facoltativi del campo Sensibile alle maiuscole o Regex.
Inoltre, puoi:
- Trova voci specifiche utilizzando il campo Trova e i comandi Trova successivo (icona ) e Trova precedente (icona ).
- Utilizza i modificatori facoltativi del test sensibile alle maiuscole o del regex.
- Vai alla riga per passare a una riga specificata (per numero) nel log.
Seleziona Numerati per visualizzare le righe dei log con i numeri di riga aggiunti. Seleziona Grezzo per visualizzare le voci di log non elaborate.
Risorse e feedback
Fai clic su Risorse per un elenco di strumenti e risorse per sviluppatori.
Per darci la tua opinione o fare un feedback su come possiamo migliorare l'esperienza di sviluppo con la Google Home Plugin, fai clic su Feedback.
