Extensión de Google Home para VS Code

Google Home Extension for Visual Studio Code se diseñó y creó para los desarrolladores de la plataforma de Google Home. Esta extensión te brinda acceso a Google Assistant Simulator, Google Cloud Logging, al visor de Home Graph y a otras herramientas para simplificar tu Matter y el proceso de desarrollo de la casa inteligente.

Extensión de Google Home para VS Code

Funciones de la extensión de Google Home

Simulador del Asistente de Google

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 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 según tus comandos, por ejemplo, "De acuerdo, encendiendo la luz" Consulta Cómo usar el simulador del Asistente de Google para obtener más detalles.

Expresiones por lotes

Para probar tu integración de Google Home como un autómata, puedes enviar expresiones por lotes al simulador del Asistente de Google ejecutando una secuencia de comandos de expresión. Consulta Cómo ejecutar expresiones por lotes para obtener más detalles.

Herramientas de registro de Matter

Las herramientas de registro de Matter pueden recopilar todos los registros relacionados con la depuración Matter, incluidos los registros Google Home app (GHA) y los registros de los Servicios de Google Play (GMS Core). Los registros se pueden ver en VS Code con filtros y búsquedas de palabras clave. Los registros se pueden descargar con información de depuración adicional, como Android y la versión de la app, y se pueden enviar a Google para informar problemas.

Registro de Matter de la extensión de Google Home

Cloud Logging

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 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 Home Graph

El visor de Home Graph ahora está disponible directamente en la Google Home Extension para que puedas verificar el estado del dispositivo en tu Home Graph dentro de VS Code. Consulta Visualiza Home Graph y ejecuta pruebas para obtener más detalles.

Instala la extensión de Google Home para VS Code

Para instalar Google Home Extension, sigue estos pasos desde VS Code:

  1. Haz clic en el ícono Extensiones en la barra de actividades.
  2. Busca google home y, luego, haz clic en Instalar.

    Google Home Extension Marketplace

También puedes descargar el Google Home Extension directamente desde el VS Code Marketplace.

Descargar Google Home Extension

Configura la extensión de Google Home para VS Code

Una vez que hayas instalado Google Home Extension y vuelto a cargar VS Code, deberás acceder y seleccionar un proyecto antes de poder usar Assistant Simulator y ver Cloud Logging.

Accede con Google y selecciona un proyecto de Cloud

Puedes acceder a tu cuenta de desarrollador desde Google Home Extension, lo que autoriza a VS Code a comunicarse con los servicios de Google en tu nombre.

  1. Haz clic en el ícono de Google Home en la barra de actividades para abrir Google Home Extension.

    Ícono de la extensión de Google Home
  2. Haz clic en Acceder con Google para iniciar la vista de acceso en tu navegador.

    Acceso con Google en VS Code
  3. Selecciona la cuenta vinculada a tus dispositivos de casa inteligente.

  4. En la página de autorización Acceder con Google, haz clic en Permitir.

  5. Se abrirá una pestaña del navegador y se mostrará un cuadro de diálogo Abrir Visual Studio Code. Haz clic en Abrir Visual Studio Code para continuar.

    Cuadro de diálogo Abrir VS Code
  6. 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.

    Permite que la extensión de Google Home abra un URI
  7. Después de acceder, Google Home Extension cargará tus proyectos. Una vez que lo hagas, haz clic en Selecciona un proyecto.

    Selecciona un proyecto
  8. En la ventana desplegable Buscar y seleccionar un proyecto que aparece, selecciona tu proyecto de casa inteligente.

Instala la herramienta Android Debug Bridge (ADB)

Para ver los registros de Matter en un Android teléfono, deberás instalar ADB:

  1. Instala ADB en tu computadora.
  2. Activa las opciones para desarrolladores y la depuración por USB en tu teléfono Android.

Instala las herramientas de SoC del dispositivo Matter

Para ver los registros de depuración de los dispositivos Matter, haz lo siguiente:

  1. La mayoría de los SoC de dispositivos exportarán puertos seriales como /dev/ttyUSBx en Linux o /dev/tty.SLAB_USBtoUART o /dev/tty.usbserial en macOS. LogViewer puede leer el registro directamente desde el dispositivo.
  2. Es posible que algunos tipos de SoC, como NXP o Silicon Labs, requieran 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

Visualiza los recursos para desarrolladores

En AYUDA Y COMENTARIOS, haz clic en Comenzar y recursos para abrir la página Recursos, donde puedes encontrar información útil para tu desarrollo con el ecosistema de Google Home.

