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.

Aviso de seguridad

Para evitar que Android Studio almacene Secrets 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.

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".

Ver Cloud Logging

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

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

Declaraciones por lotes

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

• Entendido. Encendiendo 2 lámparas.
• Seguro, encenderé 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 por lotes, puedes enviar declaraciones en lote al Assistant Simulator ejecutando secuencias de comandos de expresiones. Una vez que la secuencia de comandos , puedes recopilar respuestas y ejecutar varias pruebas para 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)

El visor de registros de ADB es una herramienta para ver y analizar archivos de registro, por ejemplo Matter archivos de registro del dispositivo, registros de Google Home y Android los registros del sistema operativo.

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, accede a Marketplace y busca lo siguiente: google home
4. Instala la herramienta y reinicia Android Studio.

También puedes descargar el complemento directamente desde la JetBrains Marketplace.

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
• Selecciona un proyecto de la nube

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.

   

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 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

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 lo siguiente: haz clic en Panel de declaraciones en el panel Google Home Plugin.

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 cached ícono para volver a enviar al final de tu consulta.

Luego de enviar una o más consultas, haz clic en cached 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 .

Haz clic en save 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 tocRecopilació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.

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.

{
  "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 switch_left 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:

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

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. Aparecerá una verificación check en el Barra de estado si la prueba fue exitosa.

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.

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:

Selecciona Use QL para usar Lenguaje de consulta de 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 calendar_month 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 calendar_month
• Para seleccionar una fecha anterior al 5/1/22, selecciona Antes y haz clic en la fecha ícono 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 desde el ícono de fecha calendar_month

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 cached Recuperar para enviar la información. tus parámetros de consulta.

Cuando se carguen los registros, haz clic en cualquier registro chevron_right para expandir Carga útil de tipo JSON. Vuelve a hacer clic chevron_left. 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 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 cached Actualizar para mostrar las Nombre del dispositivo, ID del dispositivo y Tipo de dispositivo de tus dispositivos asociada 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. chevron_right para expandir Carga útil de tipo JSON.

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

Para iniciar el paquete de pruebas para un dispositivo específico, haz lo siguiente: 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 a que se complete la prueba. resultados.

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

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 eliminar una pestaña, haz clic en el Ícono de clear.

Usa el campo Select para seleccionar el componente de registro específico que deseas ver y el Menú desplegable Gravedad para mostrar solo las entradas con la gravedad de registro que coincida.

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 arrow_downward) y Buscar el anterior (ícono arrow_upward).
• 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.

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.