Google Home Sample App for Matter usa Google Home Mobile SDK a fin de crear una app para Android que sea similar a Google Home app (GHA). Esta app de ejemplo proporciona las siguientes funciones:
- Comisión de dispositivos Matter virtuales y físicos a la estructura local de Android
- Asigna dispositivos físicos y virtuales a una estructura de desarrollo.
- Controlar dispositivos en la tela 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, por el contrario, puedes incluirlos en esos dispositivos compartidos desde otras apps.
- Utilidades para desarrolladores
En esta guía, se describe cómo instalar el APK Sample App for Matter y usarlo para asignar, 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 Matter más reciente, revisa la guía Cómo verificar Matter módulos y servicios.
- Compila un dispositivo Matter con funciones de activación y desactivación. Esta app de ejemplo funciona con un dispositivo virtual y un ESP32.
- Compila un dispositivo virtual Matter con la app
rootnode_dimmablelight_bCwGYSDpoe
. Cuando crees una integración 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 tu ID de proveedor y0x8001
como tu ID de producto.
- Compila un dispositivo virtual Matter con la app
No necesitas un concentrador (por ejemplo, un Google Nest Hub (2nd gen)) para asignar y controlar dispositivos con Sample App for Matter.
Instalar
Ve a la sección Versiones del repositorio Sample App for Matter de GitHub. Ubica el APK llamado
GHSAFM-1.4.1-default-debug.apk
. No seleccionestargetcommissioner
:Instala Android Debug Bridge (adb):
Conecta tu dispositivo Android mediante USB, habilita la Transferencia de archivos y, luego, instala el APK:
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
Dispositivos de comisión
Cuando inicies la app de ejemplo por primera vez, verás un 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 vuelva a aparecer 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 de desarrollo que solo es local para la app de ejemplo.
¿Qué son las telas Matter?
Una estructura Matter 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, una app o un 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 de certificación (CA). Estas credenciales se asignan durante la puesta en marcha de Matter.
Para asignar un dispositivo Matter, completa los siguientes pasos:
Presiona el botón
Agregar dispositivo para iniciar el proceso de puesta en marcha.A continuación, el control se transfiere a Google Play services, que se inicia a partir de una llamada a Mobile SDK. Para demostrar la posesión, escanea el código QR o presiona Usar código de vinculación.
Cuando se complete la asignación, ingrese un Nombre del dispositivo y, luego, presione Listo.
Tu dispositivo ahora está conectado a la estructura local de Android y a la de desarrollo.
Play services se encarga de todo el trabajo de puesta en marcha y las pantallas asociadas cuando se ponen en marcha los dispositivos. Esto proporciona una experiencia del usuario coherente y quita 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 los dispositivos Matter directamente desde la app de ejemplo.
En la pantalla principal, puedes activar o desactivar el dispositivo. Presiona el dispositivo para acceder a sus detalles.
Compartir dispositivos
Compartir un dispositivo se conoce como flujo de varios administradores en la especificación Matter. Una vez que un dispositivo se encarga a la app de ejemplo, puedes compartirlo fácilmente con otros ecosistemas.
Para compartir tu dispositivo Matter con otros ecosistemas, deberás tener otra plataforma instalada en tu dispositivo Android. Esta plataforma externa se convierte en el comisionador de destino. Creamos otra instancia de la app de ejemplo que puedes usar como encargado de destino.
Ve a la sección Versiones del repositorio Sample App for Matter de GitHub. Busca el APK más reciente llamado
GHSAFM-[version]-targetcommissioner
, por ejemplo,GHSAFM-1.4.1-targetcommissioner-debug.apk
:Instala el comisionado de destino.
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
En la pantalla principal, presiona el dispositivo para ver su información. Presiona Compartir.
La app de ejemplo llama a la API de Mobile SDK Share y, una vez más, el control se transfiere a Play services.
Se mostrará una hoja para compartir que te permitirá elegir la app o la plataforma con la que deseas sincronizar el dispositivo. En esta pantalla, se proporcionan dos formas de compartir el dispositivo:
- De forma manual, a través de un código de configuración que se compartirá con la app de comisiones objetivo
- Con una app para Android local registrada como comisionado de Matter
La aplicación de comisiones objetivo está etiquetada como GHSAFM-TC. Presiona esta instancia de la app de ejemplo para compartir el dispositivo.
A continuación, la app 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í podrás actualizar las preferencias del usuario, obtener ayuda y obtener más información sobre la app.Notificación de media hoja
En la pantalla de configuración, puedes inhabilitar las notificaciones proactivas de descubrimiento comisionables para los dispositivos Matter.
Si tu aplicación proporciona su propio flujo de detección o puesta en marcha de Matter, te recomendamos que suprimas estas notificaciones para evitar interrupciones. Consulta Cómo suprimir notificaciones comisionables de descubrimiento 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 Dispositivo y Preferencias de usuario de DataStore en Logcat, completa los siguientes pasos:
Haz clic en Contenido del repositorio de registros.
Haz clic en OK en el diálogo y, luego, marca Logcat.
Comentarios y ayuda
Completa nuestro formulario de comentarios para enviar tus comentarios o sugerencias sobre cómo podemos mejorar la experiencia de desarrollo con Sample App for Matter.
Si tienes problemas con Sample App for Matter, intenta completar los pasos para verificar tu entorno:
Si tienes preguntas sobre el uso de la app de ejemplo o descubres un error de código, puedes enviar problemas a la Herramienta de seguimiento de errores en el repositorio de GitHub:
Si deseas 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: