El 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, a Cloud Logging y a otras herramientas para simplificar tu proceso de desarrollo de casa inteligente.
Aviso de seguridad
Para evitar que Android Studio almacene secretos y contraseñas, completa los siguientes pasos:
- Haz clic en File y, luego, en Settings....
- En Appearance & Behavior, expande System Settings y, luego, haz clic en Passwords.
- Selecciona Do not save, forget passwords after restart.
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.
El 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 según 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 tu acción. Para simplificar el desarrollo, el 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.
Expresiones por lotes
Las respuestas de Assistant Simulator a una sola expresión no son deterministas. Por ejemplo, una respuesta podría ser cualquiera de las siguientes frases:
- Entendido, encendiendo 2 luces.
- Claro, encendiendo 2 luces.
- Entendido, encendiendo 2 luces.
- De acuerdo, encendiendo 2 luces.
Para ejecutar pruebas automatizadas y verificar cómo funcionan tus integraciones de Google con estas diversas respuestas, puedes enviar expresiones por lotes 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.
Lector de Home Graph
El lector de Home Graph te permite mostrar el estado de tus dispositivos y ejecutar Google Home Test Suite 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, por ejemplo Matter archivos de registro de dispositivos, registros de Google Home y registros de Android
Instalar
Para instalar el Google Home Plugin en Android Studio, sigue estos pasos:
- Descarga o actualiza Android Studio. Descarga 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 el 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 de Google Home, lo que autoriza a Android Studio a comunicarse con los servicios de Google en tu nombre.
Haz clic en la pestaña Google Home en la columna de pestañas verticales del lado izquierdo de la ventana Android Studio.
En Sign in with, haz clic en Google para iniciar tu navegador.
Elige la cuenta vinculada a tus dispositivos de casa inteligente.
En la página de autorización Acceder con Google, haz clic en Permitir.
Cierra la ventana del navegador y vuelve a Android Studio.
Ahora deberías haber accedido con la opción de Cerrar sesión.
Selecciona un proyecto de Cloud
Después de acceder, selecciona un Project en el menú desplegable. Para filtrar la lista de proyectos, escribe una expresión de 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 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 el Assistant Simulator en Android Studio, haz clic en Utterances Panel en el panel Google Home Plugin.
Existen varias maneras de enviar consultas al Assistant Simulator. A continuación, analizaremos cada opción.
Escribe consultas y recopila respuestas
Para interactuar con el Assistant Simulator, escribe tu consulta y presiona Intro.
Para volver a enviar una consulta, haz clic en el ícono de reenvío al final de la consulta.
Después de enviar una o más consultas, haz clic en Replay para volver a ejecutar tus consultas y verificar tus respuestas. El panel Utterances realiza un seguimiento de tus consultas y respuestas en una caché almacenada. Replay 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 para guardar las consultas y respuestas que ingresaste en el Utterances panel. Tus interacciones se convierten a JSON en el siguiente formato:
ask: Tu consulta.answers: Un array de posibles respuestas.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."
]
}
]
}
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 Select Path, puedes elegir un
archivo o una carpeta. Si eliges una carpeta, Collect y Test funcionarán en todos los archivos .json de expresiones de esa carpeta.
Puedes abrir varias pestañas para el mismo archivo o para archivos 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 de acceso del archivo .json de la expresión. Después de hacer clic en
Collect,
el 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 complete Collect, la barra de estado se actualizará con una marca de verificación verde delante de tu ruta de acceso .json, y tus archivos de expresiones se propagarán 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 detienes la recopilación antes de tiempo, tu ruta de acceso .json no se marcará como recopilada.
Prueba expresiones por lotes
Una vez que hayas recopilado tus respuestas, haz clic en Test para volver a reproducir tus consultas y verificar tus respuestas y registros. Cuando pruebas expresiones por lotes, el Assistant Simulator espera las respuestas que se guardan en tu archivo JSON file. Si tu 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."
Esta situación indica una prueba fallida. 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.
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 Cloud Log independientes para cada uno de tus proyectos.
Términos de búsqueda
Para el proyecto seleccionado, también puedes filtrar los registros con el campo Query.
Por ejemplo, para filtrar registros de una palabra clave de light, haz lo siguiente:
Selecciona Use QL para usar el lenguaje de consulta de Logging.
A continuación, se incluyen algunos ejemplos de consultas de QL para ayudarte 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 After y Before. 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 seleccionar la fecha y, luego, ingresar la hora en el campo de texto.
- Para seleccionar una fecha posterior a
5/1/22, selecciona After y haz clic en el ícono de fecha . - Para seleccionar una fecha anterior al
5/1/22, selecciona Before y haz clic en el ícono de fecha . - Para seleccionar una fecha entre
5/1/22y6/30/22, selecciona Before y After , y elige las fechas en el ícono de fecha .
Selecciona Real time para recuperar los registros de proyectos en vivo. Haz clic en Stop para finalizar un feed en tiempo real.
Nivel de gravedad
También puedes seleccionar una Minimal Severity en el menú desplegable.
Resultados de la consulta
Haz clic en Fetch para enviar los parámetros de la 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 Filter para acotar los resultados del registro. Haz clic en la x para quitar el filtro y volver a los resultados de recuperación originales.
Ver Home Graph y ejecutar pruebas
Para enumerar tus dispositivos, selecciona Home Graph en el Google Home Plugin panel.
Haz clic en Refresh almacenado en caché para mostrar el Device name, el Device id y el Device type de los dispositivos asociados con el proyecto seleccionado. Puedes tener varios Google Home Graph paneles abiertos para proyectos independientes.
Una vez que se carguen los dispositivos, haz clic en cualquier registro para expandir la carga útil de JSON completa.
También puedes usar Expand y Collapse para mostrar y ocultar las cargas útiles de JSON de tus dispositivos.
Para iniciar Test Suite en un dispositivo específico, haz clic en Test. Esto inicia Test Suite en tu navegador con el dispositivo seleccionado y listo para probar. Haz clic en Start 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 Adb Log, haz clic en el comando Adb Log en la barra de herramientas del complemento de Google Home (a la izquierda). Puedes abrir pestañas de Adb Log independientes para cada uno de tus archivos de registro. Para borrar una pestaña, haz clic en el ícono.
Usa el campo Select para seleccionar un componente de registro específico para ver y el menú desplegable Severity para mostrar solo las entradas con la gravedad de registro correspondiente.
Para el registro de adb seleccionado, puedes filtrar las entradas de registro con el campo Filter con los modificadores opcionales Case-sensitive o Regex.
Además, puedes hacer lo siguiente:
- Encuentra entradas específicas con el campo Find y los comandos Find Next ( icon) y Find Previous ( icon).
- Usa los modificadores opcionales Case-sensitive o Regex.
- Jump to line para ir a una línea especificada (por número) en el registro.
Selecciona Numbered 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 Resources para obtener una lista de herramientas y recursos para desarrolladores.
Para enviar tus ideas o comentarios sobre cómo podemos mejorar la experiencia de desarrollo con Google Home Plugin, haz clic en Feedback.
