Google Home Playground

Cloud-to-cloud    SDK Local Home    SDK dispositivo

Google Home Playground è un'applicazione web che simula un progetto per la smart home con trait e tipi 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 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'app 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 il 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, sul GHA verrà visualizzato un insieme di dispositivi virtuali predefiniti con cui potrai interagire.

Accedi

Avvia Google Home Playground facendo clic sul pulsante qui sotto:

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

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

L'interfaccia utente web è costituita da tre riquadri:

• Elenco 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.
• L'area log mostra i log delle interazioni tra Google 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 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 relative informazioni categorizzate in cinque schede:

• Informazioni di base: proprietà di primo livello del dispositivo, inclusi tipo, ID e nome.
• Trait:i trait supportati del dispositivo.
• Attributi:attributi specifici del trait 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 modificare direttamente le relative informazioni archiviate 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 vedere i trait attualmente supportati del dispositivo e i trait disponibili da aggiungere. Usa i pulsanti Freccia (arrow_forward/arrow_back) per aggiungere o rimuovere i trait supportati per il dispositivo.
3. Dopo aver aggiornato i trait supportati, fai clic su Salva e i trait aggiornati verranno applicati a Home Graph.
4. Puoi visualizzare questi aggiornamenti dei trait nell'area Log.

Modificare gli attributi dei dispositivi

1. Seleziona la scheda Attributi e modifica l'attributo dei trait supportati dal dispositivo.
2. Una volta terminate le modifiche, 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 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 utente secondaria al dispositivo virtuale

Puoi aggiungere un SUV ai dispositivi virtuali e configurarne il tipo di verifica e il comportamento corrispondente su ciascun dispositivo. Puoi aggiungere un SUV ai dispositivi virtuali e configurarne il tipo di verifica e il comportamento corrispondente su ciascun 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:
   • Attivato: indica se SUV è attivata o disattivata (nessuna verifica) sul dispositivo.
   • Tipo di sfida: se il SUV richiede un riconoscimento esplicito (ackNeeded) o un numero di identificazione personale (pinNeeded).
   • PIN:il PIN valido.
   • Gestione del PIN errato: se il PIN è errato, indichi se chiedere nuovamente all'utente e, in caso contrario, l'errore di risposta.

Identifica i dispositivi che supportano i SUV

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

Il seguente elenco di trait richiede la verifica SUV:

• ArmDisarm
• LockUnlock
• OpenClose
• Riavvia
• SoftwareUpdate

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 relativo nome. 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.

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, 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. Dopo aver confermato la rimozione del dispositivo, questo verrà rimosso da Home Graph.

Editor risposta sincronizzazione

Puoi convalidare o aggiornare la tua risposta di sincronizzazione in Google Home Playground. Fai clic su Sync Response Editor (Editor risposta sincronizzazione) per aprire un IDE incorporato.

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.

Importazione ed esportazione di dispositivi virtuali

Per risolvere o riprodurre i problemi, puoi esportare i dispositivi virtuali con il loro stato in un file e condividere il file con gli altri per importare e replicare i dispositivi virtuali.

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

Importa i dispositivi virtuali da un file

1. Fai clic su upload_file 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 del file e aggiornerà le informazioni e lo stato 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 dell'API Home Graph e della risposta.

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

Visualizzare i trait e i tipi di dispositivi supportati

L'icona del punto interrogativo Guida in alto a destra mostrerà il tipo di dispositivo attuale e l'elenco di trait supportati da Google Home Playground.

Segnalare i problemi

Vorremmo conoscere la tua opinione. Segnala eventuali problemi tramite l'icona a forma di punto esclamativo feedback in alto a destra.