Google Home Playground

Cloud-to-cloud    SDK Home Home    SDK dispositivo

Google Home Playground è un'applicazione web che simula un progetto di smart home con caratteristiche e tratti configurabili. Puoi creare dispositivi virtuali, modificare gli attributi e gli stati dei dispositivi, visualizzarli in Google Home Graph e importare o esportare configurazioni di dispositivi.

Completa il collegamento dell'account

Per utilizzare Google Home Playground, ti consigliamo di collegare prima lo strumento al tuo account. Apri l'app Google Home app (GHA) sul telefono e svolgi la procedura di collegamento dell'account:

  1. Fai clic sull'icona più (+) nell'angolo in alto a sinistra.
  2. Seleziona Configura dispositivo > Funziona con Google.
  3. Cerca l'azione denominata Google Home Playground.
  4. Seleziona l'azione e GHA ti reindirizzerà alla pagina di accesso. Fai clic su Accedi con Google e seleziona il tuo account per accedere.
  5. 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
 connettere Google Home Playground.

Una volta completato il collegamento dell'account, sul dispositivo GHA verrà mostrato un insieme di dispositivi virtuali predefiniti con cui potrai interagire.

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

Accedi

Avvia Google Home Playground facendo clic sul pulsante seguente:

Avvia Playground

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

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

Dopo che avrai eseguito l'accesso, Google Home Playground mostrerà i dispositivi virtuali archiviati in Home Graph.

Questa figura mostra l'elenco e le informazioni sul dispositivo e l'area di log della visualizzazione predefinita di Google Home Playground.

L'interfaccia utente web è costituita da tre riquadri:

  • L'elenco dei dispositivi mostra tutti i tuoi dispositivi virtuali. Puoi selezionare un determinato dispositivo virtuale per visualizzarne le informazioni e creare dispositivi virtuali tramite questo riquadro.
  • Informazioni sul dispositivo mostra le informazioni del dispositivo virtuale selezionato. Puoi anche modificare queste informazioni e rimuovere il dispositivo virtuale selezionato tramite il riquadro.
  • Area log: visualizza i log delle interazioni tra Google Home Playground e Home Graph. Puoi espandere i log per ispezionare i payload delle richieste e delle risposte per la risoluzione dei problemi.

Dispositivo virtuale

Visualizza informazioni sul dispositivo virtuale

Nel riquadro Elenco dispositivi, seleziona il dispositivo virtuale che vuoi visualizzare. Nel riquadro Elenco dispositivi, seleziona il dispositivo virtuale che vuoi visualizzare. Nel riquadro Informazioni sul dispositivo vengono mostrate le relative informazioni categorizzate in cinque schede:

  • Informazioni di base:proprietà di primo livello del dispositivo, tra cui tipo di dispositivo, ID e nome.
  • Trait: caratteristiche supportate del dispositivo.
  • Attributi:attributi specifici del trattino del dispositivo.
  • Stati: tutti gli stati del dispositivo.
  • SUV: configurazione della verifica secondaria degli utenti del dispositivo.

Modifica informazioni sul dispositivo virtuale

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

Modificare i tratti supportati

  1. Seleziona la scheda Tratti e fai clic sul pulsante Modifica.
  2. Nel riquadro popup, puoi vedere i tratti attualmente supportati del dispositivo e quelli disponibili da aggiungere. Usa i pulsanti arrow (arrow_forward/arrow_back) per aggiungere o rimuovere i tratti supportati per il dispositivo.
  3. Dopo aver aggiornato i tratti supportati, fai clic su Salva e i tratti aggiornati verranno applicati a Home Graph.
  4. Puoi visualizzare questi aggiornamenti dei tratti nell'area Log.
Questa figura mostra lo strumento UX per aggiungere o eliminare i tratti supportati su un dispositivo selezionato in Google Home Playground.

Modifica attributi dispositivo

  1. Seleziona la scheda Attributi e modifica l'attributo per le caratteristiche supportate dal dispositivo.
  2. Terminata la modifica, premi Invio e le modifiche degli attributi verranno applicate a Home Graph.
  3. Puoi visualizzare questi attributi aggiornati nell'area Log.

