Google Home Plugin per Android Studio

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 smart home.

Plug-in Google Home per Android Studio

Avviso di sicurezza

Per impedire a Android Studio di archiviare secret e password, completa i seguenti passaggi:

  1. Fai clic su File e poi su Impostazioni....
  2. In Aspetto e comportamento, espandi Impostazioni del sistema e fai clic su Password.
  3. Seleziona Non salvare, dimentica le password dopo il riavvio.
Plug-in Google Home per Android Studio

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 dell'assistente esistente fornito nella console Actions on Google Console, Assistant Simulator consente di controllare facilmente i dispositivi digitando le query, ad esempio "Accendi la luce". All'interno di Android Studio, Assistant Simulator risponde con messaggi di testo basati sui tuoi comandi, ad esempio "Ok, accendo la luce".

Esegui test con il simulatore dell'assistente

Visualizza Cloud Logging

Google Cloud Logging fornisce informazioni di debug e metriche chiave per informazioni dettagliate sull'utilizzo dell'Azione. Per semplificare lo sviluppo, l'Google Home Plugin mostra 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.

Visualizzazione Cloud Logging

Enunciati in batch

Le risposte Assistant Simulator a una singola frase 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.
  • Va bene, accendo due luci.

Per eseguire test automatici e verificare il funzionamento delle integrazioni di Google con queste varie risposte, puoi inviare espressioni batch a Assistant Simulator eseguendo script di frasi. Una volta salvato uno script, puoi raccogliere le risposte ed eseguire più test sulle tue query.

Visualizzatore Home Graph

Home Graph Viewer ti consente di visualizzare lo stato dei tuoi dispositivi e di avviare la Test Suite di Google Home nel browser.

Visualizzatore log Android Debug Bridge (adb)

Il visualizzatore log Adb è uno strumento per visualizzare e analizzare i file di log, ad esempio i file di log di Matter dispositivi, i log di Google Home e i log di Android.

Installa

Per installare Google Home Plugin in Android Studio, segui questi passaggi:

  1. Scarica o aggiorna Android Studio. Scarica Android Studio
  2. Seleziona File > Impostazioni (Android Studio > Preferenze su MacOS).
  3. Nella sezione Plugin, vai a Marketplace e cerca google home.
  4. Installa lo strumento e riavvia Android Studio.

Puoi anche scaricare il plug-in direttamente dal JetBrains Marketplace.

Configurazione

Una volta installato il plug-in, dovrai completare i seguenti passaggi prima di poter utilizzare Assistant Simulator e visualizzare Cloud Logging:

Accedi con Google

Puoi accedere al tuo account sviluppatore dal pannello Google Home, autorizzando Android Studio a comunicare con i servizi Google per tuo conto.

  1. Fai clic sulla scheda Home page di Google nella colonna verticale della scheda sul lato sinistro della finestra di Android Studio.

  2. Per Accedi con, fai clic su Google per avviare il browser.

    Accedi ad Android Studio con Google
  3. Scegli l'account collegato ai tuoi dispositivi per la smart home.

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

  5. Chiudi la finestra del browser e torna a Android Studio.

A questo punto dovresti aver eseguito l'accesso e dovresti visualizzare l'opzione Esci.

Seleziona un progetto Cloud

Dopo l'accesso, seleziona un Progetto dal menu a discesa. Per filtrare l'elenco dei progetti, digita un'espressione Filter, ad esempio matter, quindi premi Enter.

Il menu a discesa Progetto carica i primi 100 progetti in base al tuo filtro. Le selezioni vengono conservate quando esci da Android Studio.

Seleziona un progetto

Per assistenza con i filtri di progetto, consulta Parametri di query nel riferimento di Google Cloud.

Usare il simulatore dell'assistente

Per aprire Assistant Simulator in Android Studio, fai clic sul riquadro delle espressioni nel riquadro Google Home Plugin.

Apri il riquadro delle frasi

Esistono diversi modi per inviare query al Assistant Simulator. Esamineremo ciascuna opzione.

Digitare query e raccogliere risposte

Per interagire con Assistant Simulator, digita la query e premi Invio.

Puoi inviare nuovamente una query facendo clic sull'icona di nuovo alla fine della query.

Dopo aver inviato una o più query, fai clic su Ripeti per eseguire nuovamente le query e controllare le risposte. Il riquadro Espressioni tiene traccia delle query e delle risposte in una cache memorizzata. Ripeti solo aggiunge nuove risposte a questa cache interna e non duplica le query ogni volta che fai clic sul pulsante.

Riproduci nuovamente le enunciati con il simulatore dell'assistente

Fai clic su Salva per salvare le query e le risposte inserite nel riquadro Espressioni. Le interazioni vengono convertite in JSON nel seguente 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 in blocco

