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

2026-05-01

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

En esta versión, se corrigieron errores y se mejoró la calidad de la versión beta del SDK de Android de las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 26.16.31
• Firmware del centro de Google, Cast y Nest Wifi Pro: 3.78.518349
• Firmware del centro de Google, Cast y todos los demás centros basados en Cast: 3.78.526062
• Firmware del concentrador de Google, Fuchsia: 30.20260121.103.1602802
• Firmware del concentrador de Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK de Android: home.android.sdk_GHP_1_8_1
• App de Google Home: 4.8 o versiones posteriores
• Biblioteca androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.1.0
• Versión de Matter: Compatibilidad experimental con la versión 1.5.0

Nuevas funciones

• El rasgo Thermostat ahora admite las capacidades de lectura/actualización, encendido/apagado y temporizador

Errores conocidos corregidos

• Es posible que falle la asignación de un dispositivo Matter.
• La luz BLE de Philips no muestra el estado correcto.
• La latencia provoca inestabilidad en la red y tiempos de respuesta lentos.

Problemas conocidos

• No se pueden encargar algunos dispositivos con el Google TV Streamer 4K.
• Cuando el dispositivo central es un Nest Wifi Pro, un Google Nest Hub o un Google Nest Hub Max, la app de Google Home muestra los dispositivos multipartes como varias tarjetas.

2026-04-10

Se actualizó la app de ejemplo para Android de las APIs de Home con el lanzamiento de las APIs de Home 1.8.

App de ejemplo

• Consulta la versión 1.8.0 de GitHub para ver las notas de la versión completas.

2026-04-09

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

En esta versión, se corrigieron errores y se mejoró la calidad de la versión beta del SDK de Android de las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 26.12.32
• Firmware del centro de Google, Cast y Nest Wifi Pro: 3.78.518349
• Firmware del centro de Google, Cast y todos los demás centros basados en Cast: 3.78.526062
• Firmware del Google Hub, Fuchsia: 29.20251023.103.2101601
• Firmware del concentrador de Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK de Android: home.android.sdk_GHP_1_8_0
• App de Google Home: Funciona con cualquier versión
• Biblioteca androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.1.0
• Versión de Matter: Compatibilidad experimental con la versión 1.5.0

Nuevas funciones

• Automatizaciones sugeridas en la API de Automations.
• Se agregó compatibilidad con dispositivos multipartes en la API de Devices.
• Se configuró la zona de actividad de la cámara y el timbre en la API de Device.
• Configuración de la detección de sonido de la cámara y el timbre en la API de Device.
• Modo de grabación de la cámara y el timbre (CVR/EVR/Sin historial) en la API de Device.

Errores conocidos corregidos

• No se pueden cambiar las unidades de temperatura (C/F) del Google Nest Learning Thermostat (4ª gen.).
• En la versión para dispositivos móviles de Google Home para la Web, el ícono superior y el botón Atrás están ocultos por un encabezado. Es posible que los usuarios no puedan volver atrás o ver elementos clave de la interfaz de usuario.
• Es posible que un centro de Android TV informe de forma incorrecta que los dispositivos Matter están "sin conexión".

Problemas conocidos

• Es posible que falle la asignación de un dispositivo Matter.

2026-03-13

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

En esta versión, se corrigieron errores y se mejoró la calidad de la versión beta del SDK de Android de las APIs de Home.

Versiones mínimas

• Servicios de Google Play:
• Firmware del centro de Google, Cast y Nest Wifi Pro: 3.78.518349
• Firmware del Google Hub, Cast y todos los demás hubs basados en Cast: 3.78.516526
• Firmware del concentrador de Google, Fuchsia: 29.20251023.103.2201
• Firmware del concentrador de Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK de Android: home.android.sdk_GHP_1_7_1
• App de Google Home: 1.7.1
• Biblioteca androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.1.0
• Versión de Matter: Compatibilidad experimental con la versión 1.5.0

Nuevas funciones

• Se agregó la opción de habilitar las estadísticas de la cámara y el timbre en la API de Device.
• Hora de la última conexión de la cámara y el timbre en la API de Device.
• Estado de conectividad de la cámara y el timbre en la API de Device.
• Solicitudes atómicas de termostatos en la API de Device.

Otros cambios importantes

• Se quitó el modo sin concentrador.

App de ejemplo

• App de ejemplo de las APIs de Home para Android v1.7.1. Consulta la versión de GitHub para obtener más detalles.

Errores conocidos corregidos

