Google Home Playground

Il Google Home Playground è un'applicazione web che simula un progetto di smart home con tipi e trait di dispositivi configurabili. Puoi creare dispositivi virtuali , modificare gli attributi e gli stati dei dispositivi, visualizzare questi dispositivi in Google Home Graph e importare o esportare le configurazioni dei dispositivi.

Completa il collegamento dell'account

Per utilizzare Google Home Playground, ti consigliamo di collegare prima lo strumento al tuo account. Apri l'Google Home app (GHA) sullo smartphone e segui la procedura di collegamento dell'account descritta in Connetti dispositivi per la smart home di terze parti nell'app Google Home.

  1. Cerca l'integrazione denominata Google Home Playground.
  2. Seleziona l'integrazione e il GHA ti indirizzerà a la pagina di accesso. Fai clic su Accedi con Google e seleziona il tuo account per accedere.
  3. Fai clic sul pulsante Autorizza per autorizzare il collegamento dell'account.
Questa figura mostra il flusso di collegamento dell'account dell'app Google Home per
            collegare Google Home Playground.

Una volta completato il collegamento dell'account, nell'app Google Home verrà visualizzato un insieme di dispositivi virtuali predefiniti con cui potrai interagire su GHA.

Questa figura mostra l'elenco dei dispositivi predefinito che viene compilato quando un utente
            collega correttamente Google Home Playground al proprio account.

Accedi

Avvia Google Home Playground facendo clic sul pulsante di seguito:

Avvia Playground

Fai clic su Accedi con Google. Assicurati di accedere con lo stesso account che hai utilizzato in GHA per completare il collegamento dell'account.

Questa figura mostra lo stato iniziale di Google Home Playground
            e mette in evidenza il pulsante di accesso nell'angolo in alto a destra.

Dopo aver eseguito l'accesso, Google Home Playground mostrerà i dispositivi virtuali memorizzati in Home Graph.

Questa figura mostra l'elenco dei dispositivi, le informazioni sui dispositivi e l'area dei log della
            visualizzazione predefinita di Google Home Playground.

L'interfaccia utente web è composta da tre riquadri:

  • L'elenco dei dispositivi mostra tutti i dispositivi virtuali. Puoi selezionare un determinato dispositivo virtuale per visualizzarne le informazioni e crearne altri tramite questo riquadro.
  • Le informazioni sul dispositivo presentano le informazioni del dispositivo virtuale selezionato. Puoi anche modificare queste informazioni e rimuovere il dispositivo virtuale selezionato tramite il riquadro.
  • L'area dei log mostra i log di interazione tra Google Home Playground e Home Graph. Puoi espandere i log per esaminare i payload di richiesta e risposta per la risoluzione dei problemi.

Dispositivo virtuale

Visualizza le informazioni sul dispositivo virtuale

Nel riquadro Elenco dei dispositivi, seleziona il dispositivo virtuale che vuoi visualizzare. Nel riquadro Elenco dei dispositivi, seleziona il dispositivo virtuale che vuoi visualizzare. Il riquadro Informazioni sul dispositivo mostrerà le informazioni suddivise in cinque schede:

  • Informazioni di base: proprietà di primo livello del dispositivo, tra cui tipo, ID e nome del dispositivo.
  • Trait: trait supportati del dispositivo.
  • Attributi: attributi specifici del trait del dispositivo.
  • Stati: tutti gli stati del dispositivo.
  • SUV: configurazione di verifica utente secondaria del dispositivo.

Modifica le informazioni sul dispositivo virtuale

Oltre a visualizzare le informazioni di un dispositivo virtuale, puoi anche modificarle direttamente in Home Graph tramite il riquadro Informazioni sul dispositivo.

Modifica i trait supportati

  1. Seleziona la scheda Trait e fai clic sul pulsante Modifica.
  2. Nel riquadro popup puoi visualizzare i trait attualmente supportati dal dispositivo e i trait disponibili da aggiungere. Utilizza i pulsanti freccia (arrow_forward/arrow_back) per aggiungere o rimuovere i trait supportati per il dispositivo.
  3. Al termine dell'aggiornamento dei trait supportati, fai clic su Salva e i trait aggiornati verranno applicati a Home Graph.
  4. Puoi visualizzare questi aggiornamenti dei trait nell'area dei log.
Questa figura mostra lo strumento UX per aggiungere o eliminare le caratteristiche supportate
            su un dispositivo selezionato in Google Home Playground.

Modifica gli attributi del dispositivo

  1. Seleziona la scheda Attributi e modifica l'attributo per i trait supportati dal dispositivo.
  2. Al termine della modifica, premi Invio e le modifiche degli attributi verranno applicate a Home Graph.
  3. Puoi visualizzare questi attributi aggiornati nell'area dei log.

Modifica gli stati del dispositivo

  1. Seleziona la scheda Stati e modifica direttamente lo stato. Le modifiche dello stato verranno applicate a Home Graph.
  2. Puoi visualizzare queste modifiche dello stato nell'area dei log.

Aggiungi una verifica utente secondaria al dispositivo virtuale

Puoi aggiungere una verifica utente secondaria ai dispositivi virtuali e configurare il tipo di challenge e il comportamento corrispondente su ogni dispositivo. Puoi aggiungere una verifica utente secondaria ai dispositivi virtuali e configurare il tipo di challenge e il comportamento corrispondente su ogni dispositivo.

