Google Home Plugin for Android Studio está diseñado y creado para 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.
Aviso de seguridad
Para evitar que Android Studio almacene secretos y contraseñas, completa los siguientes pasos:
- Haz clic en Archivo y, luego, en Configuración....
- En Appearance & Behavior, expande System Settings y, luego, haz clic en Passwords.
- 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 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 la consola de Actions on Google 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, "De acuerdo, encendiendo 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 la acción. Para simplificar el desarrollo, Google Home Plugin muestra mensajes de 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.
Declaraciones 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.
- 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, puedes enviar declaraciones en lote a Assistant Simulator mediante la ejecución de secuencias de comandos de enunciados. 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 los dispositivos y, luego, iniciar el conjunto 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, archivos de registro de dispositivos Matter, registros de Google Home y registros de Android.
Instalar
Para instalar Google Home Plugin en Android Studio, sigue estos pasos:
- Descarga o actualiza Android Studio. Descargar Android Studio
- Ve a File > Settings (Android Studio > Preferences en MacOS).
- En la sección Plugins, ve a Marketplace y busca
google home. - Instala la herramienta y reinicia Android Studio.
También puedes descargar el complemento directamente desde JetBrains Marketplace.
Configuración
Una vez que instales 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 principal de Google y autorizar a Android Studio para que se comunique con los servicios de Google en tu nombre.
Haz clic en la pestaña Página principal de Google en la columna de la pestaña vertical que se encuentra en el lado izquierdo de la ventana Android Studio.
En Acceder con, haz clic en Google para iniciar el navegador.
Elige la cuenta que está vinculada con tus dispositivos de casa inteligente.
En la página de autorización de Acceder con Google, haz clic en Permitir.
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 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 conservan cuando sales de Android Studio.
Para obtener ayuda con los filtros del proyecto, 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 propiedades en el panel Google Home Plugin.
Hay 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 para volver a enviar al final de tu 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 realiza un seguimiento de tus consultas y respuestas en una caché almacenada. Volver a reproducir solo agrega respuestas nuevas a esta caché interna y no duplica tus consultas cada vez que haces clic en el botón.
Haz clic en Save para guardar las consultas y las respuestas que ingresaste en el panel Utterances. 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."
]
}
]
}
Recopila respuestas por lotes
En el panel Google Home Plugin, haz clic en Utterances File para abrir tus archivos JSON guardados en una pestaña nueva. En Select Path, puedes elegir un archivo o una carpeta. Si eliges una carpeta, Collect y Test funcionarán en todos los archivos .json de declaraciones en esa carpeta.
Puedes abrir varias pestañas del mismo archivo o de 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 de acceso al archivo .json de la declaración. 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 muestre un contador mientras se procesan las consultas.
Cuando se completa la Recopilación, la barra de estado se actualiza con una marca de verificación verde frente a tu ruta de acceso .json, y tus archivos de declaraciones 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 Detén la colección antes de tiempo, la ruta .json no se marcará como recopilada.
Probar enunciados 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 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 respuesta:
Expected one of: "Got it, turning on
2 lights."
Esta situación indica que una prueba no se realizó correctamente. De lo contrario, Assistant Simulator ejecutará cada una de tus consultas y mostrará una respuesta. Si la prueba se realizó correctamente, se mostrará una verificación de en la barra de estado.
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 registros de Cloud separadas para cada proyecto.
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 Usar QL para usar el 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 los registros por fecha también es opcional y se puede habilitar si haces 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 seleccionar 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 el
5/1/22y el6/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 tus parámetros de consulta.
Una vez que se carguen los registros, haz clic en cualquier registro para expandir la carga útil de JSON completa. Vuelve a hacer clic en 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 recuperación originales.
Ver el gráfico de inicio y ejecutar pruebas
Para mostrar tus dispositivos, selecciona Home Graph en el panel Google Home Plugin.
Haz clic en Refresh para mostrar los valores de Device name, Device ID y Device type de tus 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 de JSON completa.
También puedes usar las opciones Expandir y Contraer para mostrar y ocultar las cargas útiles de JSON de tus dispositivos.
Para iniciar el Conjunto de pruebas en un dispositivo específico, haz clic en Probar. Se iniciará 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.
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 una pestaña de proyecto en la ventana de herramientas de Registro de ADB, 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 de registro de ADB separadas 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 que coincida.
Para el registro de adb seleccionado, puedes filtrar las entradas de registro mediante el campo Filtrar 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 Raw para ver las entradas de registro sin procesar.
Recursos y comentarios
Haz clic en Recursos para ver una lista de recursos y herramientas 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.
