Complemento de Google Home para Android Studio

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

Google Home Plugin for Android Studio está diseñado y creado para desarrolladores de la plataforma Google Home. Este complemento te da acceso a Google Assistant Simulator, Cloud Logging y otras herramientas para simplificar tu proceso de desarrollo del hogar inteligente.

Complemento de Google Home para Android Studio

Aviso de seguridad

Para evitar que Android Studio almacene secretos y contraseñas, completa los siguientes pasos:

  1. Haz clic en Archivo y luego en Configuración....
  2. En Apariencia y comportamiento, expande Configuración del sistema y, luego, haz clic en Contraseñas.
  3. Selecciona No guardar, olvida contraseñas después de reiniciar.
Complemento de Google Home para Android Studio

Funciones

Simulador de Asistente

Para probar si tus dispositivos de casa inteligente funcionan correctamente con el ecosistema de Google Home, puedes interactuar con Assistant Simulator en cualquier momento sin salir de Android Studio.

De manera similar al simulador del Asistente existente que se proporciona en Actions on Google Console Console, Assistant Simulator te permite controlar fácilmente tus dispositivos escribiendo tus consultas, por ejemplo, "Enciende la luz". Dentro de Android Studio, Assistant Simulator responde con mensajes de texto basados en tus comandos, por ejemplo, "Está bien, encendiendo la luz".

Realiza pruebas con el simulador del Asistente

Ver Cloud Logging

Google Cloud Logging proporciona información de depuración y métricas clave para brindarte estadísticas sobre el uso de tu acción. Para simplificar el desarrollo, Google Home Plugin muestra mensajes Cloud Logging en tiempo real junto a tu código durante la solución de problemas.

Puedes mostrar registros en tiempo real o seleccionar un período.

Vista de Cloud Logging

Declaraciones por lotes

Las respuestas Assistant Simulator a una sola declaración no son deterministas. Por ejemplo, una respuesta podría ser cualquiera de las siguientes frases:

  • Entendido. Encendiendo 2 lámparas.
  • Seguro, encendiendo 2 lámparas.
  • Entendido. Encendiendo 2 lámparas.
  • Muy bien, encendiendo 2 lámparas.

Para ejecutar pruebas automatizadas y verificar cómo funcionan tus integraciones de Google con estas respuestas, puedes enviar declaraciones por lotes al Assistant Simulator mediante la ejecución de secuencias de comandos de expresiones. Una vez que se guarda una secuencia de comandos, puedes recopilar respuestas y ejecutar varias pruebas en tus consultas.

Visualizador de Home Graph

Home Graph Viewer te permite mostrar el estado de tus dispositivos y, luego, iniciar el Conjunto de pruebas de Google Home en tu navegador.

Instalar

Para instalar Google Home Plugin en Android Studio, sigue estos pasos:

  1. Descarga o actualiza Android Studio. Descargar Android Studio
  2. Ve a File > Settings (Android Studio > Preferences en MacOS).
  3. En la sección Complementos, ve a Marketplace y busca google home.
  4. Instala la herramienta y reinicia Android Studio.
También puedes descargar el complemento directamente desde JetBrains Marketplace.

Configuración

Una vez que hayas instalado el complemento, deberás completar los siguientes pasos para poder usar Assistant Simulator y ver Cloud Logging:

Acceder con Google

Puedes acceder a tu cuenta de desarrollador desde el panel de Google Home y autorizar a Android Studio para que se comunique con los servicios de Google en tu nombre.

  1. Haz clic en la pestaña Google Home en la columna de la pestaña vertical del lado izquierdo de la ventana Android Studio.

  2. En Acceder con, haga clic en Google para iniciar su navegador.

    Acceso con Google Studio a Android Studio
  3. Elige la cuenta que esté vinculada a tus dispositivos de casa inteligente.

  4. En la página de autorización Acceder con Google, haz clic en Permitir.

  5. Cierra la ventana del navegador y regresa a Android Studio.

Debería haber accedido, con la opción Salir.

Selecciona un proyecto de Cloud

