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

2025-10-23

  Versión beta pública 1.5.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.41.30
  • Versiones mínimas del firmware del Google Hub:
    • Reparto: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • SDK de Android: home.android.sdk_1_5_1
  • App de Google Home: Funciona con cualquier versión
  • androidx.core biblioteca: funciona con cualquier versión
  • Versión de Matter: 1.4.1.0

Nuevas funciones

  • API de Structure
    • La API de activación de la unidad central te permite descubrir y activar de forma programática una unidad central de Google Home. Consulte la API de activación de Hub en Android.
  • Aplicación de ejemplo de Android
    • Se agregó compatibilidad con el tipo de dispositivo Timbre para los siguientes:
      • OnOff
      • Transmisión en vivo
      • diálogo bidireccional
    • API de activación de hubs: Activar hubs

Errores conocidos corregidos

  • La aplicación de muestra 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  

Esta versión introduce soporte para dispositivos con cámara, contiene correcciones de errores y mejora la calidad beta del SDK de Android de las API de inicio.

Versiones mínimas

  • Servicios de Google Play: 25.37.31
  • Versiones mínimas de firmware de la unidad central de Google:
    • Versión de Cast: 3.76.492738
    • Fuchsia: 27.20250422.103.3600
  • SDK de Android: home.android.sdk_1_5
  • App de Google Home: Funciona con cualquier versión
  • Biblioteca de androidx.core: Funciona con cualquier versión
  • Versión de Matter: 1.4.1.0

Nuevas funciones

  • API de Automation
    • Los activadores, las condiciones y las acciones ahora aceptan structs de Matter como parámetros.
  • API de Device
    • Se agregó el tipo de dispositivo de cámara. Las siguientes funciones de la cámara también están disponibles para el tipo de dispositivo Doorbell:
      • Transmisión en vivo de la cámara
      • Conversación bidireccional con la cámara
      • La cámara inicia y detiene la grabación.
  • App de ejemplo para Android
    • Compatibilidad con el tipo de dispositivo Cámara:
      • Transmisión en vivo de la cámara
      • Conversación bidireccional con la cámara
      • La cámara inicia y detiene la grabación.
      • Permisos restringidos para tipos de dispositivos
    • Puesta en marcha con varios administradores (compartir el dispositivo puesto en marcha)
    • Automatización OnOff predefinida.

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.

Errores conocidos corregidos

  • Cuando se quita de forma forzada el centro 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.

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 del firmware del Google Hub:
    • Reparto: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • SDK de Android: home.android.sdk_1_4_1
  • Aplicación Google Home: funciona con cualquier versión
  • androidx.core biblioteca: funciona con cualquier versión
  • Versión de Matter: 1.4.0.0

Nuevas funciones

Problemas conocidos

  • Cuando se fuerza la desconexión del hub actualmente activo, existe un período de cinco minutos durante el cual no es posible controlar algunos dispositivos. Tras cinco minutos, se restablece la capacidad de controlar los dispositivos.

Errores conocidos corregidos

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

31/7/2025

  Inicio APIs Versión beta pública 1.4.0  

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 del firmware del Google Hub:
    • Versión de transmisión: 3.76.486931
    • Fuchsia: 27.20250422.103.3600
  • SDK de Android: home.android.sdk_1_4_0
  • Aplicación 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

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 han acoplado no registran el estado de Acoplamiento.

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 beta del SDK de Android de las API de inicio.

Versiones mínimas

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

Nuevas funciones

  • El artefacto del SDK se ha dividido 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 deberán incluir ambos artefactos en las rutas de biblioteca de tiempo de compilación y de tiempo de ejecución de su proyecto.

Aplicación de muestra de Android

  • Los usuarios pueden desconectarse y revocar los permisos de la aplicación.
  • 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 a la base 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 unidad central 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

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 Crear automatización 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 unidad central 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

Problemas conocidos

La aplicación Google Home falla con un FailedPreconditionException al crear automatizaciones si la ubicación de la casa no está configurada en la aplicación Google Home (GHA) (Consulte 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.

Problemas conocidos solucionados

  • 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 del hub, 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 beta del SDK de Android de las API de inicio.

Versiones mínimas

  • Servicios de Google Play: 25.09.33
  • Versiones mínimas del firmware del Google Hub:
    • Reparto: 3.75.468222
    • Fucsia: 24.20241009.103.19006011
  • SDK de Android: home.android.sdk_202503_EAP_1_2_1_RC02
  • Aplicación Google Home: funciona con cualquier versión
  • androidx.core biblioteca: 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

  • Mejora del rendimiento al cargar objetos desde el gráfico de inicio.
  • 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

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 1.2.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 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 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 provisionales de Matter.

Nuevas funciones

  • API de Automation:
    • Compatibilidad con rangos de fechas y fechas parciales en las condiciones de automatización. Ver Usar fechas con entre.
    • 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 del hub, 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 precargue ni almacene 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 sobre ella.
  • En un entorno que contiene múltiples estructuras y múltiples usuarios, el cambio entre estructuras y usuarios puede provocar que no se devuelvan los dispositivos.

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 errónea de que no existen estructuras asociadas a la cuenta de Google.
  • Al cargar, crear y editar automatizaciones, los usuarios pueden experimentar largos tiempos de espera.
  • Los usuarios que inicien el proceso de configuración desde la aplicación Cámara deberán escanear el código QR dos veces para completar la puesta en marcha de Matter.
  • En una estructura que contiene más de 200 dispositivos, la API de detección puede simplemente no devolver ningún candidato.

2025-01-29

  Inicio APIs Lanzamiento beta público 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
  • androidx.core Versión mínima de la biblioteca: 1.10.0
  • Versión de Matter: 1.3.0.0
    • Nota: No se admiten los tipos y clústeres de dispositivos provisionales de Matter.

Nuevas funciones

  • API de transmisión:
  • API de procesamiento por lotes (experimental):

Problemas conocidos

  • Cuando cargan, crean y editan automatizaciones, es posible que los usuarios experimenten tiempos de espera prolongados.
  • Los usuarios que inicien el proceso de configuración desde la aplicación Cámara deberán escanear el código QR dos veces para completar la puesta en marcha 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

  • Cambiar la cuenta de Google con la que se ha iniciado sesión puede fallar y provocar un error.
  • Es posible que los dispositivos Google TV no funcionen para automatizaciones que utilicen el rasgo MediaPlayback.
  • En una estructura que contiene únicamente un centro de Google:
    • Los dispositivos Matter pueden aparecer como desconectados en la aplicación Google Home.
    • El Asistente de Google no puede controlar los dispositivos Matter.
    • Las pantallas inteligentes no pueden controlar los dispositivos Matter ni mostrar el estado de ningún dispositivo Matter.
  • En algunos dispositivos, una aplicación puede no reflejar siempre el estado exacto, y tu aplicación podría mostrar un estado diferente al que muestra una aplicación de Google, como la aplicación Google Home. Esto suele deberse a que los dispositivos no envían información sobre su estado a Google.
    • Solución alternativa: Comprobar el estado con una aplicación de Google resuelve la discrepancia.

2025-01-14

Guía actualizada para la inicialización de las API de inicio.

Hemos dejado más claro que unUna instancia de Home debe inicializarse como un singleton de contexto. . Esto garantiza una experiencia de usuario más fluida en tu aplicación y evita errores con sesiones no válidas.

2025-01-07

  Inicio APIs Lanzamiento beta público  

Durante la fase beta pública para desarrolladores, todos los desarrolladores pueden comenzar a crear y probar sus aplicaciones.

Esta versión contiene correcciones de errores y mejora la calidad beta del SDK de Android de las API de Home, incluyendo una mejor compatibilidad con los 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 del firmware del Google Hub:
    • 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 aplicación Google Home (GHA): funciona con cualquier versión
  • androidx.core Versión mínima de la biblioteca: 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: Vuelva a ejecutar el flujo de permisos o reinicie la aplicación.
  • Es posible que los dispositivos Google TV no funcionen para las automatizaciones que usan el rasgo MediaPlayback.
  • En una estructura que contiene únicamente 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 los dispositivos Matter ni mostrar el estado de ningún dispositivo Matter.
  • En algunos dispositivos, una aplicación puede no reflejar siempre el estado exacto, y su aplicación puede informar un estado diferente al informado por una aplicación de Google como la aplicación Google Home (GHA). Esto suele deberse a que los dispositivos no informan de 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.
  • Un problema del servidor puede impedir que los iniciadores de OkGoogle funcionen en las automatizaciones.
  • Al usar un hub que ejecuta Fuchsia y que no tiene ningún dispositivo Matter en la estructura, si el hub permanece inactivo durante más de 3 horas, la puesta en marcha del primer dispositivo Matter provoca que este se desconecte.
  • 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.