Zona de juegos de Google Home

De nube a nube    SDK de Local Home    APIs de Home

El 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 los atributos y estados de los dispositivos, verlos en Google Home Graph y, también, importar o exportar configuraciones de dispositivos.

Completa la vinculación de la cuenta

Para usar Google Home Playground, te recomendamos que primero vincules la herramienta a tu cuenta. Abre la Google Home app (GHA) en tu teléfono y sigue el proceso de vinculación de cuentas que se describe en Cómo conectar dispositivos inteligentes de terceros para la casa en la app de Google Home.

  1. Busca la integración titulada Google Home Playground.
  2. Selecciona la integración y la GHA te dirigirá a la página de acceso. Haz clic en Acceder con Google y selecciona tu cuenta para acceder.
  3. Haz clic en el botón Autorizar para autorizar la vinculación de la cuenta.
En esta figura, se muestra el flujo de vinculación de cuentas de la app de Google Home para conectar Google Home Playground.

Una vez que completes la vinculación de la cuenta, aparecerá un conjunto de dispositivos virtuales predeterminados en el GHA para que interactúes con ellos.

En esta figura, se muestra la lista de dispositivos predeterminada que se completa cuando un usuario
            vincula correctamente Google Home Playground a su cuenta.

Acceder

Para iniciar Google Home Playground, haz clic en el siguiente botón:

Iniciar Playground

Haz clic en Acceder con Google. Asegúrate de acceder con la misma cuenta que usaste en el GHA para completar la vinculación de la cuenta.

En esta figura, se muestra el estado inicial de Google Home Playground y se destaca el botón de acceso en la esquina superior derecha.

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

En esta figura, se muestran la lista de dispositivos, la información del dispositivo y el área de registro de la vista predeterminada de Google Home Playground.

La IU web consta de tres paneles:

  • Lista de dispositivos muestra todos tus dispositivos virtuales. Puedes seleccionar un dispositivo virtual determinado para ver su información y crear dispositivos virtuales a través de este panel.
  • Información del dispositivo presenta 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.
  • Área de registro muestra 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 para solucionar problemas.

Dispositivo virtual

Ver la información del dispositivo virtual

En el panel Lista de dispositivos, selecciona el dispositivo virtual que deseas ver. En el panel Lista de dispositivos, selecciona el dispositivo virtual que deseas ver. El panel Información del dispositivo mostrará su información categorizada en cinco pestañas:

  • Información básica: Propiedades de nivel superior del dispositivo, incluidos el tipo, el ID y el nombre del dispositivo.
  • Características: Características compatibles del dispositivo.
  • Atributos: Atributos específicos de las características del dispositivo.
  • Estados: Todos los estados del dispositivo.
  • SUV: Configuración de la verificación secundaria del usuario de l dispositivo.

Edita la información del dispositivo virtual

Además de ver la información de un dispositivo virtual, también puedes editar directamente su información almacenada en Home Graph a través del panel Información del dispositivo.

Modifica las características compatibles

  1. Selecciona la pestaña Características y haz clic en el botón Editar.
  2. En el panel emergente, puedes ver las características compatibles actualmente con el dispositivo y las características disponibles para agregar. Usa los botones de flecha (arrow_forward/arrow_back) para agregar o quitar características compatibles para el dispositivo.
  3. Cuando termines de actualizar las características compatibles, haz clic en Guardar y las características actualizadas se aplicarán a Home Graph.
  4. Puedes ver estas actualizaciones de características en el Área de registro.
En esta figura, se muestra la herramienta de UX para agregar o borrar rasgos admitidos en un dispositivo seleccionado en Google Home Playground.

Modifica los atributos del dispositivo

  1. Selecciona la pestaña Atributos y edita el atributo de las características compatibles con el dispositivo.
  2. Una vez que termines de editar, presiona Intro y los cambios de atributos se aplicarán a Home Graph.
  3. Puedes ver estos atributos actualizados en el Área de registro.

Modifica los estados del dispositivo

  1. Selecciona la pestaña Estados y edita el estado directamente. Los cambios de estado se aplicarán a Home Graph.
  2. Puedes ver estas modificaciones de estado en el Área de registro.

Agrega una verificación secundaria del usuario a un dispositivo virtual

Puedes agregar una SUV a los dispositivos virtuales y configurar su tipo de desafío y el comportamiento correspondiente en cada dispositivo. Puedes agregar una SUV a los dispositivos virtuales y configurar su tipo de desafío y el comportamiento correspondiente en cada dispositivo.

