¡Atención! Pronto se lanzarán nuevos programas de vista previa para desarrolladores. Postúlate aquí y sé una de las primeras personas en probar herramientas nuevas y enviar comentarios.

Extensión de Google Home para VS Code

SDK del dispositivo

Google Home Extension for Visual Studio Code está diseñado y creado para desarrolladores de la plataforma de Google Home. Esta extensión te da acceso a Google Assistant Simulator, Google Cloud Logging, al visualizador de Home Graph y otras herramientas para simplificar tu proceso de desarrollo de casas inteligentes y de Matter.

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.

De forma similar al simulador existente que se proporciona en Actions Console, Assistant Simulator te permite controlar con facilidad los dispositivos escribiendo las consultas, por ejemplo, "Encender la luz". Dentro de VS Code, Assistant Simulator responde con mensajes de texto basados en tus comandos, por ejemplo, "Está bien, enciende la luz". Consulta Cómo usar el Simulador de Asistente de Google para obtener más detalles.

Declaración por lotes

Para probar tu integración de Google Home como un autómata, puedes enviar declaraciones por lotes al simulador de Asistente de Google ejecutando una secuencia de comandos de declaración. Consulta Ejecutar declaraciones 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 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 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 enviarse a Google para informar problemas.

Registro de Matter sobre extensiones 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, Google Home Extension muestra mensajes de Google Cloud Logging en tiempo real junto a tu código durante la solución de problemas. Consulta Ver Cloud Logging para obtener más información.

Visualizador de Home Graph

Home Graph Viewer ahora está disponible directamente en Google Home Extension para que puedas verificar el estado del dispositivo en Home Graph dentro de VS Code. Consulta Cómo ver el gráfico de inicio y ejecutar pruebas para obtener más detalles.

Cómo instalar 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.

    Mercado de extensiones de Google Home

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

Descarga Google Home Extension

Configura la extensión de Google Home para VS Code

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

Acceder con Google y seleccionar un proyecto de la nube

Puedes acceder a tu cuenta de desarrollador desde Google Home Extension y autorizar VS Code para que se comunique 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. Haga clic en Acceder con Google para iniciar la vista de acceso en su navegador.

    Acceso con Google en VS Code
  3. Selecciona la cuenta que está 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á el cuadro de diálogo Open Visual Studio Code. Haz clic en Abrir Visual Studio Code para continuar.

    Abrir el cuadro de diálogo de 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. Cuando termines, haz clic en Seleccionar un proyecto.

    Seleccionar un proyecto
  8. En la ventana desplegable Search and select a project (Buscar y seleccionar un proyecto) que aparece, selecciona tu proyecto de casa inteligente.

Instala la herramienta Android Debug Bridge (ADB).

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

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

Cómo instalar las herramientas del 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 del dispositivo exportarán puertos en serie, como /dev/ttyUSBx en Linux, o /dev/tty.SLAB_USBtoUART o /dev/tty.usbserial en macOS. El visor de registros puede leer el registro directamente desde el dispositivo.
  2. Algunos tipos de SoC, como NXP o Silicon Labs, pueden requerir que se instalen 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 HELP AND FEEDBACK, haz clic en Get Started & Resources para abrir la página Resources, donde puedes encontrar información útil para tu desarrollo con el ecosistema de Google Home.

Recursos para el ecosistema de Google Home

Cómo usar el Simulador de Asistente de Google

Para abrir Assistant Simulator en VS Code, haz clic en ASISTENTE DE GOOGLE en la barra lateral. En el cuadro Mensaje, escribe la 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 el Simulador de Asistente de Google

Ejecuta declaraciones por lotes

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

  • Haz clic en para abrir las secuencias de comandos de discurso existentes.

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

    Íconos del menú de declaraciones por lotes

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

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

    Ícono de ejecución de declaraciones por lotes

Ver Cloud Logging

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

Usa Cloud Logging

Los usuarios pueden filtrar los registros según la gravedad y el intervalo de tiempo.

Filtrar registros por gravedad y hora

De forma predeterminada, los registros tienen un límite de 50 filas. Si el usuario desea ver más registros, desplázate hacia abajo y haz clic en Más para ver más registros.

Ver más registros

Ver Home Graph y ejecutar pruebas

En ACCESO RÁPIDO, haz clic en Visualizador de Home Graph para abrir el panel Home Graph Viewer, en el que podrás encontrar los dispositivos que pertenecen al proyecto seleccionado. También puedes hacer clic en Run Test para ejecutar pruebas en el dispositivo.

Visualizador de Home Graph

Se iniciará el conjunto de pruebas en el navegador con el dispositivo seleccionado y listo para probar. Haga clic en Iniciar y espere los resultados de la prueba.

Conjunto de pruebas de Google Home

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

Resultados de la prueba

Usa la extensión de Google Home para depurar Matter

Registro de Android

En MATTER LOGGING TOOLS, haz clic en Android Logs para abrir la página Android Logs, selecciona el teléfono Android al que deseas conectarte y comienza a mostrar los registros.

Registro de Android

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

Se filtró el registro de Android

Registro de dispositivos Matter

En MATTER LOGGING TOOLS, haz clic en Device Logs para abrir la página Resources y selecciona SoC Type.

Registro de dispositivos de Matter

Luego, selecciona el dispositivo Matter:

Dispositivo de selección de registro de dispositivos Matter

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

Registro filtrado del dispositivo de Matter

Descargar 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 quieres descargar y presiona Aceptar.

Descargar registros de Matter

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

Guarda registros de Matter

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

Carpeta de destino de 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.

Depuración de registros de Matter

Enviar comentarios

Para enviar tus opiniones o comentarios sobre cómo podemos mejorar la experiencia de desarrollo con Google Home Extension, elige una de las siguientes opciones:

  • En el panel HELP AND FEEDBACK, haz clic en Enviar comentarios para darnos sugerencias.
  • En el panel HELP AND FEEDBACK, haz clic en Report Issue para denunciar 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.