Google Home Playground

Cloud-to-cloud    Local Home SDK    API Home

Google Home Playground è un'applicazione web che simula un progetto di smart home con tipi e caratteristiche 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 Google Home app (GHA) sullo smartphone e segui la procedura di collegamento dell'account descritta in Connettere dispositivi per la smart home di terze parti nell'app Google Home.

  1. Cerca l'integrazione intitolata Google Home Playground.
  2. Seleziona l'integrazione e GHA ti indirizzerà alla 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, nella GHA verrà visualizzato un insieme di dispositivi virtuali predefiniti con cui interagire.

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 Sign in With 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.

La UI web è composta da tre pannelli:

  • L'elenco dei dispositivi mostra tutti i tuoi dispositivi virtuali. Puoi selezionare un determinato dispositivo virtuale per visualizzarne le informazioni e crearne altri 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 pannello.
  • 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

Visualizzare le 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. Il riquadro Informazioni sul dispositivo mostra le informazioni suddivise in cinque schede:

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

Modificare le informazioni sul dispositivo virtuale

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

Modificare i tratti supportati

  1. Seleziona la scheda Tratti e fai clic sul pulsante Modifica.
  2. Nel riquadro popup puoi vedere le caratteristiche attualmente supportate del dispositivo e quelle disponibili da aggiungere. Utilizza i pulsanti freccia (arrow_forward/arrow_back) per aggiungere o rimuovere le funzionalità supportate per il dispositivo.
  3. Dopo aver aggiornato le caratteristiche supportate, fai clic su Salva e le caratteristiche aggiornate verranno applicate a Home Graph.
  4. Puoi visualizzare questi aggiornamenti delle caratteristiche nell'area Log.
Questa figura mostra lo strumento UX per aggiungere o eliminare le caratteristiche supportate
            su un dispositivo selezionato in Google Home Playground.

Modificare gli attributi del dispositivo

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

Modificare gli stati del dispositivo

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

Aggiungere una verifica utente secondaria al dispositivo virtuale

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

Configurare 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:
    • Attivata:indica se la verifica in due passaggi è attivata o disattivata (nessuna verifica) sul dispositivo.
    • Tipo di verifica:se SUV richiede un riconoscimento esplicito (ackNeeded) o un PIN (Personal Identification Number) (pinNeeded).
    • PIN:il PIN valido.
    • Gestione del PIN errato:quando il PIN è errato, se chiedere di nuovo all'utente 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.

Identificare i dispositivi che attivano SUV

Nel riquadro Elenco dispositivi, viene visualizzata un'icona a forma di chiave chiave accanto a ogni dispositivo con funzionalità SUV.

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

Il seguente elenco di caratteristiche richiede SUV:

Creare 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 tuo 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. Quindi, nel riquadro Informazioni sul dispositivo, seleziona la scheda Informazioni di base e Quindi, 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 alla sincronizzazione 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 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.

Importare ed esportare dispositivi virtuali

Per la risoluzione dei problemi o la riproduzione, puoi esportare i tuoi 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.

Esportare 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.

Importare dispositivi virtuali da un file

  1. Fai clic su per importare dispositivi virtuali da un file.
  2. Seleziona il file che vuoi importare e fai clic su Ok.
  3. Dopo aver confermato il file da importare, Google Home Playground importa i dispositivi virtuali con gli stati dal file e aggiorna 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 esaminare i payload di richiesta e risposta dell'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. Consulta la documentazione di riferimento documentazione di riferimento per il formato di ogni metodo.
response object Corpo della risposta della chiamata API Home Graph. Consulta la documentazione di riferimento documentazione di riferimento per il formato di ogni metodo.

Visualizzare i tipi di dispositivi e i trait supportati

L'icona Guida a forma di punto interrogativo in alto a destra mostra l'elenco dei tipi di dispositivi e delle caratteristiche 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 rapporti

Ci piacerebbe conoscere la tua opinione. Segnala i problemi riscontrati utilizzando l'icona del punto esclamativo feedback in alto a destra.

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