Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.

Zona de juegos de Google Home

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

SDK de Device

Google Home Playground es una aplicación web que te permite simular un proyecto de casa inteligente mediante la simulación de una casa virtual con tipos y características del dispositivo configurables. Home Playground te permite crear dispositivos virtuales, modificar los atributos y estados de los dispositivos, verlos en Google Home Graph y, además, importar o exportar configuraciones de dispositivos.

Completar la vinculación de la cuenta

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

  1. Haga clic en el ícono más (+) que se encuentra 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.
  5. Haga clic en el botón Autorizar para autorizar la vinculación de las cuentas.
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, se mostrará un conjunto de dispositivos virtuales predeterminados en el GHA para que puedas interactuar con ella.

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

Acceder

Inicia Home Playground haciendo 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 GHA para completar la vinculación de la cuenta.

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

Después de acceder, 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 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 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.
  • En Área de registro, se muestran los registros de interacción entre 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 deseas ver. El panel Información del dispositivo 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 con el dispositivo.
  • Atributos: atributos específicos de la característica del dispositivo.
  • Estados: todos los estados del dispositivo.
  • SUV: Configuración de verificación del usuario secundaria del dispositivo.

Editar la información del dispositivo virtual

Además de ver la información de un dispositivo virtual, puedes editar directamente la información almacenada en Home Graph mediante el panel Device info.

Modificar las características compatibles

  1. Selecciona la pestaña Características; haz clic en el botón Editar.
  2. En el panel emergente, puedes ver las características admitidas actualmente del dispositivo y las características disponibles para agregar. Usa los botones de flecha (arrow_forward/arrow_back) para agregar o quitar las características compatibles del dispositivo.
  3. Cuando termines de actualizar las características compatibles, haz clic en Save 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 las características compatibles en un dispositivo seleccionado en Google Home Playground.

Modificar atributos del dispositivo

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

Modificar los estados de los dispositivos

  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.

Agregar una verificación de usuario secundario al dispositivo virtual

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

Configurar SUV en el dispositivo

  1. En el panel Device list, selecciona el dispositivo virtual que deseas configurar.
  2. En el panel Información del dispositivo, selecciona la pestaña SUV y configura lo siguiente:
    • Habilitado: Indica si la vehículo todoterreno está habilitada o inhabilitada (en el dispositivo).
    • Tipo de desafío: indica si el vehículo todoterreno 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, ya sea para volver a preguntar al usuario o no y, si no es así, responder.
En esta figura, se muestra la herramienta de UX para habilitar características de verificación de usuarios secundarios en un dispositivo seleccionado en Google Home Playground.

Identifica dispositivos que permiten vehículos deportivos utilitarios

En el panel Lista de dispositivos, aparece un ícono de clave clave junto a cada dispositivo compatible con los vehículos todoterreno.

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

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

Crear un nuevo dispositivo virtual

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

Cómo quitar un dispositivo virtual

  1. En el panel Lista de dispositivos, selecciona el dispositivo que quieras quitar. 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, se quitará el dispositivo de Home Graph.
En esta figura, se muestra la herramienta de UX para quitar un tipo de dispositivo virtual en Google Home Playground.

Importa y exporta dispositivos virtuales

Para solucionar problemas o reproducirlos, puedes exportar los dispositivos virtuales con sus estados a un archivo y compartirlos con otras personas a fin de importarlos y replicarlos.

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

Cómo exportar 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 hayas ingresado 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 desees importar y haz clic en Aceptar.
  3. Una vez que confirmes el archivo que deseas importar, Home Playground importará dispositivos virtuales con estados del 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, Home Playground aplica automáticamente el cambio a Home Graph. Las interacciones con Home Graph se registran en el panel de Área de registro, en el que puedes expandir cada entrada para inspeccionar las cargas útiles de solicitud y respuesta de la API de Home Graph.

Cada entrada de registro es un arreglo 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 para conocer el formato de cada método.
response object Cuerpo de respuesta de la llamada a la API de Home Graph. Consulta la documentación de referencia para conocer el formato de cada método.

Consulta las características y los tipos de dispositivos compatibles

El ícono de ayuda de signo de pregunta en la esquina superior derecha mostrará el tipo de dispositivo actual y la lista de características compatibles con Home Playground.

En esta figura, se muestra la herramienta de UX para agregar un nuevo tipo de dispositivo en Google Home Playground.

Enviar comentarios e informar problemas

Nos gustaría conocer tu opinión. Para enviar comentarios, haz clic en el ícono de emoticón sonriente sentiment_satisfied en la parte superior derecha, o bien informa los problemas que hayas tenido con el ícono de signo de exclamación comentarios.

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