Después de acceder, selecciona un Proyecto del menú desplegable. Para filtrar la lista de proyectos, escribe una expresión Filter (por ejemplo, matter) y, luego, presiona Enter.

El menú desplegable Proyecto carga los primeros 100 proyectos según tu filtro. Tus selecciones se conservan cuando sales de Android Studio.

Selecciona un proyecto

Para obtener ayuda con los filtros de proyectos, consulta Parámetros de consulta en la Referencia de Google Cloud.

Usar el simulador del Asistente

Para abrir el Assistant Simulator en Android Studio, haz clic en Panel de declaraciones en el panel Google Home Plugin.

Abrir panel de declaraciones

Existen varias formas de enviar consultas a Assistant Simulator. A continuación, analizaremos cada opción.

Escribe consultas y recopila respuestas

Para interactuar con Assistant Simulator, escribe tu consulta y presiona Intro.

Puedes volver a enviar una consulta si haces clic en el ícono de reenviar al final de tu consulta.

Después de enviar una o más consultas, haz clic en Volver a reproducir para volver a ejecutar las consultas y verificar tus respuestas. El panel Utterances (Registro de declaraciones) realiza un seguimiento de las consultas y respuestas en una caché almacenada. Volver a reproducir solo agrega respuestas nuevas a esta caché interna y no duplicará tus consultas cada vez que hagas clic en el botón.

Vuelve a reproducir declaraciones con el simulador del Asistente

Haz clic en Guardar para guardar las consultas y las respuestas que ingresaste en el panel Declaraciones. Tus interacciones se convierten a JSON en el siguiente formato:

  • ask: Tu consulta.
  • answers: Es un array de respuestas Assistant Simulator posibles.

Puedes editar este archivo JSON en Android Studio.

{
  "collected": false,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights."
      ]
    }
  ]
}

Recopilar respuestas por lotes

En el panel Google Home Plugin, haz clic en Archivo de declaraciones para abrir los archivos JSON guardados en una pestaña nueva. En Seleccionar ruta de acceso, puedes elegir un archivo o una carpeta. Si eliges una carpeta, Collect y Test funcionarán en todas las declaraciones .json en esa carpeta.

Puedes abrir varias pestañas para el mismo archivo o archivos diferentes, por ejemplo, lights, lights(1) y plug.

En la barra de estado, se muestra el resultado de tu última prueba (si corresponde), un punto amarillo o verde para indicar si se recopiló el archivo y la ruta del archivo de declaraciones .json. Después de hacer clic en Recopilar, Assistant Simulator ejecuta tus consultas. Se te notificará cuando se recopile una respuesta nueva, y la barra de estado mostrará un contador mientras se procesen tus consultas.

Colecciona declaraciones con el simulador del Asistente

Cuando se completa la acción Collect, la Barra de estado se actualiza con una marca de verificación verde delante de la ruta de acceso .json, y los archivos de declaración se propagan con posibles respuestas.

Colecciona declaraciones con el simulador del Asistente
{
  "collected": true,
  "lines": [
    {
      "ask": "turn lights on",
      "answers": [
        "OK, turning 2 lights on.",
        "Sure, turning on 2 lights.",
        "Sure, turning 2 lights on.",
        "Got it, turning 2 lights on.",
        "Alright, turning on 2 lights.",
        "OK, turning on 2 lights.",
        "Got it, turning on 2 lights.",
        "Alright, turning 2 lights on."
      ]
    }
  ]
}

Si detienes la recopilación antes de tiempo, tu ruta de acceso .json no se marcará como recopilada.

Prueba declaraciones de lote

Una vez que hayas recopilado tus respuestas, haz clic en Probar para volver a reproducir tus consultas y verificar tus respuestas y registros. Cuando pruebas las declaraciones por lotes, Assistant Simulator espera las respuestas que se guardan en el archivo JSON. Si la prueba muestra una respuesta que no se recopiló, recibirás una notificación similar a la siguiente:

Expected one of: "Got it, turning on 2 lights."

