Complemento de Google Home para Android Studio

Google Home Plugin for Android Studio se diseñó y creó para Google de Google Home Platform. Este complemento te brinda acceso a Google Assistant Simulator, Cloud Logging y otras herramientas para simplificar tus proceso de desarrollo de casas inteligentes.

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 Contraseñas.
  3. Selecciona No guardar, olvidar las 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 Google Home ecosistema, puedes interactuar con Assistant Simulator en cualquier momento sin dejando Android Studio.

Similar al Asistente existente Se proporciona un simulador en la consola de Actions on Google Console, Assistant Simulator te permite para 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 tu comandos, por ejemplo, "Está bien, encendiendo la luz".

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 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 de Assistant Simulator a una sola oración no son deterministas. Por ejemplo, una respuesta podría ser cualquiera de las siguientes frases:

  • Entendido. Encendiendo 2 lámparas.
  • Por supuesto. Se encenderán 2 luces.
  • 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 por lotes, puedes enviar declaraciones en lote al Assistant Simulator ejecutando 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 hacer lo siguiente: mostrar el estado de tus dispositivos e iniciar la Paquete de pruebas de Google Home en el navegador.

Visor de registros de Android Debug Bridge (adb)

Adb Log Viewer es una herramienta para ver y analizar archivos de registro, por ejemplo, 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, haz lo siguiente: sigue estos pasos:

  1. Descarga o actualiza Android Studio. Descarga Android Studio
  2. Ve a Archivo > Configuración (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 el Marketplace de JetBrains.

Configuración

Una vez que instales el complemento, deberás completa 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. autorizando a Android Studio a comunicarse con Google servicios en tu nombre.

  1. Haz clic en la pestaña Página principal de Google en la columna de la pestaña vertical que se encuentra a la izquierda lado de la ventana Android Studio.

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

    Acceso con Google para 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 a tu cuenta y tener la opción de salir.

Selecciona un proyecto de Cloud

Después de acceder, selecciona un Project en el menú desplegable. Para filtrar las lista de proyectos, escribe una expresión de Filter, por ejemplo, matter y, luego, presiona Enter

El menú desplegable Proyecto carga los primeros 100 proyectos según tu Filtrar: Tus selecciones se conservarán cuando salgas Android Studio

Selecciona un proyecto

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

Usa el simulador de Asistente

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

Abrir el panel de declaraciones

Hay varias formas de enviar consultas a Assistant Simulator. Luego, revisaremos cada opción.

Escribe consultas y recopila respuestas

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

Para reenviar una consulta, haz clic en el ícono para volver a enviar al final de tu consulta.

Luego de enviar una o más consultas, haz clic en Vuelve a reproducir para volver a ejecutar tu y verifica tus respuestas. El panel Utterances hace un seguimiento de tus y las respuestas de la organización 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 .

Vuelve a reproducir las declaraciones con el simulador del Asistente

Haz clic en Save para guardar las consultas. las respuestas que ingresaste en el Panel Utterances Tus interacciones se convierten a JSON en las siguientes situaciones: 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."
      ]
    }
  ]
}

Recopila 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, puedes elegir una un archivo o una carpeta. Si eliges una carpeta, las opciones Recopilar y Prueba funciona en todos los archivos .json de enunciados 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 el archivo se recopiló y el de la declaración de voz .json. Después de hacer clic Recopilación, Assistant Simulator ejecuta tus consultas. Recibirás una notificación cuando se recopile una respuesta nueva y la barra de estado muestra un contador mientras se procesan tus consultas.

Recopila declaraciones con el simulador del Asistente

Cuando se completa la Recopilación, la Barra de estado se actualiza con una marca de verificación verde. al frente de tu ruta de acceso .json, y tus archivos de declaraciones se completan con posibles respuestas.

Recopila 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 Detén la colección antes, tu ruta .json no se marcará como de los datos recopilados.

Probar enunciados por lotes

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

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

Ejecuta declaraciones con el simulador de Asistente

Esta situación indica que una prueba no se realizó correctamente. De lo contrario, el Assistant Simulator ejecutará cada una de tus consultas y mostrará una respuesta. Si la prueba se realizó correctamente, aparecerá una marca de verificación 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 Registros de Cloud, haz clic en Registros de Cloud. en el panel Google Home Plugin. Puedes abrir pestañas separadas de Cloud Log para cada uno de tus proyectos.

Pestañas de Cloud Logging

Términos de búsqueda

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

Consulta de Cloud Logging

Selecciona Use QL para usar 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

Consultar registros por fecha también es opcional y se puede habilitar haciendo clic Después y Antes. Puedes ingresar el formato de la fecha y la hora en el texto. proporcionado, por ejemplo, 5/11/22, 12:37 PM, o puedes usar los selectores de fecha para seleccionar la fecha y, luego, ingresa 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 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 registros de proyectos 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 Recuperar para enviar la información. tus parámetros de consulta.

Cuando se carguen los registros, haz clic en cualquier registro para expandir Carga útil de tipo JSON. Vuelve a hacer clic . para mostrar el mensaje completo.

De forma opcional, puedes escribir una palabra clave en el cuadro Filtro para acotar el registro resultados. Haz clic en la x para quitar el filtro y volver al original y recuperar resultados.

Ver Cloud Logging

Ver el gráfico de inicio y ejecutar pruebas

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

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

Cuando los dispositivos estén cargados, haz clic en cualquier registro. para expandir Carga útil de tipo JSON.

Carga útil de JSON del gráfico de la página principal

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

JSON de expansión y contracción de gráfico de página principal

Para iniciar el conjunto de pruebas de un dispositivo específico, haz clic en Probar. Se iniciará el paquete de pruebas en tu 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 las pruebas.

Pruebas completadas de Home Graph

Visor de registros de Android Debug Bridge (adb)

Para abrir la pestaña de un proyecto en la ventana de herramientas Registro de ADB, haz clic en el comando Registro de AdMob. en la barra de herramientas del complemento de Google Home (a la izquierda). Puedes abrir un registro de anuncios por separado pestañas 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 que deseas ver y el menú desplegable Gravedad para mostrar solo las entradas con la gravedad de registro coincidente.

Para tu registro adb seleccionado, puedes filtrar entradas de registro con la función Filter con modificadores opcionales de distinción entre mayúsculas y minúsculas o regex.

Además, puedes hacer lo siguiente:

  • Encuentra entradas específicas con el campo Buscar y los comandos Buscar siguiente (ícono de ) y Buscar el anterior (ícono ).
  • Usa modificadores opcionales de distinción entre mayúsculas y minúsculas o regex.
  • Saltar a la línea para saltar a una línea específica (por número) del registro

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

Visor de registros de adb

Recursos y comentarios

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

Enviar tus opiniones o comentarios sobre cómo podemos mejorar el desarrollo. tu experiencia con Google Home Plugin, haz clic en Comentarios.

Enviar comentarios