Notas de la versión del SDK de Android de las APIs de Home

2025-09-08

Se lanzó la versión 1.4.1 de la app de ejemplo para Android.

Nuevas funciones

• Crear, cambiar el nombre, actualizar y borrar una sala
• Comisionamiento a un tejido de Matter de terceros

Se corrigieron problemas conocidos

• Ahora funciona el vínculo a la página de revocación de permisos.

2025-08-29

  Versión beta pública 1.4.1 de las APIs de Home  

Esta versión contiene correcciones de errores y mejora la calidad de la versión beta del SDK de Android de las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 25.33.32
• Versiones mínimas de firmware de la bocina de Google:
  • Versión de Cast: 3.76.495998
  • Fuchsia: 27.20250422.103.3600
• SDK de Android: home.android.sdk_1_4_1
• App de Google Home: Funciona con cualquier versión
• Biblioteca de androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.0.0

Nuevas funciones

• API de Device
  • Se define un nuevo DecommissionIneligibleReason para intentar retirar del servicio un dispositivo de múltiples fuentes. Consulta Dispositivos de varias fuentes.

Problemas conocidos

• Cuando se quita por la fuerza el concentrador activo, hay un período de cinco minutos durante el cual no es posible controlar algunos dispositivos. Después de cinco minutos, se restablece la capacidad de controlar dispositivos.

Errores conocidos corregidos

• La app de ejemplo para Android falla cuando un usuario intenta configurar un termostato en un modo que no admite.

31/7/2025

  Lanzamiento de la versión beta pública 1.4.0 de las APIs de Home  

Esta versión contiene correcciones de errores y mejora la calidad de la versión beta del SDK de Android de las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 25.28.34
• Versiones mínimas de firmware de la bocina de Google:
  • Versión de transmisión: 3.76.486931
  • Fuchsia: 27.20250422.103.3600
• SDK de Android: home.android.sdk_1_4_0
• App de Google Home: Funciona con cualquier versión
• Biblioteca de androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.0.0

Nuevas funciones

• API de Automation
  • Las automatizaciones se pueden restringir para que se ejecuten hasta una cantidad finita de veces. Consulta Limita la cantidad de ejecuciones.

• API de Device
  • La capacidad de quitar un dispositivo Matter de forma programática Consulta Cómo quitar un dispositivo.
  • Se quitaron los siguientes miembros HomeDevice que habían dejado de estar disponibles:
    1. HomeDevice.trait(). Consulta Cómo acceder a dispositivos y metadatos de dispositivos para Android.
    2. HomeDevice.isInRoom. En su lugar, usa HomeDevice.roomId.
    3. HomeDevice.isInStructure. En su lugar, usa HomeDevice.structureId.
• API de Structure
  • Home.hasPermissions() ahora incorpora tanto el estado de autorización de OAuth para el usuario (acceso a la estructura) como los permisos otorgados a la aplicación.
• App de ejemplo para Android
  • Se reemplazaron las llamadas a la API obsoletas.
  • Cambiar el nombre de un dispositivo
  • Borrar dispositivos que solo son compatibles con Matter

Problemas conocidos

• Después de salir de un teléfono y volver a acceder, una app de las APIs de Home no puede controlar dispositivos.
  • Solución alternativa: Cierra la app o ejecútala en segundo plano y, luego, espera al menos 10 segundos antes de volver a intentarlo.

Errores conocidos corregidos

• Los dispositivos de aspiración que se conectaron no registran el estado Conectado.

8/7/2025

Con la versión de firmware 3.76.479819 de Cast, el Nest Wifi Pro ahora puede funcionar como unidad central de las APIs de Home.

26/6/2025

  Versión beta pública 1.3.2 de las APIs de Home  

Esta versión contiene correcciones de errores y mejora la calidad de la versión beta del SDK de las APIs de Home para Android.

Versiones mínimas

• Servicios de Google Play: 25.23.31
• Versiones mínimas de firmware de la bocina de Google:
  • Transmisión:
    • Google Home, Google Home Mini y Google Nest Mini: 3.75.468362
    • Google Nest Audio: 3.75.476451
  • Fuchsia: 26.20250116.103.2900
• SDK de Android: home.android.sdk_1_3_2
• App de Google Home: Funciona con cualquier versión
• Biblioteca de androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.0.0

Nuevas funciones

• El artefacto del SDK se dividió en dos artefactos separados:
  • El framework del SDK de las APIs de Home (play-services-home-17.0.0.aar)
  • Rasgos del SDK y tipos de dispositivos (play-services-home-types-17.0.0.aar)

  A partir de esta versión, los desarrolladores deben incluir ambos artefactos en las rutas de acceso a las bibliotecas de tiempo de compilación y de tiempo de ejecución de sus proyectos.

App de ejemplo para Android

• Los usuarios pueden desconectarse y revocar los permisos de la app.
• Se actualizaron los artefactos del SDK para incluir play-services-home-17.0.0 y play-services-home-types-17.0.0.

Problemas conocidos

• Los dispositivos de aspiración que se conectaron no registran el estado Conectado.

2025-06-05

  Versión beta pública 1.3.1 de las APIs de Home  

Esta versión contiene correcciones de errores y mejora la calidad de la versión beta del SDK de las APIs de Home para Android.

Versiones mínimas

• Servicios de Google Play: 25.19.32
• Versiones mínimas de firmware de la bocina de Google:
  • Versión de Cast: 3.75.468222
  • Fuchsia: 26.20250116.103.2201
• SDK de Android: home.android.sdk_202505_EAP_1_3_1_RC06
• App de Google Home: Funciona con cualquier versión
• Biblioteca de androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.0.0

Nuevas funciones

Rasgos

• Presenta el rasgo SyntheticSwitch, que simplifica el control de los eventos generados por los dispositivos Matter Switch y permite que los interruptores activen los iniciadores de automatización.
• El rasgo ExtendedDoorLock tiene un cambio que genera interrupciones: el tipo de datos del campo user_id se cambió de String a Long. Consulta
  • ExtendedDoorLockTrait.LockStateChange.user_id
  • ExtendedDoorLockTrait.PrivacyModeActor.user_id

  Las apps que usan este atributo deben volver a compilarse.

App de ejemplo para Android

Se agregaron funciones para registrar el estado de estructuras, dispositivos, tipos, rasgos y automatizaciones, lo que facilita la depuración.

Problemas conocidos

En la app de ejemplo para Android, el botón Create automation a veces requiere varios toques para activarse.

Se corrigieron problemas conocidos

• La app de Google Home falla con un FailedPreconditionException cuando se crean automatizaciones si la ubicación de la casa no está establecida en la app de Google Home (GHA) (consulta Cómo cambiar la dirección de tu casa de Google para saber cómo establecer la ubicación de una casa).
• En la app de ejemplo para Android, un dispositivo con connectivityState PARTIALLY_ONLINE se mostraba anteriormente al usuario como sin conexión. Este estado ahora se representa como en línea.

2025-05-12

  Versión beta pública 1.3 de las APIs de Home  

Esta versión contiene correcciones de errores y mejora la calidad de la versión beta del SDK de las APIs de Home para Android.

Versiones mínimas

• Servicios de Google Play: 25.16.33
• Versiones mínimas de firmware de la bocina de Google:
  • Versión de Cast: 3.75.468222
  • Fuchsia: 26.20250116.103.2201
• SDK de Android: home.android.sdk_202504_EAP_1_3_RC00
• App de Google Home: Funciona con cualquier versión
• Biblioteca de androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.0.0

Nuevas funciones

• API de Automation
  • Se agregó compatibilidad con los activadores de eventos programados recurrentes, que permiten a los desarrolladores crear automatizaciones que se ejecutan periódicamente según la hora del reloj, la hora solar y las condiciones basadas en el calendario, con expresiones de cron.
• API de Device
  • Se agregó la capacidad de cambiar el nombre de los dispositivos. Consulta Cómo cambiar el nombre de un dispositivo.
• API de Structure
  • Se agregó la capacidad de cambiar el nombre de las habitaciones. Consulta Cómo cambiar el nombre de una habitación.

Problemas conocidos

La app de Google Home falla con un FailedPreconditionException cuando se crean automatizaciones si la ubicación de la casa no está configurada en la app de Google Home (GHA) (consulta Cómo cambiar la dirección de Google Home para saber cómo hacerlo).

• Solución alternativa: Verifica que la dirección de la casa esté presente con la API de Discovery antes de intentar crear automatizaciones.

Se corrigieron problemas conocidos

• Es posible que aumente la latencia del control de dispositivos cuando cambies de Wi-Fi a una red móvil.
• Después de restablecer la configuración de fábrica de un concentrador, es posible que los dispositivos aparezcan sin conexión.

2025-04-09

  Versión beta pública 1.2.1 de las APIs de Home  

Esta versión contiene correcciones de errores y mejora la calidad de la versión beta del SDK de las APIs de Home para Android.

Versiones mínimas

• Servicios de Google Play: 25.09.33
• Versiones mínimas de firmware de la bocina de Google:
  • Versión de Cast: 3.75.468222
  • Fuchsia: 24.20241009.103.1900601¹
• SDK de Android: home.android.sdk_202503_EAP_1_2_1_RC02
• App de Google Home: Funciona con cualquier versión
• Biblioteca de androidx.core: 1.10.0
• Versión de Matter: 1.4.0.0

^{1. Actualmente, esta compilación se está lanzando en producción y estará disponible para todos los dispositivos el 22 de abril de 2025.}

Nuevas funciones

• Se mejoró el rendimiento al cargar objetos desde Home Graph.
• API de Automation
  • Se agregó compatibilidad con los filtros de entidades, que permiten que las automatizaciones seleccionen dispositivos de forma dinámica según los criterios especificados en la automatización.
• API de Device
  • La información del dispositivo de nube a nube ahora está disponible en BasicInformationTrait.

Problemas conocidos

• Es posible que aumente la latencia del control de dispositivos cuando cambies de Wi-Fi a una red móvil.
• Después de restablecer la configuración de fábrica de un concentrador, es posible que los dispositivos aparezcan sin conexión.

Errores conocidos corregidos

• Si se llama a la API de Discovery antes de la inicialización o antes de que esta se complete, se arroja un HomeException con code 14: UNKNOWN y el mensaje "No se encontró ninguna ruta".
• En un entorno que contiene varias estructuras y varios usuarios, cambiar entre estructuras y usuarios puede provocar que no se devuelva ningún dispositivo.

2025-03-14

  Versión beta pública de las APIs de Home 1.2.0  

Esta versión contiene correcciones de errores y mejora la calidad de la versión beta del SDK de las APIs de Home para Android.

Versiones mínimas

• Versión mínima de los Servicios de Google Play: 25.06.32
• Versiones mínimas de firmware del concentrador de Google:
  • Versión de Cast: 3.75.456944
  • Versión mínima de Fuchsia: 24.20241009.103.1900601
• SDK de Android: home.android.sdk_1_2_0_RC06
• Versión mínima de la app de Google Home: Funciona con cualquier versión
• Versión mínima de la biblioteca androidx.core: 1.10.0
• Versión de Matter: 1.3.0.0
  • Nota: No se admiten los tipos y clústeres de dispositivos Matter provisionales.

Nuevas funciones

• API de Automation:
  • Se agregó compatibilidad con los períodos y las fechas parciales en las condiciones de automatización. Consulta Cómo usar fechas con between.
  • En versiones anteriores, la API de Discovery devolvía un objeto NumberSetConstraint para algunos campos de mapa de bits cuando debería haber devuelto un objeto BitmapConstraint. Ahora, estos campos devuelven un BitmapConstraint según lo esperado. Esto se limita a los mapas de bits optionsMask y optionsOverride en los comandos del rasgo LevelControl.

Problemas conocidos

• Es posible que aumente la latencia del control de dispositivos cuando cambies de Wi-Fi a una red móvil.
• Después de restablecer la configuración de fábrica de un concentrador, es posible que los dispositivos aparezcan sin conexión.
• Si se llama a la API de Discovery antes de la inicialización o antes de que esta se complete, se arroja un HomeException con code 14: UNKNOWN y el mensaje "No se encontró ninguna ruta".
  • Solución alternativa: Llama a la API de Discovery solo cuando realmente necesites candidatos para la automatización. No se precargan ni se almacenan en caché las entidades candidatas. Comprueba si una entidad está en línea antes de llamar a los métodos de la API de Discovery en ella.
• En un entorno que contiene varias estructuras y varios usuarios, cambiar entre estructuras y usuarios puede provocar que no se devuelva ningún dispositivo.

Errores conocidos corregidos

• La primera vez que una app de las APIs de Home llama a HomeManager.structures() después de iniciarse, recibe cero estructuras, incluso cuando hay una o más estructuras presentes. Esto da la impresión incorrecta de que no hay estructuras asociadas con la Cuenta de Google.
• Es posible que los usuarios experimenten tiempos de espera prolongados al cargar, crear y editar automatizaciones.
• Los usuarios que inician el flujo de configuración desde la app de Cámara deben escanear el código QR dos veces para completar la puesta en servicio de Matter.
• En una estructura que contiene más de 200 dispositivos, es posible que la API de Discovery simplemente no devuelva candidatos.

2025-01-29

  Lanzamiento de la versión beta pública de las APIs de Home 1.1.0  

Esta versión contiene correcciones de errores y mejora la calidad de la versión beta del SDK de las APIs de Home para Android.

Versiones mínimas

• Versión mínima de los Servicios de Google Play: 25.02.32
• Versiones mínimas de firmware del concentrador de Google:
  • Versión de Cast: 3.75.456944
  • Versión mínima de Fuchsia: 24.20241009.103.1900500
• SDK de Android: home.android.sdk_202412_EAP_1_1_RC04
• Versión mínima de la app de Google Home: Funciona con cualquier versión
• Versión mínima de la biblioteca androidx.core: 1.10.0
• Versión de Matter: 1.3.0.0
  • Nota: No se admiten los tipos y clústeres de dispositivos Matter provisionales.

Nuevas funciones

