Cloud-to-cloud SDK de Home Home SDK del dispositivo
Google Home Playground es una aplicación web que simula un proyecto de casa inteligente con tipos y características de dispositivos configurables. Puedes crear dispositivos virtuales, modificar sus atributos y estados, ver estos dispositivos en Google Home Graph e importar o exportar configuraciones de dispositivos.
Completar la vinculación de la cuenta
Para usar Google Home Playground, se recomienda que primero vincules la herramienta a tu cuenta. Abre Google Home app (GHA) en tu teléfono y sigue el proceso de vinculación de cuentas:
- Haz clic en el ícono más (+) que se encuentra en la esquina superior izquierda.
- Selecciona Configurar dispositivo > Funciona con Google.
- Busca la acción titulada Google Home Playground.
- Selecciona la acción, y el GHA te dirigirá a la página de acceso. Haz clic en Acceder con Google y selecciona tu cuenta para acceder.
- Haga clic en el botón Autorizar para autorizar la vinculación de la cuenta.

Una vez que completes la vinculación de la cuenta, se mostrará un conjunto de dispositivos virtuales predeterminados en GHA para que puedas interactuar.

Accede
Haz clic en el siguiente botón para iniciar Google Home Playground:
Haz clic en Sign in with Google (Acceder con Google). Asegúrate de acceder con la misma cuenta que usaste en GHA para completar la vinculación de la cuenta.

Después de que accedas, Google Home Playground mostrará los dispositivos virtuales almacenados en Home Graph.

La IU web consta de tres paneles:
- En Lista de dispositivos, se muestran todos los dispositivos virtuales. Puedes seleccionar un dispositivo virtual determinado para ver su información y crear dispositivos virtuales a través de este panel.
- En Información del dispositivo, se muestra la información del dispositivo virtual seleccionado. También puedes editar esta información y quitar el dispositivo virtual seleccionado a través del panel.
- En Área de registro, se muestran los registros de interacción entre Google Home Playground y Home Graph. Puedes expandir los registros para inspeccionar las cargas útiles de solicitud y respuesta a fin de solucionar problemas.
Dispositivo virtual
Ver información del dispositivo virtual
En el panel Device list, selecciona el dispositivo virtual que quieres ver. En el panel Device list, selecciona el dispositivo virtual que quieres ver. En el panel Información del dispositivo, se mostrará la información categorizada en cinco pestañas:
- Información básica: Son las propiedades de nivel superior del dispositivo, incluidos el tipo, el ID y el nombre.
- Características: Son las características compatibles del dispositivo.
- Atributos: Son atributos específicos de las características del dispositivo.
- Estados: todos los estados del dispositivo.
- SUV: Es la configuración de la verificación del usuario secundaria del dispositivo.
Editar la información de los dispositivos virtuales
Además de ver la información de un dispositivo virtual, también puedes editar su información almacenada en Home Graph a través del panel Información del dispositivo.
Modificar las características admitidas
- Selecciona la pestaña Características y haz clic en el botón Editar.
- En el panel emergente, puedes ver las características compatibles actualmente con el dispositivo y los atributos disponibles para agregar. Usa los botones de flecha
(arrow_forward/arrow_back) para agregar o quitar características compatibles con el dispositivo. - Cuando termines de actualizar las características compatibles, haz clic en Guardar para que se apliquen las características actualizadas a Home Graph.
- Puedes ver estas actualizaciones de las características en el área de Registro.

Modificar atributos del dispositivo
- Selecciona la pestaña Attributes y edita el atributo correspondiente a las características admitidas por el dispositivo.
- Cuando termines de editar, presiona Intro y los cambios de tus atributos se aplicarán a Home Graph.
- Puede ver estos atributos actualizados en el Área de registro.
Modificar los estados del dispositivo
- Selecciona la pestaña States y edita el estado directamente. Los cambios de estado se aplicarán a Home Graph.
- Puedes ver estas modificaciones de estado en el Área de registro.
Cómo agregar una verificación de usuario secundaria al dispositivo virtual
Puedes agregar un SUV a los dispositivos virtuales y configurar el tipo de desafío y el comportamiento correspondiente en cada dispositivo. Puedes agregar un vehículo todoterreno a dispositivos virtuales y configurar su tipo de desafío y comportamiento correspondiente en cada dispositivo.
Configurar vehículo todoterreno en dispositivo
- En el panel Device list, selecciona el dispositivo virtual que deseas configurar.
- En el panel Información del dispositivo, selecciona la pestaña SUV y configura lo siguiente:
- Habilitado: indica si el vehículo todoterreno está habilitado o inhabilitado (sin desafíos) en el dispositivo.
- Tipo de desafío: indica si un SUV requiere una confirmación explícita (ackNeeded) o un número de identificación personal (pinNeeded).
- PIN: El PIN válido.
- Manejo de PIN incorrecto: Cuando el PIN es incorrecto, volver a preguntar al usuario y, de no ser así, responder el error.

