Google Home Plugin for Android Studio is designed and created for Google Home Platform developers. This plugin gives you access to Google Assistant Simulator, Cloud Logging, and other tools to simplify your smart home development process.
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 Apariencia y comportamiento, expande Configuración del sistema y, luego, haz clic en Contraseñas.
- Selecciona No guardar, olvida 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.
Es similar al simulador de Asistente existente que se proporciona en Actions on Google Console Console, Assistant Simulator enables you to easily control your devices by typing your queries, for example, "Turn on the light." Inside Android Studio, Assistant Simulator responds back with text messages based on your commands, for example, "Alright, turning on the light.".
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.
Declaraciones por lotes
Las respuestas 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, encendiendo 2 lámparas.
- Entendido. Encendiendo 2 lámparas.
- Muy bien, encendiendo 2 lámparas.
Para ejecutar pruebas automatizadas y verificar cómo funcionan tus integraciones de Google con estas respuestas, puedes enviar declaraciones por lotes al Assistant Simulator mediante la ejecución de 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
Home Graph Viewer te permite mostrar el estado de tus dispositivos y, luego, iniciar el Conjunto de pruebas de Google Home en tu navegador.
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 Complementos, ve a Marketplace y busca
google home. - Instala la herramienta y reinicia Android Studio.
Configuración
Una vez que hayas instalado 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 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 la pestaña vertical del lado izquierdo de la ventana Android Studio.
En Acceder con, haga clic en Google para iniciar su navegador.
Elige la cuenta que esté 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 regresa a Android Studio.
Debería haber accedido, con la opción Salir.
Selecciona un proyecto de Cloud
Después de acceder, selecciona un Proyecto del menú desplegable. Para filtrar la 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 de proyectos, consulta Parámetros de consulta en la Referencia de Google Cloud.
Usar el simulador del Asistente
Para abrir el Assistant Simulator en Android Studio, haz clic en Panel de declaraciones en el panel Google Home Plugin.
Existen varias formas de enviar consultas a Assistant Simulator. A continuación, analizaremos cada opción.
Escribe consultas y recopila respuestas
Para interactuar con Assistant Simulator, escribe tu consulta y presiona Intro.
Puedes volver a enviar una consulta si haces clic en el ícono de reenviar al final de tu consulta.
Después de enviar una o más consultas, haz clic en Volver a reproducir para volver a ejecutar las consultas y verificar tus respuestas. El panel Utterances (Registro de declaraciones) realiza un seguimiento de las consultas y respuestas 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 botón.
Haz clic en Guardar para guardar las consultas y las respuestas que ingresaste en el panel Declaraciones. 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."
]
}
]
}
Recopilar respuestas por lotes
En el panel Google Home Plugin, haz clic en Archivo de declaraciones para abrir los archivos JSON guardados en una pestaña nueva. En Seleccionar ruta de acceso, puedes elegir un archivo o una carpeta. Si eliges una carpeta, Collect y Test funcionarán en todas las declaraciones .json 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 se recopiló el archivo y la ruta del archivo de declaraciones .json. Después de hacer clic en Recopilar, Assistant Simulator ejecuta tus consultas.
Se te notificará cuando se recopile una respuesta nueva, y la barra de estado mostrará un contador mientras se procesen tus consultas.
Cuando se completa la acción Collect, la Barra de estado se actualiza con una marca de verificación verde delante de la ruta de acceso .json, y los archivos de declaración se propagan 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 declaraciones de lote
Una vez que hayas recopilado tus respuestas, haz clic en Probar para volver a reproducir tus consultas y verificar tus respuestas y registros. Cuando pruebas las declaraciones por lotes, Assistant Simulator espera las respuestas que se guardan en el archivo JSON. Si la 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 que la prueba no se realizó correctamente. De lo contrario, Assistant Simulator ejecutará cada una de tus consultas y mostrará una respuesta. Si la prueba tuvo éxito, 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 Logging, haz clic en Registros de Cloud en el panel Google Home Plugin. Puedes abrir pestañas de Cloud Logging por separado para cada uno de tus proyectos.
Términos de búsqueda
Para tu proyecto seleccionado, también puedes filtrar registros con el campo Query (Consulta).
Por ejemplo, para filtrar registros por una palabra clave de light, haz lo siguiente:
Selecciona Usar QL para usar el lenguaje de consulta de Logging.
Aquí encontrarás 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 los registros por fecha también es opcional y se puede habilitar si haces 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 fechas para seleccionar tu 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 a
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 del ícono de fecha .
Selecciona En tiempo real para obtener los registros del proyecto 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 Obtener para enviar los parámetros de consulta.
Una vez que se carguen los registros, haz clic en cualquier registro para expandir la carga útil completa de JSON. Haz clic nuevamente en para mostrar el mensaje completo.
De manera opcional, puedes escribir una palabra clave en el cuadro Filtrar para limitar los resultados del registro. Haz clic en x para quitar el filtro y volver a los resultados de la recuperación originales.
Ver Home Graph y ejecutar pruebas
Para enumerar tus dispositivos, selecciona Home Graph en el panel Google Home Plugin.
Haz clic en Refresh a fin de mostrar el Nombre del dispositivo, el ID del dispositivo y el Tipo de dispositivo de tus dispositivos asociados con el proyecto seleccionado. Puedes tener varios Google Home Graph panels open for separate projects.
Una vez que se carguen los dispositivos, haz clic en cualquier registro para expandir la carga útil completa de JSON.
También puedes usar Expandir y Contraer para mostrar y ocultar las cargas útiles JSON para tus dispositivos.
Para iniciar el Conjunto de pruebas en un dispositivo específico, haz clic en Probar. Se iniciará el conjunto de pruebas en tu navegador con el dispositivo seleccionado y listo para realizar pruebas. 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.
Recursos y comentarios
Haz clic en Recursos para ver una lista de herramientas y recursos para desarrolladores.
Para enviar tus opiniones o comentarios sobre cómo podemos mejorar la experiencia de desarrollo con el Google Home Plugin, haz clic en Comentarios.