• En el caso de la Nest Cam Indoor/Outdoor (con batería o con cable) y el Nest Doorbell (con batería, 2ª gen.), la opción "Tiempo restante de la batería" no está presente en la configuración de la batería.
• Se ignora el parámetro de configuración de duración del sonido.
• La luz BLE de Philips aparece incorrectamente como "En línea" incluso cuando el dispositivo está sin conexión.

Problemas conocidos

• No se pueden cambiar las unidades de temperatura (C/F) del Google Nest Learning Thermostat (4ª gen.).
• Posibles retrasos en la estabilidad de la red y la capacidad de respuesta del dispositivo
• En la versión para dispositivos móviles de Google Home para la Web, un encabezado oculta el ícono superior y el botón Atrás. Es posible que los usuarios no puedan volver atrás o ver elementos clave de la interfaz de usuario.
• Es posible que el dispositivo Hub se quede en el estado "Conectando…" después de la OOBE en el modo federado.
• Es posible que falle la asignación de un dispositivo Matter.
• Es posible que un centro de Android TV informe de forma incorrecta que los dispositivos Matter están sin conexión.
• Es posible que no aparezca la versión de software correcta en Current Camera Device Software version.
• Un control deslizante de la IU del termostato muestra temperaturas fuera del rango.
• Cuando se establece la duración del timbre, el dispositivo no suena durante el período especificado.

2026-02-13

Se actualizó la app de ejemplo para Android de las APIs de Home con el lanzamiento de las APIs de Home 1.7.

App de ejemplo

• Consulta la versión 1.7.0 de GitHub para ver las notas de la versión completas.

2026-02-09

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

En esta versión, se corrigieron errores y se mejoró la calidad de la versión beta del SDK de Android de las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 26.02.34
• Firmware del centro de Google, Cast y Nest Wifi Pro: 3.76.508025
• Firmware del Google Hub, Cast y todos los demás hubs basados en Cast: 3.77.510748
• Firmware del Google Hub, Fuchsia: 29.20251023.103.2100
• Firmware del concentrador de Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK de Android: home.android.sdk_GHP_1_7
• App de Google Home: 1.7
• Biblioteca androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.1.0
• Versión de Matter: Compatibilidad experimental con la versión 1.5.0

Nuevas funciones

• Automatizaciones locales: Basadas en condiciones como la conectividad, los tipos de dispositivos y los rasgos, algunas automatizaciones ahora pueden ejecutarse de forma local en la API de Automations.
• Se habilitó la primera experiencia de uso (OOBE) de la cámara en las apps de la API de Device.
• Temas de campanilla de cámara y timbre en la API de Device.
• Ahorro de batería automático para cámaras y timbres en la API de Device.
• Preferencias de uso de la batería de la cámara y el timbre en la API de Device.
• Estado de carga de la batería de la cámara y el timbre en la API de Device.
• Niveles de batería de la cámara y el timbre en la API de Device.
• Número de serie de la cámara y el timbre en la API de Device.
• Modelo de cámara y timbre en la API de Device.
• Versión de software de la cámara y el timbre en la API de Device.
• API de clave-valor personalizada en la API de Device.
• La consulta de permisos permite que una app determine a qué tipos de dispositivos el usuario otorgó acceso en la API de Permissions.

Otros cambios importantes

• HomeException.unsupported se reemplazó por HomeException.unimplemented para alinearse con los códigos de error estándar.
• El generador de código empaquetado para rasgos personalizados cambió en la versión 1.7. Los desarrolladores que tienen rasgos personalizados deben volver a compilar sus rasgos una vez que hayan integrado el SDK 1.7.

Errores conocidos corregidos

• La API de History siempre devuelve un objeto nextPageToken, lo que provoca un bucle infinito.
• Se produce el error "El usuario canceló el flujo de permisos" cuando se intenta acceder a una cuenta nueva.

Problemas conocidos

• En el caso de la Nest Cam Indoor/Outdoor (con batería o con cable) y el Nest Doorbell (con batería, 2ª gen.), la opción "Tiempo restante de la batería" no está presente en la configuración de la batería.
• Se ignora el parámetro de configuración de duración del sonido.
• La luz BLE de Philips aparece incorrectamente como "En línea" incluso cuando el dispositivo está sin conexión. Solución alternativa: No confíes solo en el estado en línea del tipo de dispositivo inteligente para la casa (SHDT). En su lugar, usa el mapa del servicio de estado del dispositivo de destino (TDSS) para los dispositivos con la fuente LOCAL_SYNC.

2025-12-22

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

En esta versión, se corrigieron errores y se mejoró la calidad de la versión beta del SDK de Android de las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 25.47.30
• Firmware del centro de Google, Cast y Nest Wifi Pro: 3.75.479819
• Firmware del centro de Google, Cast y todos los demás centros basados en Cast: 3.77.505721
• Firmware del Google Hub, Fuchsia: 28.20250723.103.2100300
• Firmware del concentrador de Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK de Android: home.android.sdk_GHP_1_6
• App de Google Home: 1.6
• Biblioteca androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.1.0

Nuevas funciones

• Se agregó compatibilidad con el rasgo Weather de la API de Automation. Se agregó compatibilidad con el rasgo Weather en los activadores y las condiciones de automatización.
• Compatibilidad con más funciones de dispositivos de cámaras y timbres: Nuevos parámetros de configuración (Visión nocturna, LED de estado, Ventana gráfica, Orientación, Sensibilidad, Duración del evento, Sonido).
• Inicio de sesión con Google iniciado por la app para optimizar el flujo de UX y eliminar las verificaciones de usuarios activos.
• El modo sin unidad central permite a los usuarios incorporar y controlar ciertos dispositivos Matter sin una unidad central independiente.
• API de Hub Activation para descubrir y activar hubs.

Otros cambios importantes

• La app de ejemplo de Android agrega la configuración de la cámara, las automatizaciones predefinidas y la compatibilidad con ventiladores y bocinas.

Problemas conocidos

• Los controles de dispositivos dejan de funcionar después de períodos de uso prolongados. Solución alternativa: Reinicia la unidad central.
• Es posible que falle la asignación del dispositivo Matter.
• Aparece el error "El usuario canceló el flujo de permisos" cuando se intenta agregar una cuenta nueva en la app de ejemplo para Android. Solución alternativa: Agrega Cuentas de Google a través de la configuración del dispositivo Android.
• Una cámara de seguridad con cable onn de Walmart encargada con el SDK de las APIs de Home para Android no puede transmitir en vivo a través de la app de Google Home.
• Las cámaras que se ponen en funcionamiento en las apps de las APIs de Home no pueden iniciar sesiones de transmisión en vivo desde la app de Google Home.

2025-10-23

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

En esta versión, se corrigieron errores y se mejoró la calidad de la versión beta del SDK de Android de las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 25.41.30
• Firmware del dispositivo central de Google, Cast: 3.76.495998
• Firmware del centro de Google, Fuchsia: 27.20250422.103.3600
• SDK de Android: home.android.sdk_1_5_1
• App de Google Home: Funciona con cualquier versión
• Biblioteca androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.1.0

Nuevas funciones

• La API de Hub activation te permite descubrir y activar de forma programática un dispositivo Google Home Hub en la API de Structure.

Otros cambios importantes

• La app de ejemplo para Android agregó compatibilidad con el tipo de dispositivo Doorbell (encendido/apagado, transmisión en vivo, conversación bidireccional) y la implementación de la API de Hub Activation.

Errores conocidos corregidos

• La app de ejemplo no muestra correctamente el estado del dispositivo en la vista Device.

2025-09-26

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

En esta versión, se incluye compatibilidad con dispositivos de cámara, se corrigieron errores y se mejoró la calidad de la versión beta del SDK de Android para las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 25.37.31
• Firmware del centro de Google, Cast: 3.76.492738
• Firmware del centro de Google, Fuchsia: 27.20250422.103.3600
• SDK de Android: home.android.sdk_1_5
• App de Google Home: Funciona con cualquier versión
• Biblioteca androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.1.0

Nuevas funciones

• Los activadores, las condiciones y las acciones ahora aceptan structs de Matter como parámetros en la API de Automation.
• Se agregó el tipo de dispositivo de cámara a la API de Device (transmisión en vivo, conversación bidireccional, inicio/detención de grabación).

Otros cambios importantes

• La app de ejemplo de Android agrega compatibilidad con la cámara, la puesta en marcha de varios administradores y la automatización OnOff predefinida.

Errores conocidos corregidos

• 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.
• Después de que el usuario selecciona un color de un ajuste predeterminado o del selector de temperatura de color, la luz de color extendida no actualiza el color.

Problemas conocidos

• Es posible que aumente la latencia del control de dispositivos cuando cambies de Wi-Fi a una red móvil.
• Es posible que el control de los tipos de dispositivos de ventilador respaldados por Cloud-to-Cloud no funcione en la app de ejemplo.

2025-08-29

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

En esta versión, se corrigieron errores y se mejoró 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
• Firmware del dispositivo central de Google, Cast: 3.76.495998
• Firmware del centro de Google, Fuchsia: 27.20250422.103.3600
• SDK de Android: home.android.sdk_1_4_1
• App de Google Home: Funciona con cualquier versión
• Biblioteca androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.0.0