Identifica dispositivos que permiten vehículos deportivos utilitarios
En el panel Lista de dispositivos, se muestra una clave de ícono de clave junto a cada dispositivo habilitado para los vehículos todoterreno.

La siguiente lista de características requiere un vehículo todoterreno:
Crea un dispositivo virtual nuevo
- En el panel Lista de dispositivos, haz clic en Agregar un dispositivo.
- En el panel emergente, selecciona el tipo de dispositivo y, luego, ingresa el nombre del nuevo dispositivo. Como alternativa, puedes seleccionar un conjunto predefinido de dispositivos para agregar.
- Una vez que completes todos los pasos, el dispositivo nuevo se agregará a Home Graph.

Cómo quitar un dispositivo virtual
- En el panel Lista de dispositivos, selecciona el dispositivo que quieres quitar.
Luego, en el panel Información del dispositivo, selecciona la pestaña Información básica y, luego, en el panel Información del dispositivo, selecciona la pestaña Información básica y haz clic en
Quitar dispositivo en la parte inferior.
- Confirma la eliminación del dispositivo en la alerta emergente.
- Una vez que confirmes la eliminación del dispositivo, se quitará de Home Graph.

Editor de respuestas de sincronización
Puedes validar o actualizar tu respuesta de sincronización en Google Home Playground. Haz clic en Sync Response Editor para abrir un IDE incorporado.

Edita o copia y pega tu respuesta de sincronización y haz clic en Guardar para aplicar los cambios y ver cómo funciona en el ecosistema de Google Home.

Importa y exporta dispositivos virtuales
A fin de solucionar problemas o reproducir problemas, puedes exportar los dispositivos virtuales con sus estados a un archivo y compartirlos con otras personas para importarlos y replicarlos.

Cómo exportar dispositivos virtuales a un archivo
- Haz clic en para exportar dispositivos virtuales a un archivo.
- Ingresa el nombre del archivo que deseas exportar y haz clic en OK.
- Una vez que ingreses el nombre del archivo, el navegador descargará el archivo de los dispositivos virtuales exportados.
Importa dispositivos virtuales desde un archivo
- Haz clic en para importar dispositivos virtuales desde un archivo.
- Selecciona el archivo que deseas importar y haz clic en Aceptar.
- Una vez que confirmes el archivo para importar, Google Home Playground importará dispositivos virtuales con estados del archivo y actualizará la información y los estados de los dispositivos importados en Home Graph.
Cómo inspeccionar registros de interacción
Cuando interactúas con los dispositivos virtuales, Google Home Playground aplica automáticamente el cambio a Home Graph. Las interacciones con Home Graph se registran en el panel Área de registro, en el que puedes expandir cada entrada para inspeccionar la carga útil de solicitud y respuesta de la API de Home Graph.
Cada entrada de registro es un array JSON que contiene elementos de la siguiente estructura:
{
"uri": string,
"request": object,
"response": object
}
Campos | Tipo | Descripción |
---|---|---|
uri |
string |
URL de la llamada a la API Home Graph. |
request |
object |
Cuerpo de la solicitud de la llamada a la API Home Graph Consulta la documentación de referencia documentación de referencia para conocer el formato de cada método. |
response |
object |
Cuerpo de respuesta de la llamada a la API Home Graph. Consulta la documentación de referencia documentación de referencia para conocer el formato de cada método. |
Ver características y tipos de dispositivos compatibles
El ícono de ayuda signo de ayuda en la parte superior derecha mostrará el tipo de dispositivo y la lista de características compatibles con Google Home Playground.

Cómo informar problemas
Nos gustaría conocer tu opinión Informa los problemas que encuentres con el ícono de signo de exclamación comentarios en la parte superior derecha.
