Google Home Playground

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

Completare 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:

1. Fai clic sull'icona Più (+) nell'angolo in alto a sinistra.
2. Seleziona Configura dispositivo > Funziona con Google.
3. Cerca l'azione 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.

Una volta completato il collegamento dell'account, in GHA verrà visualizzato un insieme di dispositivi virtuali predefiniti con cui puoi interagire.

Accedi

Avvia Google Home Playground facendo clic sul pulsante di seguito:

Launch Playground

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

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

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 creare dispositivi virtuali tramite questo riquadro.
• Informazioni del dispositivo mostra 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 traGoogle Home Playground e Home Graph. Puoi espandere i log per ispezionare i payload di richiesta e risposta per la risoluzione dei problemi.

Dispositivo virtuale

Visualizzare le informazioni del 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 del 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 del dispositivo virtuale

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

Modificare i tratti supportati

1. Seleziona la scheda Caratteristiche 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 caratteristiche 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 dei tratti nell'area Log.

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 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 configurarne il tipo di sfida e il comportamento corrispondente su ogni dispositivo. Puoi aggiungere un SUV ai dispositivi virtuali e configurarne 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 funzionalità SUV è attivata o disattivata (nessuna verifica) sul dispositivo.
   • Tipo di verifica:indica se la verifica richiede un conferma esplicita (ackNeeded) o un numero di identificazione personale (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 da rispondere.

Identificare i dispositivi che attivano SUV

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

Il seguente elenco di tratti richiede SUV:

• ArmDisarm
• LockUnlock
• OpenClose
• Riavvia
• SoftwareUpdate

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 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 aHome Graph.

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 fai clic su Rimuovi dispositivo in basso.
2. Conferma la rimozione del dispositivo nell'avviso popup.
3. Una volta confermata la rimozione, il dispositivo verrà rimosso da Home Graph.

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

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

Importa ed esporta dispositivi virtuali

Per risolvere i problemi o riprodurli, puoi esportare i dispositivi virtuali con i relativi stati in un file e condividerlo con altri utenti per importarli e replicarli.

Esportare i dispositivi virtuali in un file

1. Fai clic su file_download per esportare i dispositivi virtuali in un file.
2. Inserisci il nome del file da esportare e fai clic su OK.
3. Dopo aver inserito il nome del file, il browser scaricherà il file dei dispositivi virtuali esportati.

Importare dispositivi virtuali da un file

1. Fai clic su upload_file per importare dispositivi virtuali da un file.
2. Seleziona il file da 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.

Controllare 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 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 all'API Home Graph.
request	object	Corpo della richiesta della chiamata all'API Home Graph. Consulta la documentazione di riferimento documentazione di riferimento per il formato di ciascun metodo.
response	object	Corpo della risposta della chiamata dell'API Home Graph. Consulta la documentazione di riferimento documentazione di riferimento per il formato di ciascun metodo.

Visualizzare i tipi e i trait dei dispositivi supportati

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

Problemi con i rapporti

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