Modifica stati del dispositivo

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

Aggiungere una verifica dell'utente secondario al dispositivo virtuale

Puoi aggiungere un SUV ai dispositivi virtuali e configurare il tipo di verifica e il comportamento corrispondente su ciascun dispositivo. Puoi aggiungere un SUV ai dispositivi virtuali e configurare il tipo di verifica e il comportamento corrispondente su ogni dispositivo.

Configura SUV sul dispositivo

  1. Nel riquadro Elenco dispositivi, seleziona il dispositivo virtuale che vuoi configurare.
  2. Nel riquadro Informazioni sul dispositivo, seleziona la scheda SUV e configura quanto segue:
    • Abilitata: indica se il SUV è attivato o disattivato (nessuna sfida) sul dispositivo.
    • Tipo di verifica: indica se il SUV richiede un riconoscimento esplicito (ack Needed) o un numero di identificazione personale (pin Needed).
    • PIN:il PIN valido.
    • Gestione del PIN errato:se il PIN è errato, chiedi all'utente nuovamente e, in caso contrario, l'errore per rispondere.
Questa figura mostra lo strumento UX per abilitare le caratteristiche di verifica dell'utente secondario su un dispositivo selezionato in Google Home Playground.

Identifica i dispositivi che abilitano il SUV

Nel riquadro Elenco dispositivi, viene visualizzata un'icona della chiave chiave accanto a ogni dispositivo abilitato per SUV.

Questa figura mostra i dispositivi consigliati per abilitare la verifica dell'utente secondario.

Il seguente elenco di caratteristiche richiede l'uso di un SUV:

Crea un nuovo dispositivo virtuale

  1. Nel riquadro Elenco 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.

Rimuovere un dispositivo virtuale

  1. Nel riquadro Elenco dispositivi, seleziona il dispositivo che vuoi rimuovere. Dopodiché, nel riquadro Informazioni sul dispositivo, seleziona la scheda Informazioni di base, 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. Dopo aver confermato la rimozione, il dispositivo verrà rimosso da Home Graph.
Questa figura mostra lo strumento UX per rimuovere un tipo di dispositivo virtuale in Google Home Playground.

Editor risposte di sincronizzazione

Puoi convalidare o aggiornare la tua risposta di sincronizzazione nelle Google Home Playground. Fai clic su Sincronizza risposta editor per aprire un IDE incorporato.

Questa figura mostra il pulsante per aprire l'editor delle risposte di sincronizzazione.

Modifica o copia e incolla la risposta di sincronizzazione 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 risolvere i problemi o riprodurli, puoi esportare i tuoi dispositivi virtuali con i relativi stati in un file e condividerli con altri 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. Dopo aver inserito il nome del file, il browser scarica il file dei dispositivi virtuali esportati.

Importare dispositivi virtuali da un file

  1. Fai clic su per importare i dispositivi virtuali da un file.
  2. Seleziona il file da importare e fai clic su OK.
  3. Dopo aver 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.

Esaminare i log delle interazioni

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 log, dove puoi espandere ogni voce per ispezionare i payload delle richieste e delle risposte API Home Graph.

Ogni voce di log è un array JSON contenente gli 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 di chiamata API Home Graph. Per informazioni sul formato di ciascun metodo, consulta la documentazione di riferimento la documentazione di riferimento.
response object Corpo della risposta della chiamata API Home Graph. Per informazioni sul formato di ciascun metodo, consulta la documentazione di riferimento la documentazione di riferimento.

Visualizzare i tipi di dispositivi e i tratti supportati

L'icona della guida del punto interrogativo in alto a destra mostra il tipo di dispositivo corrente e l'elenco delle caratteristiche supportato da Google Home Playground.

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

Segnalare i problemi

Apprezziamo la tua opinione. Sono stati riscontrati problemi utilizzando l'icona del punto esclamativo feedback in alto a destra.

Questa figura mostra le icone per fornire feedback e problemi con i report in Google Home Playground.