Configura la SUV en el dispositivo

  1. En el panel Lista de dispositivos, selecciona el dispositivo virtual que deseas configurar.
  2. En el panel Información del dispositivo, selecciona la pestaña SUV y configura lo siguiente:
    • Habilitada: Indica si la SUV está habilitada o inhabilitada (sin desafío) en el dispositivo.
    • Tipo de desafío: Indica si la SUV requiere un reconocimiento explícito (ackNeeded) o un número de identificación personal (pinNeeded).
    • PIN: El PIN válido.
    • Manejo de PIN incorrecto: Cuando el PIN es incorrecto, indica si se debe volver a preguntar al usuario y, si no es así, el error que se debe responder.
En esta figura, se muestra la herramienta de UX para habilitar los rasgos de verificación secundaria del usuario en un dispositivo seleccionado en Google Home Playground.

Identifica los dispositivos que habilitan la SUV

En el panel Lista de dispositivos, se muestra un ícono de llave key junto a cada dispositivo habilitado para la SUV.

En esta imagen, se muestran los dispositivos en los que se recomienda habilitar la verificación secundaria del usuario.

La siguiente lista de características requiere la SUV:

Crea un dispositivo virtual nuevo

  1. En el panel Lista de dispositivos, haz clic en Agregar un dispositivo.
  2. En el panel emergente, selecciona el tipo de dispositivo y, luego, ingresa el nombre del dispositivo nuevo. Como alternativa, puedes seleccionar un conjunto predefinido de dispositivos para agregar.
  3. Una vez que completes todos los pasos, el dispositivo nuevo se agregará a Home Graph.
En esta figura, se muestra la herramienta de UX para agregar un nuevo tipo de dispositivo en Google Home Playground.

Quita un dispositivo virtual

  1. En el panel Lista de dispositivos, selecciona el dispositivo que deseas 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 Ícono de papeleraQuitar dispositivo en la parte inferior.
  2. Confirma la eliminación del dispositivo en la alerta emergente.
  3. Una vez que confirmes la eliminación del dispositivo, este se quitará de Home Graph.
En esta figura, se muestra la herramienta de UX para quitar un tipo de dispositivo virtual en Google Home Playground.

Editor de respuesta SYNC

Puedes validar o actualizar tu respuesta SYNC en Google Home Playground. Haz clic en Editor de respuesta SYNC para abrir un IDE integrado.

En esta figura, se muestra el botón para abrir el editor de respuestas de sincronización.

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

En esta figura, se muestra la ventana para editar la respuesta de sincronización.

Importa y exporta dispositivos virtuales

Para solucionar problemas o reproducirlos, puedes exportar tus dispositivos virtuales con sus estados a un archivo y compartirlo con otras personas para que importen y repliquen tus dispositivos virtuales.

En esta figura, se muestra la herramienta de UX para importar y exportar dispositivos virtuales en Google Home Playground.

Exporta dispositivos virtuales a un archivo

  1. Haz clic en para exportar dispositivos virtuales a un archivo.
  2. Ingresa el nombre del archivo que deseas exportar y haz clic en Aceptar.
  3. Una vez que ingreses el nombre del archivo, el navegador descargará el archivo de dispositivos virtuales exportados.

Importa dispositivos virtuales desde un archivo

  1. Haz clic en para importar dispositivos virtuales desde un archivo.
  2. Selecciona el archivo que deseas importar y haz clic en Aceptar.
  3. Una vez que confirmes el archivo que deseas importar, Google Home Playground importará dispositivos virtuales con estados desde el archivo y actualizará la información y los estados de los dispositivos importados en Home Graph.

Inspecciona los 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, donde puedes expandir cada entrada para inspeccionar las cargas útiles de solicitud a la API y respuesta 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 Es la URL de la llamada a la API de Home Graph.
request object Es el cuerpo de la solicitud de la llamada a la API de Home Graph. Consulta la documentación de referencia documentación de referencia para obtener información sobre el formato de cada método.
response object Es el cuerpo de la respuesta de la llamada a la API de Home Graph. Consulta la documentación de referencia documentación de referencia para obtener información sobre el formato de cada método.

Consulta los tipos y las características de dispositivos compatibles

El ícono de ayuda del signo de interrogación en la parte superior derecha mostrará el tipo de dispositivo actual y la lista de características compatibles con Google Home Playground.

En esta figura, se muestra la herramienta de UX para agregar un nuevo tipo de dispositivo en 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.

En esta figura, se muestran los íconos para proporcionar comentarios y denunciar problemas en Google Home Playground.