Notes de version du SDK Android pour les API Home

2025-09-08

La version 1.4.1 de l'application exemple pour Android est disponible.

Nouvelles fonctionnalités

  • Créer, renommer, modifier et supprimer un espace
  • Mise en service dans un réseau Matter tiers.

Problèmes connus résolus

  • Le lien vers la page de révocation des autorisations fonctionne désormais.

2025-08-29

  Version bêta publique 1.4.1 des API Home  

Cette version contient des corrections de bugs et améliore la qualité de la version bêta du SDK Android des API Home.

Versions minimales

  • Services Google Play : 25.33.32
  • Versions minimales du micrologiciel pour les hubs Google :
    • Cast : 3.76.495998
    • Fuchsia : 27.20250422.103.3600
  • SDK Android : home.android.sdk_1_4_1
  • Application Google Home : fonctionne avec toutes les versions
  • Bibliothèque androidx.core : compatible avec toutes les versions
  • Version Matter : 1.4.0.0

Nouvelles fonctionnalités

Problèmes connus

  • Lorsqu'un hub actif est supprimé de force, il existe un délai de cinq minutes pendant lequel il n'est pas possible de contrôler certains appareils. Au bout de cinq minutes, la possibilité de contrôler les appareils est rétablie.

Problèmes connus corrigés

  • L'application exemple Android plante lorsqu'un utilisateur tente de définir un thermostat sur un mode qu'il ne prend pas en charge.

2025-07-31

  Version bêta publique 1.4.0 des API Home  

Cette version contient des corrections de bugs et améliore la qualité de la version bêta du SDK Android des API Home.

Versions minimales

  • Services Google Play : 25.28.34
  • Versions minimales du micrologiciel pour les hubs Google :
    • Cast : 3.76.486931
    • Fuchsia : 27.20250422.103.3600
  • SDK Android : home.android.sdk_1_4_0
  • Application Google Home : fonctionne avec toutes les versions
  • Bibliothèque androidx.core : compatible avec toutes les versions
  • Version Matter : 1.4.0.0

Nouvelles fonctionnalités

Problèmes connus

  • Après s'être déconnecté d'un téléphone et s'être reconnecté, une application Home APIs ne peut pas contrôler les appareils.
    • Solution : Fermez l'application ou mettez-la en arrière-plan, puis attendez au moins 10 secondes avant de réessayer.

Problèmes connus corrigés

  • Les aspirateurs qui ont été placés sur leur base n'enregistrent pas l'état "Sur la base".

08/07/2025

Avec la version 3.76.479819 du micrologiciel Cast, Nest Wifi Pro peut désormais servir de hub pour les API Home.

26/06/2025

  Version bêta publique 1.3.2 des API Home  

Cette version contient des corrections de bugs et améliore la qualité de la version bêta du SDK Android des API Home.

Versions minimales

  • Services Google Play : 25.23.31
  • Versions minimales du micrologiciel pour les hubs Google :
    • Caster :
      • Google Home, Google Home Mini et Google Nest Mini : 3.75.468362
      • Google Nest Audio : 3.75.476451
    • Fuchsia : 26.20250116.103.2900
  • SDK Android : home.android.sdk_1_3_2
  • Application Google Home : fonctionne avec toutes les versions
  • Bibliothèque androidx.core : compatible avec toutes les versions
  • Version Matter : 1.4.0.0

Nouvelles fonctionnalités

  • L'artefact SDK a été divisé en deux artefacts distincts :
    • Framework du SDK des API Home (play-services-home-17.0.0.aar)
    • Caractéristiques du SDK et types d'appareils (play-services-home-types-17.0.0.aar)

    À partir de cette version, les développeurs doivent inclure les deux artefacts dans les chemins d'accès aux bibliothèques de compilation et d'exécution de leur projet.

Exemple d'application Android

  • Les utilisateurs peuvent se déconnecter de l'application et révoquer ses autorisations.
  • Mise à jour des artefacts du SDK pour inclure play-services-home-17.0.0 et play-services-home-types-17.0.0.

Problèmes connus

  • Les aspirateurs qui ont été placés sur leur base n'enregistrent pas l'état "Sur la base".

2025-06-05

  Version bêta publique 1.3.1 des API Home  

Cette version contient des corrections de bugs et améliore la qualité de la version bêta du SDK Android des API Home.

Versions minimales

  • Services Google Play : 25.19.32
  • Versions minimales du micrologiciel pour les hubs Google :
    • Cast : 3.75.468222
    • Fuchsia : 26.20250116.103.2201
  • SDK Android : home.android.sdk_202505_EAP_1_3_1_RC06
  • Application Google Home : fonctionne avec toutes les versions
  • Bibliothèque androidx.core : compatible avec toutes les versions
  • Version Matter : 1.4.0.0

Nouvelles fonctionnalités

Traits

Exemple d'application Android

Ajout de fonctions pour enregistrer l'état des structures, des appareils, des types, des caractéristiques et des automatisations afin de faciliter le débogage.

Problèmes connus

Dans l'application exemple Android, le bouton Créer une automatisation nécessite parfois plusieurs appuis pour se déclencher.

Problèmes connus résolus

  • L'application Google Home plante et affiche un FailedPreconditionException lors de la création d'automatisations si la position de la maison n'est pas définie dans l'application Google Home. Pour savoir comment définir la position d'une maison, consultez Modifier l'adresse de votre maison Google.
  • Dans l'application exemple Android, un appareil avec connectivityState PARTIALLY_ONLINE était auparavant affiché comme hors connexion. Cet état est désormais représenté par en ligne.

2025-05-12

  Version bêta publique 1.3 des API Home  

Cette version contient des corrections de bugs et améliore la qualité de la version bêta du SDK Android des API Home.

Versions minimales

  • Services Google Play : 25.16.33
  • Versions minimales du micrologiciel pour les hubs Google :
    • Cast : 3.75.468222
    • Fuchsia : 26.20250116.103.2201
  • SDK Android : home.android.sdk_202504_EAP_1_3_RC00
  • Application Google Home : fonctionne avec toutes les versions
  • Bibliothèque androidx.core : compatible avec toutes les versions
  • Version Matter : 1.4.0.0

Nouvelles fonctionnalités

Problèmes connus

L'application Google Home plante et affiche un FailedPreconditionException lors de la création d'automatisations si l'adresse de la maison n'est pas définie dans l'application Google Home (consultez Modifier l'adresse de votre maison Google pour savoir comment faire).

  • Solution de contournement : Vérifiez que l'adresse du domicile est présente à l'aide de l'API Discovery avant de tenter de créer des automatisations.

Problèmes connus résolus

  • La latence de contrôle des appareils peut augmenter lorsque vous passez du Wi-Fi à un réseau mobile.
  • Une fois la configuration d'usine d'un hub rétablie, il est possible que les appareils apparaissent comme hors connexion.

2025-04-09

  Version bêta publique 1.2.1 des API Home  

Cette version contient des corrections de bugs et améliore la qualité de la version bêta du SDK Android des API Home.

Versions minimales

  • Services Google Play : 25.09.33
  • Versions minimales du micrologiciel pour les hubs Google :
    • Cast : 3.75.468222
    • Fuchsia : 24.20241009.103.19006011
  • SDK Android : home.android.sdk_202503_EAP_1_2_1_RC02
  • Application Google Home : fonctionne avec toutes les versions
  • Bibliothèque androidx.core : 1.10.0
  • Version Matter : 1.4.0.0
1. Cette version est en cours de déploiement en production et sera disponible sur tous les appareils d'ici le 22 avril 2025.

Nouvelles fonctionnalités

  • Amélioration des performances lors du chargement d'objets à partir du graphique de la maison.
  • API Automation
    • Ajout de la compatibilité avec les filtres d'entités, qui permettent aux automatisations de sélectionner dynamiquement des appareils en fonction des critères spécifiés dans l'automatisation.
  • API Device

Problèmes connus

  • La latence de contrôle des appareils peut augmenter lorsque vous passez du Wi-Fi à un réseau mobile.
  • Une fois la configuration d'usine d'un hub rétablie, il est possible que les appareils apparaissent comme hors connexion.

