Extensión de Google Home para VS Code

SDK de Local Home de Matter de nube a nube

Google Home Extension for Visual Studio Code se diseñó y creó para los desarrolladores de Google Home Platform. 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 casas inteligentes.

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 inteligentes para el hogar 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 Cómo ver 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 Cómo ver Home Graph 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.

    Google Home Extension Marketplace

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

Descargar Google Home Extension

Cómo configurar 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 en la nube

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 inteligentes para el hogar.

  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 Seleccionar un proyecto.

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

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

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

Cómo usar la extensión de Google Home para VS Code

Cómo ver 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

Cómo usar 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

Cómo ejecutar 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

Cómo ver 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 y haz clic en Más.

Ver más registros

Cómo ver Home Graph y ejecutar 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

Cómo usar 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, y, primero, 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

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