Recursos para el ecosistema de Google Home

Usa el simulador del Asistente de Google

Para abrir Assistant Simulator en VS Code, haz clic en SIMULADOR DEL ASISTENTE DE GOOGLE en la barra lateral. En el cuadro Mensaje, escribe tu consulta y presiona Enter.

Puedes ver las respuestas de Assistant Simulator y hacer clic en el botón después de tu consulta para volver a enviarla.

Cómo usar Google Assistant Simulator

Ejecuta expresiones por lotes

Coloca el cursor sobre la barra de menú SIMULADOR DEL ASISTENTE DE GOOGLE y elige una de las siguientes opciones para configurar secuencias de comandos:

  • Haz clic en para abrir secuencias de comandos de expresión existentes.

  • Haz clic en para guardar el historial en una secuencia de comandos *.utterance script.

    Íconos del menú de Batch Utterances

Para comenzar a enviar expresiones por lotes, elige una de las siguientes opciones:

  • Haz clic en para seleccionar una secuencia de comandos de expresión en la ventana desplegable.
  • Abre directamente un archivo *.utterance y haz clic en .

    Ícono de ejecución de expresiones por lotes

Visualiza Cloud Logging

En ACCESO RÁPIDO, haz clic en Registros de Cloud para abrir la página Registros de Cloud, donde puedes encontrar los registros que pertenecen al proyecto seleccionado.

Usar Cloud Logging

Los usuarios pueden filtrar los registros según la gravedad y el período.

Cómo filtrar registros por gravedad y hora

De forma predeterminada, los registros están limitados a 50 filas. Si el usuario desea ver más registros, desplázate hacia abajo hasta la parte inferior y haz clic en Más para ver más registros.

Ver más registros

Visualiza Home Graph y ejecuta pruebas

En ACCESO RÁPIDO , haz clic en Visor de Home Graph para abrir el panel Visor de Home Graph , donde puedes encontrar los dispositivos que pertenecen al proyecto seleccionado. También puedes hacer clic en Ejecutar prueba para ejecutar pruebas en el dispositivo.

Visualizador de Home Graph

Se iniciará el paquete de pruebas en tu navegador con el dispositivo seleccionado y listo para probar. Haz clic en Iniciar y espera los resultados de la prueba.

Paquete de pruebas de Google Home

Puedes consultar los detalles de la prueba y ver los registros después de que se completen todas las pruebas.

Resultados de la prueba

Usa la extensión de Google Home para la depuración de Matter

Registro de Android

En HERRAMIENTAS DE REGISTRO DE MATTER, haz clic en Android Registros para abrir la página Android Registros, selecciona el Android teléfono al que deseas conectarte y comienza a mostrar registros.

Registro de Android

Una vez que se conecte el teléfono Android, podrás ver los registros línea por línea. Ten en cuenta que los registros están filtrados, lo que significa que solo se muestran los registros relacionados con el GHA y el Google Play services Matter módulo. También puedes configurar la Gravedad para filtrar los registros o Buscar la palabra clave en los registros.

Registro de Android filtrado

Registro de dispositivos Matter

En HERRAMIENTAS DE REGISTRO DE MATTER, haz clic en Registros del dispositivo para abrir la página Recursos, luego, selecciona Tipo de SoC:

Registro de dispositivos Matter

Luego, selecciona el dispositivo Matter:

Registro de dispositivos Matter: Selecciona un dispositivo

Luego, puedes obtener todos los registros del dispositivo y usar filtros como Gravedad y Buscar para encontrar la información que te interesa.

Registro filtrado de dispositivos Matter

Descarga todos los registros de Matter

En ACCESO RÁPIDO, haz clic en Descargar registros para abrir el Descargar registros diálogo, selecciona los registros que se descargarán y presiona Aceptar.

Descarga registros de asuntos

Selecciona la carpeta para descargar los registros y haz clic en Guardar:

Guardado del registro de Matter

Luego, los registros se guardarán en la carpeta de destino:

Carpeta de destino del registro de Matter

Extrae el archivo ZIP guardado. Se mostrará la información del dispositivo y los archivos de registro.

Archivo ZIP del registro de Matter

El archivo de información del dispositivo incluirá toda la información de la versión necesaria para depurar problemas.

Registro de depuración de Matter

Enviar comentarios

Para enviar tus ideas o comentarios sobre cómo podemos mejorar la experiencia de desarrollo con Google Home Extension, elige una de 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
Ícono de enviar comentarios
  • También proporcionamos un ícono de comentarios en la página Recursos.