Google Home Plugin per Android Studio

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

La pagina Google Home Plugin for Android Studio is designed and created for Google Home Platform developers. This plugin gives you access to Google Assistant Simulator , Cloud Logging, and other tools to simplify your smart home development process.

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 di sistema, quindi fai clic su Password.
  3. Seleziona Non salvare, elimina le password dopo il riavvio.
Plug-in Google Home per Android Studio

Funzionalità

Simulatore di 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.

Simile all'assistente esistente Simular fornito in Actions on Google Console Console, Assistant Simulator enables you to easily control your devices by typing your queries, for example, "Turn on the light." Inside Android Studio, Assistant Simulator responds back with text messages based on your commands, for example, "Alright, turning on the light."

Test con simulatore dell'assistente

Visualizza Cloud Logging

Google Cloud Logging fornisce informazioni di debug e metriche chiave per darti insight sull'utilizzo della tua azione. Per semplificare lo sviluppo, durante la risoluzione dei problemi Google Home Plugin visualizza i messaggi Cloud Logging in tempo reale accanto al tuo codice.

Puoi visualizzare i log in tempo reale o selezionare un intervallo di date.

Visualizzazione di Cloud Logging

Annunci in 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. Una volta salvato uno script, puoi raccogliere le risposte ed eseguire più test sulle tue query.

Visualizzatore grafico Home

Visualizzatore grafico Home ti consente di visualizzare lo stato dei tuoi dispositivi e di avviare la Google Test Suite nel tuo browser.

Installa

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

  1. Scarica o aggiorna Android Studio. Scarica Android Studio
  2. Vai a 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 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.

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

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

    Accedi con Google Studio per Android
  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 con l'opzione Esci.

Seleziona un progetto Cloud

Dopo aver effettuato l'accesso, seleziona un Progetto dal menu a discesa. Per filtrare l'elenco dei progetti, digita un'espressione 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 Android Studio.

Seleziona un progetto

Per assistenza con i filtri dei progetti, consulta Parametri delle query in Google Cloud Reference.

Usare il Simulatore dell'assistente

Per aprire il Assistant Simulator in Android Studio, fai clic su Utterance Panel nel riquadro Google Home Plugin.

Apri riquadro delle frasi

Esistono diversi modi per inviare query a Assistant Simulator. Quindi, esamineremo ogni opzione.

Inserire query e raccogliere 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 Riproduci di nuovo per eseguire nuovamente le query e controllare le risposte. Il riquadro Espressioni tiene traccia delle tue query e risposte in una cache memorizzata. Replay aggiunge solo nuove risposte a questa cache interna e non duplica le query ogni volta che fai clic sul pulsante.

Riscopri le frasi con il simulatore dell'assistente

Fai clic su Salva per salvare le query e le risposte che hai inserito nel riquadro Espressioni. Le tue interazioni vengono convertite in JSON nel seguente formato:

  • ask: la tua query.
  • answers: un array di possibili Assistant Simulator risposte.

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 enunciati per aprire i file JSON salvati in una nuova scheda. In Seleziona percorso, puoi scegliere un file o una cartella. Se scegli una cartella, le opzioni Raccogli e Test funzionano con tutte le frasi .json dei file.

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

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

Raccogli le frasi con il simulatore dell'assistente

Al termine dell'operazione Raccogli, la barra di stato si aggiorna con un segno di spunta verde di fronte al percorso .json e i file di pronuncia vengono completati con le possibili risposte.

Raccogli le 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.

Verifica 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 collettive, 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."

Esegui le frasi con l'Assistente simulatore

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

Esegui le frasi con l'Assistente simulatore

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.

Schede 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 di query di Logging.

Linguaggio di query di Cloud Logging

Ecco alcuni esempi di query QL 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 eseguire query sui log per data è facoltativo e può essere attivato 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 utilizzare i selettori di data 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/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 pubblicati. 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 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 Cloud Logging

Visualizza il grafico Home ed esegui test

Per elencare i tuoi dispositivi, seleziona Grafico Home 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ù Google Home Graph panels open for separate projects.

Una volta caricati i dispositivi, fai clic su qualsiasi record per espandere il payload JSON completo.

Payload JSON del grafico Home

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

Grafico Home Espandi e Comprimi JSON

Per avviare la Test Suite per un dispositivo specifico, fai clic su Test. La Test Suite viene avviata nel browser con il dispositivo selezionato e pronto per il test. Fai clic su Avvia e attendi i risultati del test.

Test di esecuzione del grafico a casa

Puoi controllare i dettagli del test e visualizzare i log una volta completati.

Test completati grafico Home

Risorse e feedback

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

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

Inviare feedback