Nel riquadro Google Home Plugin, fai clic su File delle 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 Test funzioneranno per tutte le frasi .json file nella cartella.

Puoi aprire più schede per lo stesso file o file diversi, ad esempio lights, lights(1) e plug.

La barra di stato mostra il risultato dell'ultimo test (se applicabile), un punto giallo o verde che indica se il file è stato raccolto e il percorso file .json dell'espressione. Dopo aver fatto clic su Raccogli, Assistant Simulator esegue le query. Riceverai una notifica quando viene raccolta una nuova risposta e la barra di stato mostra un contatore durante l'elaborazione delle query.

Raccogli frasi con il simulatore dell'assistente

Al completamento di Raccogli, la barra di stato si aggiorna con un segno di spunta verde davanti al percorso .json e i file delle frasi vengono completati con le possibili risposte.

Raccogli frasi con il simulatore dell'assistente
{
  "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.

Testa enunciati batch

Dopo aver raccolto le risposte, fai clic su Test per riprodurre le query e controllare le risposte e i log. Quando testi le espressioni 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 risposta:

Expected one of: "Got it, turning on 2 lights."

Esegui le espressioni con il simulatore dell'assistente

Questo scenario indica un test non riuscito. In caso contrario, Assistant Simulator eseguirà ogni query e restituirà una risposta. Un controllo viene visualizzato nella barra di stato se il test ha avuto esito positivo.

Esegui le espressioni con il simulatore dell'assistente

Visualizza Cloud Logging

Per aprire la scheda di un progetto nella finestra dello strumento Cloud Logs, fai clic su Cloud Logs nel riquadro Google Home Plugin. Puoi aprire schede di Cloud Log separate per ciascuno dei tuoi progetti.

Schede di Cloud Logging

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:

Query di Cloud Logging

Seleziona Utilizza QL per utilizzare il linguaggio delle query di Logging.

Linguaggio di query di Cloud 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 l'esecuzione di query sui log per data è facoltativa e può essere abilitata facendo clic su Dopo e Prima. Puoi digitare il formato di data e ora nel campo di testo fornito, ad esempio 5/11/22, 12:37 PM, oppure puoi utilizzare i selettori della data per selezionare la data e poi 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 precedente al giorno 5/1/22, seleziona Prima e fai clic sull'icona della data .
  • Per selezionare una data compresa tra 5/1/22 e 6/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 un feed in tempo reale.

Livello di gravità

Puoi anche selezionare una 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 un record per espandere l'intero payload JSON. Fai di nuovo clic per visualizzare il messaggio completo.

Se vuoi, puoi digitare una parola chiave nella casella Filtro per restringere i risultati del log. Fai clic sulla x per rimuovere il filtro e tornare ai risultati di recupero originali.

Visualizza Cloud Logging

Visualizza Home Graph ed esegui test

Per elencare i tuoi dispositivi, seleziona Home Graph nel riquadro Google Home Plugin.

Fai clic su Aggiorna per visualizzare il nome, l'ID dispositivo e il tipo di dispositivo relativi ai dispositivi associati al progetto selezionato. Puoi aprire più riquadri Google Home Graph per progetti separati.

Dopo aver caricato i dispositivi, fai clic su un record per espandere l'intero payload JSON.

Payload JSON Home Graph

Puoi anche utilizzare Espandi e Comprimi per visualizzare e nascondere i payload JSON per i tuoi dispositivi.

Espandi e comprimi JSON Home Graph

Per avviare il Test Suite per un dispositivo specifico, fai clic su Test. In questo modo 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.

Test esecuzione Home Graph

Una volta completati, puoi controllare i dettagli del test e visualizzare i log.

Test completati Home Graph

Visualizzatore log Android Debug Bridge (adb)

Per aprire la scheda di un progetto nella finestra dello strumento Log Adb, fai clic sul comando Log Adb nella barra degli strumenti del plug-in di Google Home (a sinistra). Puoi aprire schede separate per ogni 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 modificatori facoltativi sensibili alle maiuscole o Regex.

Inoltre, puoi:

  • Puoi trovare voci specifiche utilizzando il campo Trova e i comandi Trova successivo (icona ) e Trova precedente (icona ).
  • Utilizza i modificatori facoltativi sensibili alle maiuscole o alle regex.
  • Vai alla riga per passare a una riga specificata (in base al numero) nel log.

Seleziona Numero per visualizzare le righe del log con i numeri di riga aggiunti. Seleziona Raw per visualizzare le voci di log non elaborate.

Visualizzatore log ADB

Risorse e feedback

Fai clic su Risorse per visualizzare un elenco di risorse e strumenti per sviluppatori.

Per inviare la tua opinione o inviare un feedback su come possiamo migliorare l'esperienza di sviluppo con Google Home Plugin, fai clic su Feedback.

Invia feedback