Nuevas funciones

• Se definió un nuevo DecommissionIneligibleReason para intentar retirar un dispositivo de varias fuentes en la API de Device.

Errores conocidos corregidos

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

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.

31/7/2025

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

En esta versión, se corrigieron errores y se mejoró 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
• Firmware del centro de Google, Cast: 3.76.486931
• Firmware del centro de Google, Fuchsia: 27.20250422.103.3600
• SDK de Android: home.android.sdk_1_4_0
• App de Google Home: Funciona con cualquier versión
• Biblioteca androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.0.0

Nuevas funciones

• Las automatizaciones se pueden restringir para que se ejecuten hasta una cantidad finita de veces en la API de Automation.
• La capacidad de quitar de forma programática un dispositivo Matter en la API de Device
• Se quitaron los miembros HomeDevice obsoletos (trait(), isInRoom, isInStructure).
• Home.hasPermissions() ahora incorpora tanto el acceso a la estructura de OAuth como los permisos otorgados a la app.

Otros cambios importantes

• La app de ejemplo para Android borra dispositivos solo para Matter, cambia el nombre de los dispositivos y reemplaza las llamadas a la API obsoletas.

Errores conocidos corregidos

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

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 y espera al menos 10 s.

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 Android para las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 25.23.31
• Firmware del centro de Google, Cast, Google Home, Google Home Mini y Google Nest Mini: 3.75.468362
• Firmware del dispositivo central de Google, Cast y Google Nest Audio: 3.75.476451
• Firmware del centro de Google, Fuchsia: 26.20250116.103.2900
• SDK de Android: home.android.sdk_1_3_2
• App de Google Home: Funciona con cualquier versión
• Biblioteca 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) y los rasgos y tipos de dispositivos del SDK (play-services-home-types-17.0.0.aar). A partir de este lanzamiento, los desarrolladores deben incluir ambos artefactos en las rutas de acceso de la biblioteca de tiempo de compilación y de tiempo de ejecución de sus proyectos.

Otros cambios importantes

• La app de ejemplo para Android agrega la opción para que los usuarios desconecten la app y revoquen sus permisos.
• La app de ejemplo para Android agrega lo siguiente: 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 Android para las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 25.19.32
• Firmware del centro de Google, Cast: 3.75.468222
• Firmware del Google Hub, 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 androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.0.0

Nuevas funciones

• Se introduce el rasgo SyntheticSwitch, que simplifica el control de los eventos generados por los dispositivos Matter Switch y permite que los interruptores activen los activadores de automatización.
• El rasgo ExtendedDoorLock tiene un cambio rotundo: El tipo de datos del campo user_id se cambió de String a Long. Las apps que usan este atributo deben volver a compilarse.

Otros cambios importantes

• La app de ejemplo de Android agrega funciones para registrar el estado de estructuras, dispositivos, tipos, rasgos y automatizaciones para facilitar la depuración.

Errores conocidos corregidos

• 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.
• En la app de ejemplo para Android, antes se mostraba como sin conexión un dispositivo con connectivityState PARTIALLY_ONLINE. Ahora, este estado se representa como en línea.

Problemas conocidos

• En la app de ejemplo para Android, el botón Crear automatización a veces requiere varios toques para activarse.

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 Android para las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 25.16.33
• Firmware del centro de Google, Cast: 3.75.468222
• Firmware del Google Hub, 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 androidx.core: Funciona con cualquier versión
• Versión de Matter: 1.4.0.0

Nuevas funciones

• Se agregó compatibilidad con los activadores de eventos programados recurrentes en la API de Automation, que permite 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.
• Se agregó la capacidad de cambiar el nombre de los dispositivos en la API de Device.
• Se agregó la capacidad de cambiar el nombre de las habitaciones en la API de Structure.

Errores conocidos corregidos

• 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.

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. Solución alternativa: Verifica que la dirección de la casa esté presente con la API de Discovery antes de intentar crear automatizaciones.

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 Android para las APIs de Home.

Versiones mínimas

• Servicios de Google Play: 25.09.33
• Versiones mínimas de firmware del concentrador 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 para producción y estará disponible en todos los dispositivos a partir del 22 de abril de 2025.}

Nuevas funciones

• Se mejoró el rendimiento al cargar objetos desde Home Graph.
• API de Automation
  • Se agregó compatibilidad con 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 Android para las APIs de Home.

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 de 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 prefetch 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 a 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 Android para las APIs de Home.

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 de 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 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. 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 debe inicializarse 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 Android para las APIs de Home, 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 de 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). Por lo general, esto se debe 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 se minimiza la app 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.