Zona de juegos de Google Home

SDK del dispositivo

Google Home Playground es una aplicación web que simula un proyecto de casa inteligente con tipos y rasgos de dispositivo configurables. Puedes crear dispositivos virtuales, modificar sus atributos y estados, verlos en Google Home Graph, y también importar o exportar configuraciones de dispositivos.

Completa la vinculación de cuentas

Para usar Google Home Playground, te recomendamos que primero vincules la herramienta a tu cuenta. Abre el archivo Google Home app (GHA) en tu teléfono y realiza el proceso de vinculación de la cuenta:

  1. Haz clic en el ícono de signo más (+) en la esquina superior izquierda.
  2. Selecciona Configurar dispositivo > Funciona con Google.
  3. Busca la acción titulada Google Home Playground.
  4. Selecciona la acción y GHA te dirigirá a la página de acceso. Haz clic en Acceder con Google y selecciona tu cuenta para ingresar.
  5. Haz clic en el botón Autorizar para autorizar la vinculación de cuentas.
En esta figura, se muestra el flujo de vinculación de cuentas de la app de Google Home para conectar el Playground de Google Home.

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

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

Acceder

Haz clic en el siguiente botón para iniciar Google Home Playground:

Inicia Playground

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

En esta figura, se muestra el estado inicial del Playground de Google Home 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 muestra 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:

  • En la lista de dispositivos, se muestran 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.
  • 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 a fin de inspeccionar las cargas útiles de solicitud y respuesta para solucionar problemas.

Dispositivo virtual

Ver información del dispositivo virtual

En el panel Lista de dispositivos, selecciona el dispositivo virtual que quieres ver. En el panel Lista de dispositivos, 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.
  • Raits: Son las características admitidas del dispositivo.
  • Atributos: son atributos específicos de rasgos del dispositivo.
  • Estados: Todos los estados del dispositivo.
  • SUV: Es la configuración de la verificación secundaria del usuario del dispositivo.

Edita la información del dispositivo virtual

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

Cómo modificar los traits admitidos

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

Modifica los atributos del dispositivo

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

Modificar los estados del dispositivo

  1. Selecciona la pestaña States 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.

Cómo agregar una verificación secundaria del usuario al dispositivo virtual

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

Configurar el 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:
    • Enabled: Indica si el vehículo SUV está habilitado o inhabilitado (sin desafío) en el dispositivo.
    • Tipo de desafío: Indica si el vehículo SUV requiere una confirmación explícita (ackNeeded) o un número de identificación personal (pinNeeded).
    • PIN: Es el PIN válido.
    • Manejo del PIN incorrecto: Cuando el PIN es incorrecto, si se debe volver a preguntar al usuario y, si no, el error, se debe responder.
En esta figura, se muestra la herramienta de UX para habilitar características de verificación secundarias del usuario en un dispositivo seleccionado en el Playground de Google Home.

Identificar los dispositivos que admiten vehículos SUV

En el panel Lista de dispositivos, se muestra una clave con el ícono de llave junto a cada dispositivo habilitado para todoterrenos.

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

La siguiente lista de características requiere un vehículo todoterreno:

Cómo crear 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 quieres quitar. Luego, en el panel Device info, selecciona la pestaña Basic Information. Luego, en el panel Device info, elige la pestaña Basic Information y haz clic en Ícono de papeleraRemove device en la parte inferior.
  2. Confirma la eliminación del dispositivo en la alerta emergente.
  3. Una vez que confirmes que se quitó el dispositivo, 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 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.

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

Edita o copia y pega la respuesta de sincronización 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 o reproducir problemas, puedes exportar tus dispositivos virtuales con sus estados a un archivo y compartirlo con otras personas para importar y replicar 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 los 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 quieres 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 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, en el que puedes expandir cada entrada para inspeccionar las cargas útiles de solicitud y respuesta a 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 de Home Graph
request object Cuerpo de la solicitud de la llamada a la API de Home Graph Consulta la documentación de referencia la documentación de referencia para conocer el formato de cada método.
response object Cuerpo de la respuesta de la llamada a la API de Home Graph Consulta la documentación de referencia la documentación de referencia para conocer el formato de cada método.

Consulta los tipos y las características de los dispositivos compatibles

El ícono de signo de interrogación ayuda 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. Si tienes problemas, informa los problemas usando el ícono de signo de exclamación feedback que se encuentra en la parte superior derecha.

En esta figura, se muestran los íconos para informar y enviar comentarios en Google Home Playground.