Google Home Plugin for Android Studio è stato progettato e creato per Google Sviluppatori Google Home. Questo plug-in ti dà accesso Google Assistant Simulator, Cloud Logging e altri strumenti per semplificare il processo di sviluppo della smart home.
Avviso di sicurezza
Per impedire a Android Studio di archiviare secret password, completa i seguenti passaggi:
- Fai clic su File e poi su Impostazioni....
- Nella sezione Aspetto e Comportamento, espandi Impostazioni di sistema e fai clic su Password.
- Seleziona Non salvare, dimentica le password dopo il riavvio.
Funzionalità
Simulatore dell'assistente
Per verificare se i dispositivi per la smart home funzionano correttamente con Google Home dell'ecosistema, puoi interagire con Assistant Simulator in qualsiasi momento senza in uscita da Android Studio.
Simile all'assistente esistente Simulatore fornito nella console Actions on Google Console, Assistant Simulator ti consente per 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 alle tue dei comandi, ad esempio "Ok, accendo la luce".
Visualizza Cloud Logging
Google Cloud Logging fornisce informazioni di debug e metriche chiave per offrirti un quadro completo Utilizzo dell'azione. Per semplificare lo sviluppo, l'Google Home Plugin mostra messaggi Cloud Logging in tempo reale accanto al tuo codice durante risoluzione dei problemi.
Puoi visualizzare i log in tempo reale o selezionare un intervallo di date.
Pronuncia in batch
Le risposte Assistant Simulator a una singola frase non sono deterministici. Ad esempio, una risposta può essere una qualsiasi delle seguenti frasi:
- Ok, accendo due luci.
- Certo, accendo due luci.
- Ok, accendo due luci.
- Va bene, accendo due luci.
Per eseguire test automatici e verificare il funzionamento delle integrazioni di Google diverse risposte, puoi inviare enunciate in batch Assistant Simulator eseguendo script di espressioni. Una volta che uno script viene salvate, puoi raccogliere le risposte ed eseguire più test sulle tue query.
Visualizzatore Home Graph
Il visualizzatore Home Graph ti consente di per visualizzare lo stato dei dispositivi e avviare Test Suite di Google Home nel browser.
Visualizzatore log Android Debug Bridge (adb)
Adb Log Viewer è uno strumento per visualizzare e analizzare i file di log, ad esempio Matter file di log del dispositivo, log di Google Home e Android logaritmi.
Installa
Per installare Google Home Plugin in Android Studio, segui questi passaggi:
- Scarica o aggiorna Android Studio. Scarica Android Studio
- Vai su File > Impostazioni (Android Studio > Preferenze su macOS).
- Nella sezione plug-in, vai a Marketplace e cerca
google home. - Installa lo strumento e riavvia Android Studio.
Puoi anche scaricare il plug-in direttamente dal Marketplace di JetBrains.
Configurazione
Una volta installato il plug-in, dovrai completa i seguenti passaggi prima di poter usare Assistant Simulator e visualizza Cloud Logging:
Accedi con Google
Puoi accedere al tuo account sviluppatore dal pannello Google Home, autorizza Android Studio a comunicare con Google per conto tuo.
Fai clic sulla scheda Google Home nella colonna della scheda verticale a sinistra. lato della finestra Android Studio.
In Accedi con, fai clic su Google per aprire il browser.
Scegli l'account collegato ai tuoi dispositivi per la smart home.
Nella pagina delle autorizzazioni di 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, con l'opzione Esci.
Seleziona un progetto Cloud
Dopo aver effettuato l'accesso, seleziona un progetto dal menu a discesa. Per filtrare
nell'elenco di progetti, digita un'espressione Filtro, ad esempio matter, quindi premi
Enter.
Il menu a discesa Progetto carica i primi 100 progetti in base alla Filtra. Quando esci, le selezioni vengono conservate Android Studio.
Per assistenza sui filtri di progetto, consulta Parametri di query nel riferimento di Google Cloud.
Usa il Simulatore dell'assistente
Per aprire Assistant Simulator in Android Studio, fai clic sul riquadro Utterance dal riquadro Google Home Plugin.
Esistono diversi modi per inviare query all'Assistant Simulator. Poi, esamineremo ogni opzione.
Digita le query e raccogli le risposte
Per interagire con Assistant Simulator, digita la query e premi Invio.
Per inviare nuovamente una query, fai clic Icona di nuovo alla fine di la query.
Dopo aver inviato una o più query, fai clic su Gioca di nuovo per eseguire di nuovo e controllare le tue risposte. Il riquadro Enunciati tiene traccia dei tuoi query e risposte in una cache archiviata. Con Riproduci vengono aggiunte solo nuove risposte a cache interna e le query non verranno duplicate ogni volta che fai clic .
Fai clic su Salva per salvare le query e risposte inserite nel Riquadro Enunciati. Le tue interazioni vengono convertite in formato JSON nel seguente modo: formato:
ask: la tua query.answers: un array di possibili risposte 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."
]
}
]
}
Raccogliere risposte collettive
Nel riquadro Google Home Plugin, fai clic su File enunciati per aprirlo.
i file JSON salvati in una nuova scheda. In Seleziona percorso, puoi scegliere un
un file o una cartella. Se scegli una cartella, Raccogli e Test
lavorare su tutte le frasi .json file in quella cartella.
Puoi aprire più schede per lo stesso file o per file diversi, ad esempio
lights, lights(1) e plug.
La barra di stato mostra il risultato dell'ultimo test (se applicabile).
un puntino giallo o verde che indica se il file è stato raccolto e
dell'espressione .json. Dopo aver fatto clic
Raccogliere,
Assistant Simulator esegue le query.
Riceverai una notifica quando verrà raccolta una nuova risposta e la barra di stato
mostra un contatore durante l'elaborazione delle query.
Al termine Raccogli, la barra di stato si aggiorna con un segno di spunta verde.
all'inizio del percorso .json e i file di enunciato vengono compilati 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 sarà contrassegnato come
raccolte.
Testa frasi batch
Una volta raccolte le risposte, fai clic su Esegui test per riprodurre di nuovo le query e controllare le tue risposte e i tuoi log. Quando testi le espressioni in batch, Assistant Simulator prevede che le risposte vengano salvate nel tuo JSON . Se il test restituisce una risposta che non è stata raccolta, riceverai una notifica simile alla seguente risposta:
Expected one of: "Got it, turning on
2 lights."
Questo scenario indica un test non riuscito. In caso contrario, Assistant Simulator eseguirà ciascuna delle tue query e restituirà una risposta. Viene visualizzato un segno di spunta nella Barra di stato se il test è andato a buon fine.
Visualizza Cloud Logging
Per aprire una scheda del progetto nella finestra dello strumento Cloud Logs, fai clic su Log di Cloud dal riquadro Google Home Plugin. Puoi aprire schede separate di Cloud Log 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 in base a una parola chiave pari a light:
Seleziona Usa QL per utilizzare Linguaggio di query di Logging.
Ecco alcuni esempi di query QL per aiutarti a 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 l'esecuzione di query sui log per data è facoltativa e può essere abilitata facendo clic
After (Dopo) e Before. Puoi digitare il formato di data e ora nel testo
campo fornito, ad esempio 5/11/22, 12:37 PM, oppure puoi usare i selettori della data
per selezionare la data, poi inserisci 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 precedente al giorno
5/1/22, seleziona Prima e fai clic sulla data icona . - Per selezionare una data compresa tra
5/1/22e6/30/22, seleziona Prima e Dopo e scegli le date dall'icona della data .
Seleziona In tempo reale per recuperare i log del progetto in tempo reale. Fai clic su Interrompi per terminare una feed in tempo reale.
Livello di gravità
Puoi anche selezionare un'opzione Gravità minima dal menu a discesa.
Risultati delle query
Fai clic su Recupera per inviare i parametri della query.
Dopo aver caricato i log, fai clic su qualsiasi record per espandere Payload JSON. Fai di nuovo clic per visualizzare il messaggio completo.
Facoltativamente, puoi digitare una parola chiave nella casella Filtro per restringere il log.
che consentono di analizzare i dati
e visualizzare i risultati. Fai clic sulla x per rimuovere il filtro e tornare alla versione originale
per recuperare i risultati.
Visualizza Home Graph ed esegui test
Per elencare i dispositivi, seleziona Home Graph dalla Google Home Plugin.
Clic Aggiorna per visualizzare Nome dispositivo, ID dispositivo e Tipo di dispositivo per i tuoi dispositivi associati al progetto selezionato. Puoi avere più I riquadri Google Home Graph si aprono per progetti separati.
Dopo aver caricato i dispositivi, fai clic su un record per espandere Payload JSON.
Puoi anche utilizzare Espandi e Comprimi per visualizzare e nascondere il file JSON payload per i tuoi dispositivi.
Per avviare la Test Suite per un dispositivo specifico: fai clic su Test. La Test Suite viene avviata nel browser con dispositivo selezionato e pronto per il test. Fai clic su Avvia e attendi il completamento del test. che consentono di analizzare i dati e visualizzare i risultati.
Puoi controllare i dettagli dei test e visualizzare i log al termine dei test.
Visualizzatore log Android Debug Bridge (adb)
Per aprire una scheda del progetto nella finestra dello strumento Adb Log, fai clic sul comando Adb Log nella barra degli strumenti del plug-in di Google Home (a sinistra). Puoi aprire log ADB separato schede per ciascuno dei tuoi file di log. Per eliminare una scheda, fai clic sull'icona Icona di .
Utilizza il campo Seleziona per selezionare un componente di logging specifico da visualizzare e Menu a discesa Gravità per visualizzare solo le voci con la gravità di log corrispondente.
Per il log adb selezionato, puoi filtrare le voci di log utilizzando l'opzione Filtro campo con modificatori facoltativi sensibili alle maiuscole o Regex.
Inoltre, puoi:
- Per trovare voci specifiche, utilizza il campo Trova e i comandi Trova successivo (icona ) e Trova precedente (icona ).
- Usa i modificatori facoltativi sensibili alle maiuscole o Regex.
- Passa alla riga per passare a una riga specificata (per numero) nel log.
Seleziona Numero per visualizzare le righe di log con l'aggiunta di numeri di riga. Seleziona Raw. 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 inviare le tue opinioni o feedback su come possiamo migliorare lo sviluppo esperienza con Google Home Plugin, fai clic su Feedback.
