Complemento de Google Home para Android Studio

Google Home Plugin for Android Studio se diseñó y creó para los desarrolladores de la plataforma de Google Home. Este complemento te brinda acceso a Google Assistant Simulator, Cloud Logging y otras herramientas para simplificar el proceso de desarrollo de tu casa 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 Appearance & Behavior, expande System Settings y, luego, haz clic en Passwords.
  3. Selecciona No guardar ni olvidar las contraseñas después de reiniciar.
Complemento de Google Home para Android Studio

Atributos

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.

Al igual que el simulador de Asistente existente que se proporciona en la consola de Actions on Google Console, Assistant Simulator te permite controlar con facilidad 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, "De acuerdo, encendiendo la luz".

Cómo realizar pruebas con el simulador de 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 al 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 de Assistant Simulator para un solo enunciado no son deterministas. Por ejemplo, una respuesta puede ser cualquiera de las siguientes frases:

  • Entendido. Encendiendo 2 lámparas.
  • Seguro, encenderé 2 lámparas.
  • Entendido. Encendiendo 2 lámparas.
  • De acuerdo, se encenderán 2 lámparas.

Para ejecutar pruebas automatizadas y verificar cómo funcionan tus integraciones de Google con estas respuestas, puedes enviar declaraciones por lotes a 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

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

Visor de registros de Android Debug Bridge (adb)

El visor de registros de adb es una herramienta para ver y analizar archivos de registro, como los archivos de registro del dispositivo Matter, los registros de Google Home y los registros de Android.

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 Plugins, 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 antes de poder usar Assistant Simulator y ver Cloud Logging:

Acceder con Google

Puedes acceder a tu cuenta de desarrollador desde el panel principal de Google y autorizar a Android Studio a comunicarse con los servicios de Google en tu nombre.

  1. Haz clic en la pestaña Google Home en la columna de pestañas verticales en el lado izquierdo de la ventana Android Studio.

  2. En Acceder con, haz clic en Google para iniciar el navegador.

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

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

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

Ahora deberías haber accedido con la opción Salir.

Selecciona un proyecto de Cloud

Después de acceder, selecciona un Proyecto del menú desplegable. Para filtrar tu 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 conservarán cuando salgas de Android Studio.

Selecciona un proyecto

Para obtener ayuda con los filtros del proyecto, ve a Parámetros de consulta en la Referencia de Google Cloud.

Cómo usar el simulador de Asistente

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

Abrir panel de declaraciones

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

Escribe consultas y recopila respuestas

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

Para volver a enviar una consulta, haz clic en el ícono de reenvío que se encuentra al final de la consulta.

Después de enviar una o más consultas, haz clic en Volver a reproducir para volver a ejecutar tus consultas y verificar las respuestas. El panel Utterances hace un seguimiento de las consultas y respuestas en una caché almacenada. La opción 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.

Volver a reproducir discursos con el simulador de Asistente

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

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

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 expresiones para abrir tus archivos JSON guardados en una pestaña nueva. En Seleccionar ruta de acceso, puedes elegir un archivo o una carpeta. Si eliges una carpeta, Recopilar y Probar funcionarán en todos los archivos .json de declaraciones en esa carpeta.

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

La barra de estado muestra el resultado de tu última prueba (si corresponde), un punto amarillo o verde para indicar si se recopiló el archivo, y la ruta de acceso al archivo .json del enunciado. Después de hacer clic en Recopilar, Assistant Simulator ejecuta tus consultas. Recibirás una notificación cuando se recopile una respuesta nueva, y la barra de estado mostrará un contador mientras se procesan las consultas.

Recopila declaraciones con el simulador de Asistente

Cuando se completa Recopilar, la barra de estado se actualiza con una marca de verificación verde frente a tu ruta de acceso .json, y los archivos de expresiones se propagan con respuestas posibles.

Recopila declaraciones con el simulador de 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 las declaraciones por lotes

Una vez que hayas recopilado tus respuestas, haz clic en Probar para volver a reproducir las consultas y verificar las respuestas y los registros. Cuando pruebas declaraciones por lotes, Assistant Simulator espera las respuestas que se guardan en tu 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 de Asistente

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

Ejecuta declaraciones con el simulador de Asistente

Ver Cloud Logging

Para abrir una pestaña de proyecto en la ventana de herramientas de Cloud Logs, haz clic en Cloud Logs en el panel Google Home Plugin. Puedes abrir pestañas de registro de Cloud separadas 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 Consulta. Por ejemplo, para filtrar registros de una palabra clave de light, haz lo siguiente:

Consulta de Cloud Logging

Selecciona Use QL (Usar QL) para usar el lenguaje de consulta de Logging.

Lenguaje de consulta de Cloud Logging

Estos son algunos ejemplos de consultas de QL que te ayudarán 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 registros por fecha también es opcional y se puede habilitar haciendo clic en Después y Antes. Puedes escribir el 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 fecha para elegir la fecha y, luego, ingresar la hora en el campo de texto.

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

Selecciona En tiempo real para recuperar los registros de los proyectos en vivo. Haz clic en Detener para finalizar un feed en tiempo real.

Nivel de gravedad

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

Resultados de la consulta

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

Una vez que se cargan los registros, haz clic en cualquier registro para expandir la carga útil completa de JSON. Vuelve a hacer clic en para mostrar el mensaje completo.

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

Ver Cloud Logging

Consulta el gráfico de Home y ejecuta pruebas

Para ver una lista de tus dispositivos, selecciona Home Graph en el panel Google Home Plugin.

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

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 de JSON de tus dispositivos.

JSON de expansión y contracción de Home Graph

Para iniciar el conjunto de pruebas en un dispositivo específico, haz clic en Probar. Esto inicia el paquete de pruebas en el navegador con el dispositivo seleccionado y listo para la prueba. Haz clic en Iniciar y espera los resultados de la prueba.

Pruebas de ejecución de Home Graph

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

Pruebas completadas de Home Graph

Visor de registros de Android Debug Bridge (adb)

Para abrir una pestaña de proyecto en la ventana de la herramienta Registro de Adb, haz clic en el comando Registro de Adb en la barra de herramientas del complemento de Google Home (a la izquierda). Puedes abrir pestañas del registro de AdB para cada uno de tus archivos de registro. Para borrar una pestaña, haz clic en el ícono .

Usa el campo Seleccionar para seleccionar un componente de registro específico y el menú desplegable Gravedad para mostrar solo las entradas con la gravedad de registro correspondiente.

Para el registro de adb seleccionado, puedes filtrar las entradas de registro mediante el campo Filter con los modificadores opcionales que distinguen mayúsculas de minúsculas o Regex.

Además, puedes hacer lo siguiente:

  • Buscar entradas específicas con el campo Buscar y los comandos Buscar siguiente (ícono de ) y Buscar anterior (ícono de )
  • Usa los modificadores opcionales que distinguen mayúsculas de minúsculas o Regex.
  • Saltar a una línea (Jump to line) para saltar a una línea específica (por número) en el registro.

Selecciona Numeradas para ver las líneas de registro con números de línea agregados. Selecciona Sin procesar para ver las entradas de registro sin procesar.

Visualizador de registros de adb

Recursos y comentarios

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

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

Enviar comentarios