El Google Home Sample App for Matter usa el Google Home Mobile SDK para crear una app para Android similar a la Google Home app (GHA). Esta app de muestra proporciona las siguientes funciones:
- Comisionar dispositivos Matter físicos y virtuales Matter a la estructura local de Android
- Comisionar dispositivos físicos y virtuales a una estructura de desarrollo
- Controlar dispositivos en tu estructura de desarrollo, por ejemplo, encender una luz
- Las funciones de varios administradores te permiten compartir dispositivos en la estructura de desarrollo con otras apps y, a la inversa, poder incluir en la estructura de desarrollo dispositivos compartidos desde otras apps
- Utilidades para desarrolladores
En esta guía, se describe cómo instalar el Sample App for Matter APK y usar lo para comisionar, controlar y compartir Matter dispositivos.
Para descargar el código fuente, obtener información sobre cómo integrar el Mobile SDK, y personalizar pantallas en Android Studio, prueba nuestro Sample App for Matter codelab.
Ir al Sample App for Matter codelab
Requisitos previos
- Un dispositivo Android O (8.1, nivel de API 27) o posterior disponible para pruebas. Para asegurarte de que tu dispositivo tenga la compatibilidad más reciente con Matter, consulta la guía Matter Módulos y servicios.
- Compila un dispositivo Matter con capacidades de encendido y apagado. Esta app de muestra funciona con un dispositivo virtual y un ESP32.
- Dispositivo virtual de Matter (MVD). Para minimizar los problemas del entorno, te recomendamos que uses MVD para comenzar. Si alguna vez tienes problemas, será mucho más fácil investigar si la app de muestra se usa en MVD.
- Compila un Matter dispositivo virtual
con la app
rootnode_dimmablelight_bCwGYSDpoe. Cuando crees una Matter integración en Google Home Developer Console, usa0xFFF1como tu ID de proveedor y0x8000como tu ID de producto. - Compila un dispositivo Espressif
con
all-clusters-app. Cuando crees una integraciónMatter en Developer Console, usa0xFFF1como tu ID de proveedor y0x8001como tu ID de producto.
No necesitas una unidad central, por ejemplo, un Google Nest Hub (2nd gen), para comisionar y controlar dispositivos con la Sample App for Matter.
Instalar
Ve a la sección Releases del repositorio de GitHub .Sample App for Matter Para la versión más reciente, busca en la sección Assets el APK llamado
GHSAFM-version-default-debug.apk. No seleccionestargetcommissioner.Instala Android Debug Bridge (adb):
Conecta tu dispositivo Android con USB y habilita Transferencia de archivos y, luego, instala el APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Comisionar dispositivos
Cuando inicies la app de muestra por primera vez, verás un diálogo con un vínculo al Sample App for Matter codelab. Si seleccionas No volver a mostrar este mensaje, puedes volver a mostrar el diálogo en cualquier momento actualizando tus preferencias en la sección Admin de la app.
En los siguientes pasos, agregarás un dispositivo Matter a la estructura local de Android, junto con una estructura de desarrollo que es local solo para la app de muestra.
¿Qué son las estructuras de Matter?
Una estructura de Matter es un dominio de confianza compartido entre dispositivos en una red doméstica que les permite comunicarse entre sí.
Los dispositivos pueden tener una o más estructuras que corresponden a una plataforma, una app o un grupo de dispositivos que interactúan juntos. Las estructuras tienen un ID único, y los dispositivos comparten el mismo conjunto de credenciales y autoridad certificadora (AC). Estas credenciales se asignan durante Matter la comisión.
Para comisionar un dispositivo Matter, completa los siguientes pasos:
Presiona el botón Agregar dispositivo para iniciar el proceso de comisión.
A continuación, el control se transfiere a Google Play services, que se inicia desde una llamada a Mobile SDK. Para establecer una prueba de posesión, escanea el código QR o presiona Usar código de vinculación.
Cuando se complete la comisión, ingresa un nombre del dispositivo y, luego, presiona Listo.
Tu dispositivo ahora está conectado a la estructura local de Android y a la estructura de desarrollo.
Los Servicios de Play controlan todo el trabajo de comisión y las pantallas asociadas cuando se comisionan dispositivos.Play services Esto proporciona una experiencia del usuario coherente y elimina la necesidad de controlar permisos sensibles, por ejemplo, credenciales de Wi-Fi y Thread.
Controla dispositivos
La estructura de desarrollo crea las credenciales para controlar Matter dispositivos directamente desde la app de muestra.
En la pantalla principal, puedes activar o desactivar el dispositivo. Presiona el dispositivo para acceder a los detalles del dispositivo.
Compartir dispositivos
El uso compartido de un dispositivo se conoce como flujo de varios administradores en la Matter especificación. Una vez que se comisiona un dispositivo en la app de muestra, puedes compartirlo fácilmente con otros ecosistemas.
Para compartir tu dispositivo Matter con otros ecosistemas, deberás tener instalada otra plataforma en tu dispositivo Android. Esta plataforma externa se convierte en el comisionado de destino. Creamos otra instancia de la app de muestra que puedes usar como comisionado de destino.
Ve a la sección Releases del repositorio de GitHub .Sample App for Matter Para la versión más reciente, busca en la sección Assets el APK llamado
GHSAFM-version-targetcommissioner-debug.apk. No seleccionesdefault.Instala el comisionado de destino.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkEn la pantalla principal, presiona el dispositivo para mostrar la información del dispositivo. Presiona Compartir.
La app de muestra llama a la API de Share Mobile SDK y, una vez más, el control se transfiere a Play services.
Se muestra una hoja para compartir, lo que te permite elegir la app o la plataforma a la que quieres vincular el dispositivo. Esta pantalla te ofrece dos formas de compartir el dispositivo:
- Manualmente a través de un código de configuración que se compartirá con la app del comisionado de destino
- Con una app local para Android que se registró como Matter comisionado
La app del comisionado de destino está etiquetada como GHSAFM-TC. Presiona esta instancia de la app de muestra para compartir tu dispositivo.
A continuación, la app externa (comisionado de destino) completa la comisión del dispositivo en su propia estructura.
Configuración
En la pantalla principal, haz clic en el ícono de configuración . Aquí tienes las opciones para actualizar las preferencias del usuario, obtener ayuda y obtener más información sobre la app.
Notificación de hoja inferior
En la pantalla Configuración, puedes inhabilitar las notificaciones de descubrimiento proactivo comisionable para dispositivos Matter.
Si tu aplicación proporciona su propio Matter descubrimiento o flujo de comisión, es posible que desees suprimir estas notificaciones para evitar interrupciones. Consulta Cómo suprimir las notificaciones de descubrimiento comisionable para obtener más información.
Utilidades para desarrolladores
En la pantalla Configuración, también puedes acceder a Utilidades para desarrolladores.
Para revisar el contenido de los repositorios de Device y User Preferences DataStore en Logcat, completa los siguientes pasos:
Haz clic en Log repositories content.
Haz clic en Aceptar en el diálogo y, luego, marca Logcat.
Comentarios y ayuda
Para enviar tus ideas o comentarios sobre cómo podemos mejorar la experiencia de desarrollo con Sample App for Matter, completa nuestro formulario de comentarios.
Si tienes problemas con la Sample App for Matter, intenta completar los pasos para verificar tu entorno:
Si tienes preguntas sobre el uso de la app de muestra o descubres un error de código, puedes enviar problemas a la Herramienta de seguimiento de errores en el repositorio de GitHub:
Para obtener orientación oficial de Google sobre preguntas técnicas, usa el Foro para desarrolladores de Smart Home:
Para obtener asistencia técnica de la comunidad, usa la etiqueta google-smart-home en Stack Overflow: