El programa de desarrolladores de Google Home permite a los fabricantes de dispositivos conectar sus dispositivos de casa inteligente con el ecosistema de Google Home. Ampliaremos la ruta de entrega local de Acciones de la casa inteligente con la capacidad de agregar dispositivos compatibles con Matter para configurarlos con Google Home app (GHA) y controlarlos con Google Assistant, GHA o pantallas inteligentes como Google Nest Hub (2nd gen).
En esta documentación, se describe cómo comenzar a compilar e integrar una plataforma compatible con Matter en el ecosistema de Google Home.
Renuncias de responsabilidad
En relación con los procedimientos que se describen en la documentación de Matter, ten en cuenta lo siguiente:
- Recomendamos que la cuenta que se use para el desarrollo tenga solo un conmutador habilitado para Matter conectado para las pruebas. Si se conectan varios concentradores compatibles con Matter al mismo tiempo o a la misma estructura durante las pruebas, es posible que se produzca un comportamiento impredecible.
- En todos los procedimientos, se supone que se usa una máquina Linux que ejecuta Ubuntu 20.04 para compilar y actualizar muestras de Matter, que Google probó. Si bien se admiten máquinas macOS, se recomienda usar Linux. Las instrucciones específicas para Mac se indican en los procedimientos según sea necesario.
Cómo compilar
Para compilar un dispositivo compatible con Matter que se integre con el e ecosistema de Google Home, trabajarás con una placa de desarrollo compatible con Matter y el SDK de Matter.
La forma más sencilla de comenzar es revisar nuestros codelabs. Te recomendamos que realices al menos uno de los siguientes codelabs:
Habilita la entrega local para integraciones de nube a nube
49 minutos
Updated 21 de diciembre de 2024
Descubre cómo habilitar la entrega local con el SDK de Local Home para mejorar las integraciones de casas inteligentes con Asistente.
Conecta dispositivos de casa inteligente a Asistente de Google
35 minutos
Updated 23 de noviembre de 2024
Compila e implementa una integración de nube a nube para integrar una lavadora inteligente virtual al Asistente.
Cómo depurar la casa inteligente
25 minutos
Updated 23 de noviembre de 2024
Aprende a usar las métricas y los registros de GCP para identificar y resolver problemas de producción. Aprende a usar el conjunto de pruebas para identificar problemas funcionales y de API.
Métricas basadas en registros para casa inteligente
16 minutos
Updated 23 de noviembre de 2024
Aprende a usar las métricas basadas en registros en Google Cloud para hacer un seguimiento de los patrones y analizar los registros de errores de la integración de Casa Inteligente.
Depuración de la página principal local
50 minutos
Updated 23 de noviembre de 2024
Aprende a usar las métricas y los registros de GCP para identificar y resolver problemas de producción. Aprende a usar el conjunto de pruebas para identificar problemas funcionales y de API. Aprende a usar las herramientas para desarrolladores de Chrome mientras desarrollas tu app de Local Home.
Mejora y protege tus integraciones de nube a nube
50 minutos
Updated 23 de noviembre de 2024
Aprende a mejorar y proteger tu integración de nube a nube mediante rasgos de dispositivos personalizables y la autenticación de dos factores.
Cómo implementar CameraStream con WebRTC
23 minutos
Updated 23 de noviembre de 2024
Obtén información sobre cómo transmitir de una cámara web a una pantalla Google Nest con la característica CameraStream y WebRTC.
Supervisión de interrupciones en casas inteligentes
31 minutos
Updated 21 de noviembre de 2024
En este codelab, aprenderás a detectar interrupciones mediante la configuración de alertas automáticas en tu integración de casa inteligente.
Cómo depurar apps de receptores de transmisión
59 minutos
Updated 9 de noviembre de 2024
En este codelab, agregarás Cast Debugger Logger a tu app existente de Custom Web Receiver.
Agrega compatibilidad en vivo a un receptor de transmisión
30 minutos
Updated 9 de noviembre de 2024
En este codelab, compilarás una aplicación de receptor web personalizada que usa la API de Cast Live.
Cómo agregar compatibilidad con la API de pausas publicitarias para un receptor web
56 minutos
Updated 9 de noviembre de 2024
En este codelab, compilarás una aplicación de receptor web personalizada que usa la API de pausas publicitarias de Cast.
Cómo habilitar la compatibilidad de una app web con Cast
1 hora 18 minutos
Updated 9 de noviembre de 2024
En este codelab, modificarás una app de video web existente para transmitir contenido en un dispositivo compatible con Google Cast.
Cómo habilitar la transmisión de contenido en una app para Android
2 horas 48 minutos
Updated 9 de noviembre de 2024
En este codelab, modificarás una app de video de Android existente para transmitir contenido en un dispositivo compatible con Google Cast.
Cómo compilar un receptor web personalizado
1 hora 37 minutos
Updated 9 de noviembre de 2024
En este codelab, compilarás una app de receptor web personalizada para reproducir contenido en dispositivos compatibles con Cast.
Cómo habilitar la transmisión de contenido en una app de Android TV
1 hora 8 minutos
Updated 9 de noviembre de 2024
En este codelab, modificarás una app de Android TV existente para que admita la transmisión y la comunicación desde tus apps emisoras de Cast existentes.
Depura integraciones de Matter
36 minutos
Updated 6 de noviembre de 2024
Aprende a solucionar problemas relacionados con integraciones de Matter con herramientas de estadísticas y obtén más información sobre los recursos de asistencia para desarrolladores.
Cómo compilar una aplicación web con Acceso a dispositivos
1 hora
Updated 13 de octubre de 2024
En este Codelab aprenderás sobre el funcionamiento de Acceso a dispositivos y diseñarás una aplicación web que administra la autenticación y las llamadas a la API de Smart Device Management para un termostato Nest Thermostat.
Compilar una app de Android para Matter
1 hora 17 minutos
Updated 20 de septiembre de 2024
Personaliza la app de muestra de Google Home para asuntos y administración de dispositivos.
Cómo habilitar la transmisión de una app para iOS
2 horas 28 minutos
Updated 11 de septiembre de 2024
En este codelab, modificarás una app de video para iOS existente a fin de transmitir contenido en un dispositivo compatible con Google Cast.
Cómo compilar un dispositivo Matter
1 hora 17 minutos
Updated 22 de agosto de 2024
En este codelab, compilarás, asignarás y usarás un dispositivo Matter.
Compila un dispositivo virtual Matter
1 hora 12 minutos
Updated 22 de agosto de 2024
En este codelab, compilarás, ejecutarás y usarás un dispositivo virtual de Matter.
Compila una app receptora de transmisión básica
Updated 17 de mayo de 2021
En este codelab crearás una app receptora compatible con Cast mediante el framework de aplicaciones de Google Cast.
Luego, consulta nuestra lista de dispositivos compatibles para asegurarte de que lo que planeas integrar sea compatible con el ecosistema de Google Home. Luego, lee la Lista de tareas del desarrollador para comprender todo el flujo de desarrollo, desde la creación del proyecto hasta el lanzamiento.
Dispositivos compatibles Lista de tareas para desarrolladores
Definiciones
En esta documentación, se usan los siguientes términos:
- Router de borde
- Un concentrador que implementa un router de borde Thread de uso general para dispositivos compatibles con Thread.
- Hub
- Un dispositivo Google Nest compatible, como el Google Nest Hub (2nd gen). Se requiere una unidad central para controlar dispositivos compatibles con Matter a través de otras plataformas, como Assistant, GHA y pantallas inteligentes.
- Dispositivo compatible con Matter
- Un dispositivo o una placa de desarrollo que se haya escrito en la memoria flash con una compilación o una app de ejemplo habilitada para Matter.
- Dispositivo móvil
- El teléfono de prueba que se usa para ayudar con la vinculación. Actualmente, es un teléfono Android.
Requisitos previos
Para integrar por completo un dispositivo compatible con Matter con el ecosistema de Google Home, un desarrollador debe tener lo siguiente:
- Un concentrador de Google compatible con Thread que funcione como router de borde para dispositivos compatibles con Thread y como ruta de entrega local para enrutar intents de casa inteligente.
- Un dispositivo móvil (teléfono de prueba) que cumpla con los requisitos mínimos:
- Android O (8.1, nivel de API 27 o versiones posteriores)
- iOS (v16.5 o versiones posteriores)
- Función BLE
- Un ID de proveedor (VID) y un ID de producto (PID) para el dispositivo habilitado para Matter
- Un dispositivo compatible con Matter Este dispositivo debe ser uno de los tipos de dispositivos Matter compatibles con el ecosistema de Google Home y puede ser uno de los siguientes:
- Tu propio producto con firmware habilitado para Matter
- Uno de los siguientes dispositivos Matter para usar en la verificación de extremo a extremo:
Proveedor | Plataforma | Asistencia de Thread | Guía |
---|---|---|---|
Bouffalo Lab | BL602 | ||
BL702 | |||
Espressif | ESP32 | Pruebas OTA | |
Nordic Semiconductor | nRF52840 DK | Pruebas OTA | |
NXP | Kit de desarrollo IOTZTB-DK006 | ||
Realtek | Ameba D Series | ||
Silicon Labs | Kit de desarrollo EFR32MG24 | ||
Kit de inicio de Zigbee y Thread para EFR32MG | |||
Telink | TLSR9518 | ||
Texas Instruments | Kit de desarrollo de LaunchPad CC2652R7 |
ID del proveedor
De forma predeterminada, puedes usar uno de los VID que asignó CSA con fines de prueba. Selecciona una de las siguientes opciones: 0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
.
Para usar un VID de producción de modo que se pueda certificar y lanzar tu integración, primero debes verificarlo con Google para asegurarte de que la CSA te lo haya emitido.
Este VID se debe implementar en el firmware de tu dispositivo.
Un dispositivo Matter solo se puede vincular en el ecosistema de Google Home en ciertas situaciones de ID de proveedor y tipo de dispositivo.
- No se puede usar un VID de prueba en un dispositivo para consumidores.
- El VID de producción debe ser emitido por Connectivity Standards Alliance (Alliance). Google verificará que eres el propietario de ese VID antes de que puedas usarlo en Google Home Developer Console. Una vez que eso suceda, podrás crear integraciones para ese VID.
- Para fines de desarrollo y Field Trial, se deben crear un proyecto y una integración con la combinación de VID y PID correspondiente en Developer Console. El usuario que comisiona el dispositivo debe ser miembro del proyecto o estar incluido en la lista de usuarios de Field Trial.
- Los usuarios consumidores solo pueden usar tu producto una vez que la Alliance lo haya certificado.
El VID y el PID solo se pueden usar una vez para una integración. Si deseas usar el mismo VID o PID en tu integración, debes hacer lo siguiente:
- Edita la integración con el VID o PID a un VID o PID diferente.
- Borra la integración con el VID o el PID.
¿Qué tipos de usuarios pueden encargar el dispositivo en el ecosistema de Google Home? | |||
---|---|---|---|
Tipo de VID | Certificación de VID y estado de integración de la consola | Producción
(Usuarios consumidores) |
Desarrollo
(Desarrolladores, usuarios de Field Trial) |
Prueba | No hay integración en Developer Console (no se puede certificar) | ||
Prueba | La integración existe en Developer Console (no se puede certificar) | ||
Producción | No está certificada, la integración no existe en Developer Console | ||
Producción | No está certificada, pero la integración existe en Developer Console | ||
Producción | Certificado en la DCL de Alliance, la integración no existe en Developer Console | ||
Producción | Está certificado en el DCL de Alliance y la integración existe en Developer Console |
ID del producto
La información sobre el dispositivo se lee del clúster de información básica Matter. El ID de producto codificado en el firmware de tu dispositivo debe coincidir con el ID de producto de la integración de Matter en Play Console.
Características no compatibles
Algunos clústeres de Matter aún no están expuestos a los usuarios, aunque el sistema puede usarlos. En la mayoría de los casos, esto significa que los atributos expuestos a través de estos clústeres no son visibles para los usuarios finales:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
¹ Consulta Interruptores de luz de encendido y apagado para ver cómo esto afecta a los interruptores de luz de encendido y apagado.