El Google Home Plugin for Android Studio está diseñado y creado para desarrolladores de la plataforma Google Home. Este plugin te da acceso a Google Assistant Simulator, registro en la nube 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:
- Haga clic en Archivo, luego en Configuración....
- En Apariencia y comportamiento, expanda Configuración del sistema y luego haga clic en Contraseñas.
- Selecciona No guardar, olvidar contraseñas después de reiniciar.
Funciones
Simulador de Asistente
Para comprobar si sus dispositivos domésticos inteligentes funcionan correctamente con el ecosistema de Google Home, puede interactuar con Assistant Simulator en cualquier momento sin salir de Android Studio.
Assistant Simulator te permite controlar fácilmente tus dispositivos escribiendo tus preguntas, por ejemplo, "Enciende la luz". Dentro de Android Studio, Assistant Simulator responde con mensajes de texto según tus comandos, por ejemplo, "De acuerdo, encenderé la luz".
Visualiza Cloud Logging
Google Cloud Logging proporciona información de depuración y métricas clave para brindarle información sobre el uso de su Acción. Para simplificar el desarrollo, Google Home Plugin muestra mensajes Cloud Logging en tiempo real justo al lado de su código durante la resolución de problemas.
Puede visualizar registros en tiempo real o seleccionar un intervalo de fechas.
Expresiones por lotes
Las respuestas de Assistant Simulator a una sola expresión no son determinísticas. Por ejemplo, una respuesta podría ser cualquiera de las siguientes frases:
- Entendido, enciendo dos luces.
- Claro. Se encenderán 2 luces.
- Entendido, encendiendo 2 luces.
- Muy bien. Se encenderán 2 luces.
Para ejecutar pruebas automatizadas y verificar cómo funcionan tus integraciones de Google con estas diversas respuestas, puedes enviar varias expresiones a Assistant Simulator ejecutando secuencias de comandos de expresiones. Una vez que se guarda un script, puedes recopilar respuestas y ejecutar varias pruebas en tus búsquedas.
Visualizador de Home Graph
Home Graph Viewer 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)
Adb Log Viewer 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:
- Descargar o actualizar Android Studio. Descargar Android Studio
- Vaya a Archivo > Configuración (Android Studio > Preferencias en MacOS).
- En la sección Plugins, vaya a Marketplace y busque
google home. - 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 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 y autorizar a Android Studio para que se comunique 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.
Para Iniciar sesión con, haz clic en Google para abrir tu navegador.
Elige la cuenta que está vinculada a tus dispositivos domésticos inteligentes.
En la página de autorización Acceder con Google, haz clic en Permitir.
Cierra la ventana del navegador y regresa a Android Studio.
Ahora debería haber iniciado sesión, con la opción de Cerrar sesión.
Seleccione un proyecto en la nube
Después de acceder, selecciona un proyecto en el menú desplegable. Para filtrar la lista de proyectos, escribe una expresión de filtro, por ejemplo, matter y, luego, presiona Enter.
En el menú desplegable Project, se cargan los primeros 100 proyectos según tu Filter. Sus selecciones se conservarán al salir de Android Studio.
Para obtener ayuda con los filtros de proyectos, consulta Parámetros de consulta en la referencia de Google Cloud.
Utilice el simulador asistente
Para abrir el Assistant Simulator en Android Studio, haz clic en Panel de expresiones en el panel Google Home Plugin.
Existen varias formas de enviar consultas a Assistant Simulator. A continuación, analizaremos cada opción.
Escribir consultas y recopilar respuestas
Para interactuar con Assistant Simulator, escriba su consulta y presione Enter.
Para volver a enviar una pregunta, haz clic en el ícono de volver a enviar que se encuentra al final de la pregunta.
Después de enviar una o más consultas, haz clic en Repetir para volver a ejecutar tus consultas y verificar tus respuestas. El panel Expresiones hace un seguimiento de tus preguntas y respuestas en una caché almacenada. Replay solo agrega respuestas nuevas a esta caché interna y no duplicará tus búsquedas cada vez que hagas clic en el botón.
Haga clic en Guardar para guardar las consultas y respuestas que ha introducido en el panel Enunciados. Tus interacciones se convierten a JSON con el siguiente formato:
ask: Es tu búsqueda.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."
]
}
]
}
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. Para Seleccionar ruta, puede elegir un archivo o una carpeta. Si eliges una carpeta, Collect y Test funcionarán en todos los archivos de .json de esa carpeta.
Puedes abrir varias pestañas para el mismo archivo o para diferentes archivos, por ejemplo, lights, lights(1) y plug.
La barra de estado muestra el resultado de la última prueba (si corresponde), un punto amarillo o verde para indicar si se recopiló el archivo y la ruta de acceso al archivo de la expresión .json. Después de hacer clic en Recopilar, Assistant Simulator ejecutará tus consultas.
Se le notificará cuando se recoja una nueva respuesta y la Barra de estado muestra un contador mientras se procesan sus consultas.
Cuando se complete la acción Collect, la barra de estado se actualizará con una marca de verificación verde delante de la ruta de acceso .json, y tus archivos de expresión se completará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 Stop la recolección antes de tiempo, su .json ruta no se marcará como recolectada.
Probar enunciados de lotes
Una vez que hayas recopilado las respuestas, haz clic en Probar para volver a ejecutar las consultas y verificar las respuestas y los registros. Cuando pruebe las expresiones por lotes, Assistant Simulator espera las respuestas que se guardan en su archivo JSON. Si la prueba devuelve una respuesta que no se recopiló, recibirás una notificación similar a la siguiente:
Expected one of: "Got it, turning on
2 lights."
Este escenario indica que la prueba no ha tenido éxito. De lo contrario, Assistant Simulator ejecutará cada una de sus consultas y devolverá una respuesta. Si la prueba se realizó correctamente, aparecerá una marca de verificación en la barra de estado.
Visualiza Cloud Logging
Para abrir una pestaña del 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
En el proyecto seleccionado, también puedes filtrar los registros con el campo Consulta.
Por ejemplo, para filtrar los registros por una palabra clave de light:
Seleccione Usar QL para usar el lenguaje de consulta de registro .
Estos son 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 Después y Antes. Puedes escribir tu 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 al
5/1/22, selecciona Después de y haz clic en el ícono de fecha . - Para seleccionar una fecha anterior al
5/1/22, selecciona Antes de y haz clic en el ícono de fecha . - Para seleccionar una fecha entre
5/1/22y6/30/22, selecciona Antes y Después, y elige las fechas en el ícono de calendario .
Seleccione Tiempo real para obtener registros de proyectos en vivo. Haga clic en Detener para finalizar una transmisión en tiempo real.
Nivel de gravedad
También puede seleccionar Gravedad mínima del menú desplegable.
Resultados de la consulta
Haga clic en Fetch para enviar los parámetros de su consulta.
Una vez cargados los registros, haga clic en cualquier registro para expandir la carga útil JSON completa. Haga clic de nuevo para mostrar el mensaje completo.
De manera opcional, puedes escribir una palabra clave en el cuadro Filter para reducir los resultados del registro. Haz clic en x para eliminar el filtro y volver a los resultados de búsqueda originales.
Visualiza Home Graph y ejecuta pruebas
Para enumerar tus dispositivos, selecciona Home Graph en el panel Google Home Plugin.
Haga 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 varios paneles de Google Home Graph abiertos para proyectos separados.
Una vez cargados sus dispositivos, haga clic en cualquier registro para expandir la carga útil JSON completa.
También puede usar Expand y Collapse para mostrar y ocultar las cargas útiles JSON para sus dispositivos.
Para iniciar el conjunto de pruebas de un dispositivo específico, haz clic en Probar. Esto inicia el conjunto de pruebas en su navegador con su dispositivo seleccionado y listo para realizar las pruebas. 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.
Visor de registros de Android Debug Bridge (adb)
Para abrir una pestaña del proyecto en la ventana de la herramienta 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 registro de Adb separadas para cada uno de tus archivos de registro. Para eliminar una pestaña, haga clic en el icono .
Usa el campo Seleccionar para elegir un componente de registro específico que deseas ver y el menú desplegable Gravedad para mostrar solo las entradas con la gravedad de registro correspondiente.
En el registro de adb seleccionado, puedes filtrar las entradas de registro con el campo Filter y los modificadores opcionales Case-sensitive o Regex.
Además, puedes hacer lo siguiente:
- Busca entradas específicas con el campo Buscar y los comandos Buscar siguiente (ícono de ) y Buscar anterior (ícono de ).
- Usa los modificadores opcionales Case-sensitive o Regex.
- Saltar a la línea para saltar a una línea específica (por número) en el registro.
Seleccione 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 para ver 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 Comentarios.