Configura la verifica utente secondaria sul dispositivo

  1. Nel riquadro Elenco dei dispositivi, seleziona il dispositivo virtuale che vuoi configurare.
  2. Nel riquadro Informazioni sul dispositivo, seleziona la scheda SUV e configura quanto segue:
    • Attivata: indica se la verifica utente secondaria è attivata o disattivata (nessuna challenge) sul dispositivo.
    • Tipo di challenge: indica se la verifica utente secondaria richiede un riconoscimento esplicito (ackNeeded) o un PIN (pinNeeded).
    • PIN: il PIN valido.
    • Gestione del PIN errato: indica se chiedere di nuovo all'utente quando il PIN è errato e, in caso contrario, l'errore a cui rispondere.
Questa figura mostra lo strumento UX per attivare le caratteristiche di verifica utente secondaria su un dispositivo selezionato in Google Home Playground.

Identifica i dispositivi che attivano la verifica utente secondaria

Nel riquadro Elenco dei dispositivi, accanto a ogni dispositivo con la verifica utente secondaria attivata viene visualizzata un'icona a forma di chiave key.

Questa figura mostra i dispositivi per i quali è consigliabile attivare la verifica utente secondaria.

Il seguente elenco di trait richiede la verifica utente secondaria:

Crea un nuovo dispositivo virtuale

  1. Nel riquadro Elenco dei dispositivi, fai clic su Aggiungi un dispositivo.
  2. Nel riquadro popup, seleziona il tipo di dispositivo e inserisci il nome del nuovo dispositivo. In alternativa, puoi selezionare un insieme predefinito di dispositivi da aggiungere.
  3. Una volta completati tutti i passaggi, il nuovo dispositivo verrà aggiunto a Home Graph.
Questa figura mostra lo strumento UX per aggiungere un nuovo tipo di dispositivo in
            Google Home Playground.

Rimuovi un dispositivo virtuale

  1. Nel riquadro Elenco dei dispositivi, seleziona il dispositivo che vuoi rimuovere. Poi, nel riquadro Informazioni sul dispositivo, seleziona la scheda Informazioni di base e Poi, nel riquadro Informazioni sul dispositivo, seleziona la scheda Informazioni di base e fai clic su Icona CestinoRimuovi dispositivo in basso.
  2. Conferma la rimozione del dispositivo nell'avviso popup.
  3. Una volta confermata la rimozione del dispositivo, quest'ultimo verrà rimosso da Home Graph.
Questa figura mostra lo strumento UX per rimuovere un tipo di dispositivo virtuale in
            Google Home Playground.

Editor della risposta SYNC

Puoi convalidare o aggiornare la risposta SYNC in Google Home Playground. Fai clic su Editor della risposta SYNC per aprire un IDE incorporato.

Questa figura mostra il pulsante per aprire l'editor della risposta SYNC.

Modifica o copia e incolla la risposta SYNC e fai clic su Salva per applicare le modifiche e vedere come funziona nell'ecosistema Google Home.

Questa figura mostra la finestra per modificare la risposta di sincronizzazione.

Importa ed esporta dispositivi virtuali

Per la risoluzione dei problemi o la riproduzione, puoi esportare i dispositivi virtuali con i relativi stati in un file e condividere il file con altri utenti per importare e replicare i tuoi dispositivi virtuali.

Questa figura mostra lo strumento UX per importare ed esportare dispositivi virtuali
            in Google Home Playground.

Esporta i dispositivi virtuali in un file

  1. Fai clic su per esportare i dispositivi virtuali in un file.
  2. Inserisci il nome del file che vuoi esportare e fai clic su OK.
  3. Una volta inserito il nome del file, il browser scaricherà il file dei dispositivi virtuali esportati.

Importa i dispositivi virtuali da un file

  1. Fai clic su per importare i dispositivi virtuali da un file.
  2. Seleziona il file che vuoi importare e fai clic su OK.
  3. Una volta confermato il file da importare, Google Home Playground importerà i dispositivi virtuali con gli stati dal file e aggiornerà le informazioni e gli stati dei dispositivi importati in Home Graph.

Esamina i log di interazione

Quando interagisci con i dispositivi virtuali, Google Home Playground applica automaticamente la modifica a Home Graph. Le interazioni con Home Graph vengono registrate nel riquadro Area dei log, dove puoi espandere ogni voce per esaminare i payload delle richieste e delle risposte API Home Graph.

Ogni voce di log è un array JSON contenente elementi della seguente struttura:

{
  "uri": string,
  "request": object,
  "response": object
}
Campi Tipo Descrizione
uri string URL della chiamata API Home Graph.
request object Corpo della richiesta della chiamata API Home Graph. Per il formato di ogni metodo, consulta la documentazione di riferimento documentazione di riferimento.
response object Corpo della risposta della chiamata API Home Graph. Per il formato di ogni metodo, consulta la documentazione di riferimento documentazione di riferimento.

Visualizza i tipi e i trait di dispositivi supportati

L'icona della Guida a forma di punto interrogativo in alto a destra mostra l'elenco corrente dei tipi e dei trait di dispositivi supportati da Google Home Playground.

Questa figura mostra lo strumento UX per aggiungere un nuovo tipo di dispositivo in
            Google Home Playground.

Problemi con i report

Non vediamo l'ora di ricevere il tuo feedback. Segnala i problemi riscontrati utilizzando l' icona a forma di punto esclamativo di feedback in alto a destra.

Questa figura mostra le icone per fornire feedback e segnalare
       problemi in Google Home Playground.