Matter Cloud-to-cloud Local Home SDK
Google Home Extension for Visual Studio Code está diseñado y creado para desarrolladores de la plataforma Google Home. Esta extensión te brinda acceso a Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer y otras herramientas para simplificar tu proceso de desarrollo de Matter y de la casa inteligente.
Funciones de la extensión de Google Home
Simulador del Asistente de Google
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 VS Code.
Assistant Simulator te permite controlar fácilmente tus dispositivos escribiendo tus consultas, por ejemplo, "Enciende la luz." Dentro de VS Code, Assistant Simulator responde con mensajes de texto basados en tus comandos, por ejemplo, "De acuerdo, encendiendo la luz." Consulte Use Google Assistant Simulator para obtener más detalles.
Enunciados por lotes
Para probar la integración de Google Home como un autómata, puede enviar enunciados por lotes a Google Assistant Simulator ejecutando un script de enunciados. Consulte Ejecutar enunciados por lotes para obtener más detalles.
Herramientas de registro de materia
Las herramientas de registro de Matter pueden recopilar todos los registros relacionados con la depuración de Matter, incluidos los registros de Google Home app (GHA) y los registros de los Servicios de Google Play (GMS Core). Los registros se pueden visualizar en VS Code mediante filtros y búsquedas por palabras clave. Los registros se pueden descargar con información de depuración adicional, como Android y la versión de la aplicación, y se pueden enviar a Google para informar sobre problemas.
Cloud Logging
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 Extension muestra mensajes de Google Cloud Logging en tiempo real junto a tu código durante la solución de problemas. Consulta Visualiza Cloud Logging para obtener más detalles.
Visor de gráficos de inicio
Home Graph Viewer ahora está disponible directamente en Google Home Extension para que pueda verificar el estado del dispositivo en su Home Graph dentro de VS Code. Consulta Cómo ver Home Graph y ejecutar pruebas para obtener más detalles.
Instala la extensión de Google Home para VS Code
Para instalar Google Home Extension, siga estos pasos desde VS Code:
- Haz clic en el ícono de Extensiones en la barra de actividades.
Busque
google home, luego haga clic en Instalar.
También puedes descargar Google Home Extension directamente desde el VS Code Marketplace.
Descarga Google Home Extension
Configurar la extensión de Google Home para VS Code
Una vez que haya instalado Google Home Extension y recargado VS Code, deberá iniciar sesión y seleccionar un proyecto antes de poder usar Assistant Simulator y ver Cloud Logging.
Inicia sesión con Google y selecciona un proyecto en la nube.
Puedes iniciar sesión en tu cuenta de desarrollador desde Google Home Extension, autorizando a VS Code a comunicarse con los servicios de Google en tu nombre.
Haz clic en el ícono de Google Home en la barra de actividades para abrir Google Home Extension.
Haz clic en Iniciar sesión con Google para abrir la vista de inicio de sesión en tu navegador.
Selecciona la cuenta vinculada a tus dispositivos inteligentes para la casa.
En la página de autorización Acceder con Google, haz clic en Permitir.
Se abrirá una pestaña del navegador y se mostrará un cuadro de diálogo Open Visual Studio Code. Haz clic en Abrir Visual Studio Code para continuar.
Se te redireccionará a VS Code, donde se requiere tu permiso para permitir que la extensión de Google Home abra un URI. Haz clic en Abrir para finalizar el proceso de acceso.
Después de acceder, Google Home Extension cargará tus proyectos. Cuando termines, haz clic en Seleccionar un proyecto.
En la ventana desplegable Search and select a project que aparece, selecciona tu proyecto de casa inteligente.
Instala la herramienta Android Debug Bridge (ADB)
Para ver los registros de Matter en un teléfono Android, deberás instalar ADB:
- Instala ADB en tu computadora.
- Activa las opciones para desarrolladores y la depuración por USB en tu teléfono Android.
Instala las herramientas de SoC de dispositivos Matter
Para ver los registros de depuración de los dispositivos Matter, haz lo siguiente:
- La mayoría de los SoCs de dispositivos exportarán puertos seriales, como
/dev/ttyUSBxen Linux o/dev/tty.SLAB_USBtoUARTo/dev/tty.usbserialen macOS. El LogViewer puede leer el registro directamente desde el dispositivo. - Algunos tipos de SoC como NXP o Silicon Labs pueden requerir la instalación de herramientas externas (por ejemplo, JLink). Consulta Dispositivos compatibles para obtener más información.
Usa la extensión de Google Home para VS Code
Ver recursos para desarrolladores
En AYUDA Y COMENTARIOS, haz clic en Comenzar y recursos para abrir la página Recursos, en la que encontrarás información útil para tu desarrollo con el ecosistema de Google Home.
Utiliza el simulador del Asistente de Google
Para abrir Assistant Simulator en VS Code, haz clic en SIMULADOR DE ASISTENTE DE GOOGLE en la barra lateral. En el cuadro Mensaje, escribe tu consulta y presiona Enter.
Puedes ver las respuestas Assistant Simulator y hacer clic en el botón después de tu consulta para Reenviarla.
Ejecutar Batch Utterances
Coloca el cursor sobre la barra de menú GOOGLE ASSISTANT SIMULATOR y elige una de las siguientes opciones para configurar secuencias de comandos:
Haz clic en para abrir los guiones de expresiones existentes.
Haga clic en para guardar el historial en un script
*.utterance.
Para comenzar a enviar expresiones por lotes, elige una de las siguientes opciones:
- Haz clic en para seleccionar un guion de expresión en la ventana desplegable.
Abra directamente un archivo
*.utterancey haga clic en .
Visualiza Cloud Logging
En ACCESO RÁPIDO, haga clic en Registros en la nube para abrir la página Registros en la nube, donde podrá encontrar los registros pertenecientes al proyecto seleccionado.
Los usuarios pueden filtrar los registros según la gravedad y el intervalo de tiempo.
De forma predeterminada, los registros se limitan a 50 filas. Si el usuario desea ver más registros, desplázate hasta la parte inferior y haz clic en Más.
Ver gráfico de inicio y ejecutar pruebas
En ACCESO RÁPIDO, haz clic en Visor de Home Graph para abrir el panel Visor de Home Graph, en el que puedes encontrar los dispositivos que pertenecen al proyecto seleccionado. También puedes hacer clic en Ejecutar prueba para ejecutar pruebas en el dispositivo.
Se iniciará el paquete de pruebas en tu navegador con el dispositivo seleccionado y listo para la prueba. Haz clic en Iniciar y espera los resultados de la prueba.
Puedes consultar los detalles de la prueba y ver los registros después de que se completen todas las pruebas.
Utilice la extensión Google Home para la depuración de Matter.
Registro de Android
En HERRAMIENTAS DE REGISTRO DE MATTER, haga clic en Android Registros para abrir la página Android Registros, seleccione el Android teléfono al que desea conectarse y comience a mostrar los registros.
Una vez conectado el teléfono Android, podrá ver los registros línea por línea. Ten en cuenta que los registros se filtran, lo que significa que solo se muestran los registros relacionados con GHA y el módulo Google Play services Matter. También puede configurar Severity para filtrar los registros o Search la palabra clave en los registros.
Registro de dispositivos Matter
En HERRAMIENTAS DE REGISTRO DE MATTER, haz clic en Registros del dispositivo para abrir la página Recursos y, primero, selecciona Tipo de SoC:
A continuación, selecciona el dispositivo Matter:
Luego, puedes obtener todos los registros del dispositivo y usar filtros como Severity y Search para encontrar la información que te interesa.
Descarga todos los registros de Matter
En ACCESO RÁPIDO, haz clic en Descargar registros para abrir el diálogo Descargar registros, selecciona los registros que se descargarán y presiona Aceptar.
Seleccione la carpeta para descargar los registros y haga clic en Guardar:
Luego, los registros se guardarán en la carpeta de destino:
Extrae el archivo ZIP guardado. Se mostrarán la información del dispositivo y los archivos de registro.
El archivo de información del dispositivo incluirá toda la información de la versión necesaria para depurar problemas.
Enviar comentarios
Para enviar sus ideas o comentarios sobre cómo podemos mejorar la experiencia de desarrollo con Google Home Extension, elija entre las siguientes opciones:
- En el panel AYUDA Y COMENTARIOS, haz clic en Enviar comentarios para enviarnos sugerencias.
- En el panel AYUDA Y COMENTARIOS, haz clic en Informar un problema para informar cualquier problema que hayas encontrado con Google Home Extension.
- También proporcionamos un ícono de comentarios en la página Recursos.