Cloud-to-cloud SDK Home Home SDK dispositivo
La pagina Google Home Playground is a web application that allows you to simulate a smart home project by simulating a virtual home with configurable device types and traits. The Home Playground allows you to create virtual devices, modify the device attributes and states, view these devices in Google Home Graph , and import or export device configurations.
Completa il collegamento dell'account
Per utilizzare Home Playground, ti consigliamo di collegare prima lo strumento al tuo account. Apri il Google Home app (GHA) on your phone, and go through the account linking process:
- Fai clic sull'icona Più (+) nell'angolo in alto a sinistra.
- Seleziona Configura dispositivo > Funziona con Google.
- Cerca l'azione Google Home Playground.
- Seleziona l'azione e GHA ti reindirizzerà alla pagina di accesso. Fai clic su Accedi con Google e seleziona il tuo account per accedere.
- Fai clic sul pulsante Autorizza per autorizzare il collegamento dell'account.

Una volta completato il collegamento dell'account, nella sezione GHA visualizzerai un insieme di dispositivi virtuali predefiniti con cui potrai interagire.

Accedi
Avvia Home Playground facendo clic sul pulsante di seguito:
Fai clic su Sign in with Google (Accedi con Google). Assicurati di accedere con lo stesso account che hai utilizzato in GHA per completare il collegamento.

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

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 di log visualizza i log di interazione tra Home Playground e Home Graph. Puoi espandere i log per ispezionare i payload delle richieste e delle risposte per risolvere i problemi.
Dispositivo virtuale
Visualizza informazioni sul dispositivo virtuale
Nel riquadro Elenco dispositivi, seleziona il dispositivo virtuale che vuoi visualizzare. Il riquadro Informazioni sul dispositivo mostra le informazioni classificate in cinque schede:
- Informazioni di base:proprietà di primo livello del dispositivo, inclusi tipo, ID e nome.
- Caratteristiche: caratteristiche supportate del dispositivo.
- Attributi:attributi specifici del tratto del dispositivo.
- Stati. Tutti gli stati dei dispositivi.
- SUV: configurazione della verifica dell'utente secondaria del dispositivo.
Modifica informazioni sul dispositivo virtuale
Oltre a visualizzare le informazioni di un dispositivo virtuale, puoi anche modificarne direttamente le informazioni memorizzate in Home Graph tramite il riquadro Informazioni dispositivo.
Modifica caratteristiche supportate
- Seleziona la scheda Tratti e fai clic sul pulsante Modifica.
- Nel riquadro popup puoi vedere le caratteristiche attualmente supportate del dispositivo e quelle che puoi aggiungere. Utilizza i pulsanti Freccia
(arrow_forward/arrow_back) per aggiungere o rimuovere caratteristiche supportate per il dispositivo. - Dopo aver aggiornato i tratti supportati, fai clic su Salva e i tratti aggiornati verranno applicati a Home Graph.
- Puoi visualizzare questi aggiornamenti delle caratteristiche nell'area di log.

Modificare gli attributi dei dispositivi
- Seleziona la scheda Informazioni di base/Attributi e modifica l'attributo con le caratteristiche supportate dal dispositivo.
- Al termine della modifica, premi Invio e le modifiche agli attributi verranno applicate a Home Graph.
- Puoi visualizzare questi attributi aggiornati nell'area di log.
Modifica gli stati del dispositivo
- Seleziona la scheda Stati e modifica direttamente lo stato. Le modifiche dello stato verranno applicate a Home Graph.
- Puoi visualizzare queste modifiche dello stato nell'area di log.
Aggiungere una verifica degli utenti secondari al dispositivo virtuale
Puoi aggiungere un SUV a dispositivi virtuali e configurare il tipo di verifica e il comportamento corrispondente su ogni dispositivo.
Configura SUV sul dispositivo
- Nel riquadro Elenco dispositivi, seleziona il dispositivo virtuale che vuoi configurare.
- Nel riquadro Informazioni sul dispositivo, seleziona la scheda SUV e configura quanto segue:
- Abilitata: se il SUV è attivato o disattivato (nessuna verifica) sul dispositivo.
- Tipo di verifica: indica se il SUV richiede una conferma esplicita (ackNeeded) o un numero di identificazione personale (pinNeeded).
- PIN: il PIN valido.
- Gestione del PIN errato:se il PIN è errato, chiedi nuovamente all'utente e, in caso contrario, l'errore per rispondere.

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

Nel seguente elenco di caratteristiche è necessario il SUV:
Crea un nuovo dispositivo virtuale
- Nel riquadro Elenco dispositivi, fai clic su Aggiungi un dispositivo.
- 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.
- Una volta completati tutti i passaggi, il nuovo dispositivo verrà aggiunto a Home Graph.

Rimuovere un dispositivo virtuale
- Nel riquadro Elenco dispositivi, seleziona il dispositivo da rimuovere.
Quindi, nel riquadro Informazioni del dispositivo, seleziona la scheda Informazioni di base e fai clic su
Rimuovi dispositivo in basso.
- Conferma la rimozione del dispositivo nell'avviso popup.
- Una volta confermata la rimozione, il dispositivo verrà rimosso da Home Graph.

Importa ed esporta dispositivi virtuali
Per risolvere i problemi o riprodurre i dispositivi virtuali, puoi esportarli con i relativi stati in un file e condividerli con altri utenti per importare e replicare i tuoi dispositivi virtuali.

Esportare dispositivi virtuali in un file
- Fai clic su per esportare i dispositivi virtuali in un file.
- Inserisci il nome del file da esportare e fai clic su OK.
- Una volta inserito il nome del file, il browser scarica il file dei dispositivi virtuali esportati.
Importa dispositivi virtuali da un file
- Fai clic su per importare dispositivi virtuali da un file.
- Seleziona il file da importare e fai clic su OK.
- Dopo aver confermato il file per l'importazione, Home Playground importerà dispositivi virtuali con gli stati del 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, Home Playground applica automaticamente la modifica a Home Graph. Le interazioni con Home Graph sono registrate nel riquadro Area di log, dove puoi espandere ogni voce per ispezionare i payload di richieste e risposte 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 per il formato di ciascun metodo. |
response |
object |
Corpo della risposta della chiamata API Home Graph. Consulta la documentazione di riferimento per il formato di ciascun metodo. |
Visualizza i tipi di dispositivi e le caratteristiche supportati
L'icona della guida in punto in alto a destra mostra il tipo di dispositivo e l'elenco delle caratteristiche attuali supportati da Home Playground.

Problemi relativi a feedback e segnalazioni
Apprezziamo la tua opinione. Per inviarci un feedback, fai clic sull'icona della smile in alto a destra oppure segnala il problema riscontrato utilizzando l'icona del punto esclamativo feedback.