Ejecuta declaraciones con el simulador del Asistente

Esta situación indica que la prueba no se realizó correctamente. De lo contrario, Assistant Simulator ejecutará cada una de tus consultas y mostrará una respuesta. Si la prueba tuvo éxito, se mostrará una verificación de en la barra de estado.

Ejecuta declaraciones con el simulador del Asistente

Ver Cloud Logging

Para abrir una pestaña de proyecto en la ventana de herramientas de Cloud Logging, haz clic en Registros de Cloud en el panel Google Home Plugin. Puedes abrir pestañas de Cloud Logging por separado para cada uno de tus proyectos.

Pestañas de Cloud Logging

Términos de búsqueda

Para tu proyecto seleccionado, también puedes filtrar registros con el campo Query (Consulta). Por ejemplo, para filtrar registros por una palabra clave de light, haz lo siguiente:

Consulta de Cloud Logging

Selecciona Usar QL para usar el lenguaje de consulta de Logging.

Lenguaje de consultas de Cloud Logging

Aquí encontrarás algunos ejemplos de consultas de QL para ayudarte a comenzar:

severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"

Consultas de fecha y hora

La consulta de los registros por fecha también es opcional y se puede habilitar si haces clic en Después y Antes. Puedes escribir tu formato de fecha y hora en el campo de texto proporcionado, por ejemplo, 5/11/22, 12:37 PM, o puedes usar los selectores de fechas para seleccionar tu fecha y, luego, ingresar la hora en el campo de texto.

  • Para seleccionar una fecha posterior al 5/1/22, selecciona Después y haz clic en el ícono de fecha .
  • Para seleccionar una fecha anterior a 5/1/22, selecciona Antes y haz clic en el ícono de fecha .
  • Para seleccionar una fecha entre el 5/1/22 y el 6/30/22, selecciona Antes y Después y elige las fechas del ícono de fecha .

Selecciona En tiempo real para obtener los registros del proyecto en vivo. Haz clic en Detener para finalizar un feed en tiempo real.

Nivel de gravedad

También puedes seleccionar una Gravedad mínima en el menú desplegable.

Resultados de la consulta

Haz clic en Obtener para enviar los parámetros de consulta.

Una vez que se carguen los registros, haz clic en cualquier registro para expandir la carga útil completa de JSON. Haz clic nuevamente en para mostrar el mensaje completo.

De manera opcional, puedes escribir una palabra clave en el cuadro Filtrar para limitar los resultados del registro. Haz clic en x para quitar el filtro y volver a los resultados de la recuperación originales.

Ver Cloud Logging

Ver Home Graph y ejecutar pruebas

Para enumerar tus dispositivos, selecciona Home Graph en el panel Google Home Plugin.

Haz clic en Refresh a fin de mostrar el Nombre del dispositivo, el ID del dispositivo y el Tipo de dispositivo de tus dispositivos asociados con el proyecto seleccionado. Puedes tener varios paneles Google Home Graph abiertos para proyectos distintos.

Una vez que se carguen los dispositivos, haz clic en cualquier registro para expandir la carga útil completa de JSON.

Carga útil de JSON de Home Graph

También puedes usar Expandir y Contraer para mostrar y ocultar las cargas útiles JSON para tus dispositivos.

Expandir y contraer JSON

Para iniciar el Conjunto de pruebas en un dispositivo específico, haz clic en Probar. Se iniciará el conjunto de pruebas en tu navegador con el dispositivo seleccionado y listo para realizar pruebas. Haz clic en Iniciar y espera los resultados de la prueba.

Pruebas de ejecución en Home Graph

Puedes verificar los detalles de la prueba y ver los registros una vez que se completen las pruebas.

Pruebas completadas de Home Graph

Recursos y comentarios

Haz clic en Recursos para ver una lista de herramientas y recursos para desarrolladores.

Para enviar tus opiniones o comentarios sobre cómo podemos mejorar la experiencia de desarrollo con el Google Home Plugin, haz clic en Comentarios.

Enviar comentarios