Complemento de Google Home para Android Studio

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

Aviso de seguridad

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

1. Haga 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 las contraseñas después de reiniciar.

Funciones

Simulador del 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 de Asistente existente que se proporciona en Actions on Google Console Console, Assistant Simulator te permite controlar con facilidad los dispositivos si escribes 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, enciende la luz".

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.

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

Declaración por lotes

Las respuestas de 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.
• Claro, encendiendo 2 lámparas.
• Entendido. Encendiendo 2 lámparas.
• De acuerdo, encendiendo 2 lámparas.

Para ejecutar pruebas automatizadas y verificar cómo funcionan tus integraciones de Google con estas respuestas, puedes enviar expresiones 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 Visualizador de Home Graph te permite mostrar el estado de tus dispositivos y, luego, iniciar el conjunto de pruebas de Google Home en el navegador.

Visualizador 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 de Google Home y los 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 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
• Selecciona un proyecto de Cloud

Acceder con Google

Puedes acceder a tu cuenta de desarrollador desde el panel de Google Home, lo que autoriza 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, haga clic en Google para iniciar su navegador.

   

3. Elige la cuenta que está vinculada con tus dispositivos del hogar 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 para Salir.

Selecciona un proyecto de Cloud

Después de acceder, seleccione 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 Project carga los primeros 100 proyectos según tu Filter. Tus selecciones se conservan cuando sales de Android Studio.

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

Usa el simulador de Asistente

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

Existen varias formas de enviar consultas a Assistant Simulator. A continuación, revisaremos 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 cached al final de ella.

Después de enviar una o más consultas, haz clic en cached Volver a reproducir para volver a ejecutar tus consultas y verificar tus respuestas. En el panel Utterances, se 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.

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

• ask: Tu consulta.
• answers: Es un array de posibles respuestas 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 Utterances File 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 todos los archivos .json de declaraciones de esa carpeta.

Puedes abrir varias pestañas para el mismo archivo o diferentes, 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 del archivo .json de declaración. Después de hacer clic en tocCollect (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 tus consultas.

Cuando se completa Collect (recopilación), la barra de estado se actualiza con una marca de verificación verde delante de tu ruta .json y tus archivos de expresiones se propagan con respuestas posibles.

{
  "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 con anticipación, tu ruta de acceso .json no se marcará como recopilada.

Cómo probar declaraciones por lotes

Una vez que hayas recopilado tus respuestas, haz clic en switch_left 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 tu archivo JSON. Si la prueba muestra una respuesta que no se recopiló, recibirás una notificación similar a la siguiente:

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

Esta situación indica que la prueba no fue exitosa. 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 check en la barra de estado.

Ver Cloud Logging

Para abrir una pestaña del proyecto en la ventana de herramientas de Cloud Logging, haz clic en Cloud Logging en el panel Google Home Plugin. Puedes abrir pestañas de Cloud Logging distintas para cada proyecto.

Términos de búsqueda

Para el proyecto seleccionado, también puedes filtrar los registros mediante el campo Query. Por ejemplo, para filtrar registros por una palabra clave de light, haz lo siguiente:

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

Aquí tienes 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 si haces clic en Después y Antes. Puedes escribir la fecha y la hora en el campo de texto proporcionado, por ejemplo, 5/11/22, 12:37 PM, o puedes usar los selectores de fecha calendar_month a fin de seleccionar la 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 calendar_month.
• Para seleccionar una fecha anterior a 5/1/22, selecciona Antes y haz clic en el ícono de fecha calendar_month.
• Para seleccionar una fecha entre el 5/1/22 y el 6/30/22, selecciona Antes y Después y elige las fechas con el ícono de fecha calendar_month.

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

Nivel de gravedad

También puede seleccionar un valor de Gravedad mínima en el menú desplegable.

Resultados de la consulta

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

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

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

Ver Home Graph y ejecutar pruebas

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

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

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

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

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

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

Visualizador de registros de Android Debug Bridge (adb)

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

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

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

Además, puedes hacer lo siguiente:

• Busca entradas específicas con los campos Find y Find Next (ícono de arrow_downward) y Find Previous (ícono de arrow_upward).
• Usa modificadores distinguibles entre mayúsculas y minúsculas o Regex.
• Ir a la línea: Permite ir a una línea específica (por número) del registro.

Selecciona Numerado (Numbered) 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.

Recursos y comentarios

Haz clic en Recursos a fin de 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.