Problèmes connus corrigés

  • Si l'API Discovery est appelée avant l'initialisation ou avant qu'elle ne soit terminée, un HomeException avec code 14: UNKNOWN et le message "Aucun itinéraire trouvé" est généré.
  • Dans un environnement contenant plusieurs structures et plusieurs utilisateurs, le fait de passer d'une structure ou d'un utilisateur à un autre peut entraîner l'absence d'appareils renvoyés.

2025-03-14

  Version bêta publique 1.2.0 des API Home  

Cette version contient des corrections de bugs et améliore la qualité de la version bêta du SDK Android des API Home.

Versions minimales

  • Version minimale des services Google Play : 25.06.32
  • Versions minimales du micrologiciel des hubs Google :
    • Version Cast : 3.75.456944
    • Version minimale de Fuchsia : 24.20241009.103.1900601
  • SDK Android : home.android.sdk_1_2_0_RC06
  • Version minimale de l'application Google Home : fonctionne avec toutes les versions
  • androidx.core version minimale de la bibliothèque : 1.10.0
  • Version Matter : 1.3.0.0
    • Remarque : Les types et clusters d'appareils Matter provisoires ne sont pas compatibles.

Nouvelles fonctionnalités

  • API Automation :
    • Prise en charge des plages de dates et des dates partielles dans les conditions d'automatisation. Consultez Utiliser des dates avec "between".
    • Dans les versions précédentes, l'API Discovery renvoyait un NumberSetConstraint pour certains champs bitmap alors qu'elle aurait dû renvoyer un BitmapConstraint. Ces champs renvoient désormais un BitmapConstraint comme prévu. Cela se limite aux bitmaps optionsMask et optionsOverride dans les commandes de trait LevelControl.

Problèmes connus

  • La latence de contrôle des appareils peut augmenter lorsque vous passez du Wi-Fi à un réseau mobile.
  • Une fois la configuration d'usine d'un hub rétablie, il est possible que les appareils apparaissent comme hors connexion.
  • Si l'API Discovery est appelée avant l'initialisation ou avant qu'elle ne soit terminée, un HomeException avec code 14: UNKNOWN et le message "Aucun itinéraire trouvé" est généré.
    • Solution de contournement : N'appelez l'API Discovery que lorsque vous avez réellement besoin de candidats à l'automatisation. Ne préchargez ni ne mettez en cache les entités candidates. Vérifiez si une entité est en ligne avant d'appeler des méthodes de l'API Discovery sur celle-ci.
  • Dans un environnement contenant plusieurs structures et plusieurs utilisateurs, le fait de passer d'une structure ou d'un utilisateur à un autre peut entraîner l'absence d'appareils renvoyés.

Problèmes connus corrigés

  • La première fois qu'une application Home APIs appelle HomeManager.structures() après son lancement, elle reçoit zéro structure, même si une ou plusieurs structures sont présentes. Cela donne l'impression erronée qu'aucune structure n'est associée au compte Google.
  • Les utilisateurs peuvent rencontrer de longs temps d'attente lors du chargement, de la création et de la modification d'automatisations.
  • Les utilisateurs qui lancent le processus de configuration depuis l'application Appareil photo doivent scanner le code QR deux fois pour finaliser la configuration Matter.
  • Dans une structure contenant plus de 200 appareils, l'API Discovery peut simplement ne renvoyer aucun candidat.

2025-01-29

  Version bêta publique 1.1.0 des API Home  

Cette version contient des corrections de bugs et améliore la qualité de la version bêta du SDK Android des API Home.

Versions minimales

  • Version minimale des services Google Play : 25.02.32
  • Versions minimales du micrologiciel des hubs Google :
    • Version Cast : 3.75.456944
    • Version minimale de Fuchsia : 24.20241009.103.1900500
  • SDK Android : home.android.sdk_202412_EAP_1_1_RC04
  • Version minimale de l'application Google Home : fonctionne avec toutes les versions
  • androidx.core version minimale de la bibliothèque : 1.10.0
  • Version Matter : 1.3.0.0
    • Remarque : Les types et clusters d'appareils Matter provisoires ne sont pas compatibles.

Nouvelles fonctionnalités

Problèmes connus

  • Les utilisateurs peuvent rencontrer de longs temps d'attente lors du chargement, de la création et de la modification d'automatisations.
  • Les utilisateurs qui lancent le processus de configuration depuis l'application Appareil photo doivent scanner le code QR deux fois pour finaliser la configuration Matter.
  • Dans une structure contenant plus de 200 appareils, l'API Discovery peut simplement ne renvoyer aucun candidat.

Problèmes connus corrigés

  • Il est possible que le changement de compte Google connecté échoue et génère une erreur.
  • Il est possible que les appareils Google TV ne fonctionnent pas pour les automatisations qui utilisent le trait MediaPlayback.
  • Dans une structure qui ne contient qu'un hub Google :
    • Il est possible que les appareils Matter apparaissent comme hors connexion dans l'application Google Home.
    • L'Assistant Google ne peut pas contrôler les appareils Matter.
    • Les écrans connectés ne peuvent pas contrôler les appareils Matter ni afficher leur état.
  • Pour certains appareils, il est possible qu'une application ne reflète pas toujours l'état exact. Il se peut que votre application indique un état différent de celui indiqué par une application Google, comme l'application Google Home. Cela est généralement dû au fait que les appareils ne signalent pas leur état à Google.
    • Solution de contournement : Vérifier l'état avec une application Google permet de résoudre l'incohérence.

2025-01-14

Mise à jour des conseils pour l'initialisation des API Home.

Nous avons précisé qu'une instance d'une maison doit être initialisée en tant que singleton de contexte. Cela garantit une expérience utilisateur plus fluide dans votre application et évite les erreurs liées aux sessions non valides.

2025-01-07

  Version bêta publique des API Home  

Pendant la version bêta publique pour les développeurs, tous les développeurs peuvent commencer à créer et à tester leurs applications.

Cette version contient des corrections de bugs et améliore la qualité de la version bêta du SDK Android des API Home, y compris une meilleure compatibilité avec les appareils Google Nest Audio et Google TV.

Versions minimales

  • Version minimale des services Google Play : 24.45.34
  • Versions minimales du micrologiciel des hubs Google :
    • Version Cast : 3.74.444798
    • Version minimale de Fuchsia : 22.20240805.103.161
  • SDK Android : home.android.sdk_202411_EAP_1_0_1_RC00
  • Version minimale de l'application Google Home : fonctionne avec toutes les versions
  • androidx.core version minimale de la bibliothèque : 1.10.0
  • Version Matter : 1.3.0.0
    • Remarque : Les types et clusters d'appareils Matter provisoires ne sont pas compatibles.

Problèmes connus

  • Il est possible que le changement de compte Google connecté échoue et génère une erreur.
    • Solution : Exécutez à nouveau le flux d'autorisations ou redémarrez l'application.
  • Il est possible que les appareils Google TV ne fonctionnent pas pour les automatisations qui utilisent le trait MediaPlayback.
  • Dans une structure qui ne contient qu'un hub Google :
    • Il est possible que les appareils Matter apparaissent comme hors connexion dans l'application Google Home.
    • L'Assistant Google ne peut pas contrôler les appareils Matter.
    • Les écrans connectés ne peuvent pas contrôler les appareils Matter ni afficher leur état.
  • Pour certains appareils, il est possible qu'une application ne reflète pas toujours l'état exact. Votre application peut alors signaler un état différent de celui indiqué par une application Google, comme l'application Google Home (GHA). Cela est généralement dû au fait que les appareils ne signalent pas leur état à Google.
    • Solution de contournement : Vérifier l'état avec une application Google permet de résoudre l'incohérence.

Problèmes connus corrigés

  • La configuration peut échouer si l'application est réduite pendant le processus.
    • Solution de contournement : utilisez l' API suppressHalfSheetNotification() pour supprimer les notifications de demi-feuille lorsque l'API Commissioning est utilisée dans votre application.
  • Un problème côté serveur peut empêcher les phrases de démarrage "Ok Google" de fonctionner dans les automatisations.
  • Lorsque vous utilisez un hub fonctionnant sous Fuchsia et ne comportant aucun appareil Matter dans la structure, si le hub est laissé inactif pendant plus de trois heures, la mise en service du premier appareil Matter entraîne la mise hors connexion de l'appareil Matter.
  • Après le rétablissement de la configuration d'usine d'un hub, les commandes envoyées aux appareils nouvellement mis en service peuvent échouer, même si l'appareil est indiqué comme étant en ligne.