• API de transmisión:
  • Proporciona flujos de eventos que notifican las estructuras, las habitaciones y los dispositivos que se agregaron, cambiaron y quitaron.
  • Consulta Cómo suscribirse a eventos de relación entre entidades.
• API de procesamiento por lotes (experimental):
  • Permite que el desarrollador envíe varios comandos en lotes que se ejecutan de forma simultánea.
  • Consulta Cómo enviar varios comandos a la vez.

Problemas conocidos

• Es posible que los usuarios experimenten tiempos de espera prolongados al cargar, crear y editar automatizaciones.
• Los usuarios que inician el flujo de configuración desde la app de Cámara deben escanear el código QR dos veces para completar la puesta en servicio de Matter.
• En una estructura que contiene más de 200 dispositivos, es posible que la API de Discovery simplemente no devuelva candidatos.

Errores conocidos corregidos

• Es posible que no se pueda cambiar la Cuenta de Google con la que accediste y que se genere un error.
• Es posible que los dispositivos Google TV no funcionen para las automatizaciones que usan el rasgo MediaPlayback.
• En una estructura que solo contiene un centro de Google, haz lo siguiente:
  • Es posible que los dispositivos Matter aparezcan sin conexión en la app de Google Home.
  • El Asistente de Google no puede controlar dispositivos Matter.
  • Las pantallas inteligentes no pueden controlar dispositivos Matter ni mostrar el estado de ningún dispositivo Matter.
• En algunos dispositivos, es posible que una app no siempre refleje el estado exacto, y tu app puede informar un estado diferente del que informa una app de Google, como la app de Google Home. Esto suele deberse a que los dispositivos no informan el estado a Google.
  • Solución alternativa: Verificar el estado con una app de Google resuelve la discrepancia.

2025-01-14

Se actualizó la guía para la inicialización de las APIs de Home.

Dejamos más claro que una instancia de Home se debe inicializar como un singleton de contexto. Esto garantiza una experiencia del usuario más fluida en tu app y evita errores con sesiones no válidas.

2025-01-07

  Lanzamiento de la versión beta pública de las APIs de Home  

Durante la versión beta pública para desarrolladores, todos los desarrolladores pueden comenzar a compilar y probar sus apps.

Esta versión contiene correcciones de errores y mejora la calidad de la versión beta del SDK de las APIs de Home para Android, incluida la compatibilidad mejorada con dispositivos Google Nest Audio y Google TV.

Versiones mínimas

• Versión mínima de los servicios de Google Play: 24.45.34
• Versiones mínimas de firmware del concentrador de Google:
  • Versión de Cast: 3.74.444798
  • Versión mínima de Fuchsia: 22.20240805.103.161
• SDK de Android: home.android.sdk_202411_EAP_1_0_1_RC00
• Versión mínima de la app de Google Home (GHA): Funciona con cualquier versión
• Versión mínima de la biblioteca androidx.core: 1.10.0
• Versión de Matter: 1.3.0.0
  • Nota: No se admiten los tipos de dispositivos ni los clústeres provisionales de Matter.

Problemas conocidos

• Es posible que no se pueda cambiar la Cuenta de Google con la que accediste y que se genere un error.
  • Solución alternativa: Vuelve a ejecutar el flujo de permisos o reinicia la app.
• Es posible que los dispositivos Google TV no funcionen para las automatizaciones que usan el rasgo MediaPlayback.
• En una estructura que solo contiene un centro de Google:
  • Es posible que los dispositivos Matter aparezcan sin conexión en la app de Google Home (GHA).
  • El Asistente de Google no puede controlar dispositivos Matter.
  • Las pantallas inteligentes no pueden controlar dispositivos Matter ni mostrar el estado de ningún dispositivo Matter.
• En el caso de algunos dispositivos, es posible que una app no siempre refleje el estado exacto, y tu app puede informar un estado diferente del que informa una app de Google, como la app de Google Home (GHA). Esto suele deberse a que los dispositivos no informan su estado a Google.
  • Solución alternativa: Verificar el estado con una app de Google resuelve la discrepancia.

Errores conocidos corregidos

• La puesta en marcha puede fallar si la app se minimiza durante el proceso.
  • Solución alternativa: Usa la suppressHalfSheetNotification() API para suprimir las notificaciones de media hoja cuando se usa la API de Commissioning en tu app.
• Un problema del servidor puede impedir que los activadores de Ok Google funcionen en las automatizaciones.
• Cuando se usa un concentrador que ejecuta Fuchsia y no tiene dispositivos Matter en la estructura, si el concentrador permanece inactivo durante más de 3 horas, la puesta en servicio del primer dispositivo Matter hace que este quede sin conexión.
• Después de restablecer la configuración de fábrica de un concentrador, es posible que fallen los comandos para los dispositivos recién comisionados, a pesar de que se informe que el dispositivo está en línea.