Google Home Sample App for Matter uses the Google Home Mobile SDK to create an Android app that's similar to Google Home app (GHA) . This sample app provides the following features:
- Comisión física y virtual Matter devices to the Local Android fabric
- Asigna dispositivos físicos y virtuales a una estructura de desarrollo.
- Controlar los dispositivos de la tela de desarrollo, por ejemplo, encender una luz
- Las funciones de administrador múltiple te permiten compartir dispositivos en la estructura de desarrollo con otras apps y, por el contrario, poder incluirlos en los dispositivos de estructura de desarrollo compartidos desde otras apps.
- Utilidades para desarrolladores
En esta guía, se describe cómo instalar el APK Sample App for Matter y utilizarlo para encargar, controlar y compartir dispositivos Matter.
Para descargar el código fuente, aprender a integrar Mobile SDK y personalizar pantallas en Android Studio, prueba nuestro codelab Sample App for Matter.
Ir al codelab de Sample App for Matter
Requisitos previos
- Un dispositivo con Android O (8.1, nivel de API 27) o versiones posteriores disponible para pruebas. Para asegurarte de que tu dispositivo tenga la asistencia más reciente de Matter, consulta la guía Cómo verificar módulos y servicios de Matter.
- Compila un dispositivo
Matter con funciones de encendido y apagado. Esta app de muestra funciona con un dispositivo virtual y un ESP32.
- Compila un
dispositivo virtual Matter
con la app de
rootnode_dimmablelight_bCwGYSDpoe
. Cuando crees una integración de Matter en Google Home Developer Console , usa0xFFF1
como ID de proveedor y0x8000
como ID de producto. - Compila un dispositivo Espressif con el
all-clusters-app
. Cuando crees una integración de Matter en Developer Console, usa0xFFF1
como ID de proveedor y0x8001
como ID de producto.
- Compila un
dispositivo virtual Matter
con la app de
No necesitas un concentrador, por ejemplo, Google Nest Hub (2nd gen) , to commission and control devices with the Sample App for Matter.
Instalar
Ve a la sección Lanzamientos en el repositorio Sample App for Matter de GitHub. Ubica el APK llamado
GHSAFM-1.2.2-default-debug.apk
. No seleccionestargetcommissioner
:Instala Android Debug Bridge (adb):
Conecta tu dispositivo Android mediante USB y habilita la Transferencia de archivos y, luego, instala el APK:
$ adb unroot && adb install GHSAFM-1.2.2-default-debug.apk
Dispositivos de comisión
Cuando inicies la app de muestra por primera vez, verás un cuadro de diálogo con un vínculo al codelab Sample App for Matter. Si seleccionas No volver a mostrar este mensaje, puedes hacer que el diálogo regrese en cualquier momento si actualizas tus preferencias en la sección Administrador de la app.
En los próximos pasos, agregarás un dispositivo Matter a la estructura de Android local, junto con una estructura de desarrollo que sea local solo para la app de muestra.
¿Qué son las telas Matter?
Fabric es un dominio compartido de confianza entre dispositivos de una red doméstica que les permite comunicarse entre sí.
Los dispositivos pueden tener una o más estructuras que corresponden a una plataforma, app o grupo de dispositivos que interactúan entre sí. Las telas tienen un ID único y los dispositivos comparten el mismo conjunto de credenciales y autoridad certificada (CA). Estas credenciales se asignan durante la puesta en marcha de Matter.
Para encargar un dispositivo Matter, completa los siguientes pasos:
Presiona el botón
Agregar dispositivo para iniciar el proceso de puesta en marcha.A continuación, se transfiere el control a Google Play services , which is launched from a call to the Mobile SDK. To establish proof of possession, Scan QR code or tap Use pairing code.
Cuando se complete la comisión, ingresa un nombre de dispositivo y, luego, presiona Listo.
El dispositivo ahora está conectado al tejido de Android local y al de desarrollo.
Play services administra todos los trabajos de puesta en marcha y las pantallas asociadas. Esto proporciona una experiencia del usuario coherente y quita la necesidad de manejar permisos sensibles, como las credenciales de Wi-Fi y Thread.
Controla dispositivos
La estructura de desarrollo crea las credenciales para controlar los dispositivos Matter directamente desde la app de muestra.
En la pantalla principal, puedes activar o desactivar el dispositivo o apagar. Presiona el dispositivo para acceder a sus detalles.
Compartir dispositivos
El uso compartido de un dispositivo se denomina flujo de varios administradores en la especificación Matter. Una vez que el dispositivo se encarga a 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 responsable de destino.
Ve a la sección Lanzamientos en el repositorio Sample App for Matter de GitHub. Localiza el APK más reciente llamado
GHSAFM-[version]-targetcommissioner
, por ejemploGHSAFM-1.2.2-targetcommissioner-debug.apk
:Instala el comisionado objetivo.
$ adb unroot && adb install GHSAFM-1.0.1-targetcommissioner-debug.apk
En la pantalla principal, presiona el dispositivo para ver su información. Presiona Compartir.
La app de muestra llama a la API para compartir Mobile SDK y, una vez más, el control se transfiere a Play services.
Aparecerá una hoja para compartir, en la que podrás elegir la app o la plataforma con la que deseas sincronizar el dispositivo. En esta pantalla, se proporcionan dos formas de compartir el dispositivo:
- Manualmente, a través de un código de configuración para compartir con la aplicación de comisión encargada
- Con una app para Android local que se registró como comisionada de Matter
La aplicación de comisión encargada de destino tiene la etiqueta GHSAFM-TC. Presiona esta instancia de la app de muestra para compartir el dispositivo.
A continuación, la aplicación externa (comisionador de destino) completa la puesta en marcha 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 media hoja
En la pantalla Configuración, puedes inhabilitar las notificaciones proactivas del descubrimiento de comisión para los dispositivos Matter.
Si tu aplicación proporciona su propio flujo de descubrimiento o comisión de Matter, te recomendamos suprimir estas notificaciones para evitar interrupciones. Consulta Cómo suprimir las notificaciones de descubrimiento comisionables 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 Data Store y Device Preferences del usuario en Logcat, completa los siguientes pasos:
Haz clic en Contenido del repositorio de registros.
Haz clic en Aceptar en el cuadro de diálogo y, luego, marca Logcat.
Comentarios y ayuda
Si quieres compartir tu opinión o tus comentarios sobre cómo podemos mejorar la experiencia de desarrollo con Sample App for Matter, completa nuestro formulario de comentarios.
Si tienes problemas con el 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 casas inteligentes:
Para obtener asistencia técnica de la comunidad, usa la etiqueta google-smart-home
en Stack Overflow: