Notes de version du SDK Android pour les API Home

2025-10-23

  Version bêta publique 1.5.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.41.30
  • Versions minimales du micrologiciel pour les hubs Google :
    • Distribution : 3.76.495998
    • Fuchsia : 27.20250422.103.3600
  • SDK Android : home.android.sdk_1_5_1
  • Application Google Home : fonctionne avec toutes les versions
  • Bibliothèque androidx.core : compatible avec toutes les versions
  • Version Matter : 1.4.1.0

Nouvelles fonctionnalités

  • API Structure
    • L'API d'activation du hub vous permet de découvrir et d'activer un hub Google Home de manière programmatique. Consultez API d'activation du hub sur Android.
  • Application exemple Android
    • Compatibilité avec le type d'appareil Sonnette pour :
      • OnOff
      • Diffusion en direct
      • Communication bidirectionnelle
    • API d'activation des hubs : Activer les hubs

Problèmes connus corrigés

  • L'application exemple n'affiche pas correctement l'état du périphérique sur la vue Device.

2025-09-26

  Version bêta publique 1.5.0 des API Home  

Cette version introduit la prise en charge des caméras, contient des corrections de bugs et améliore la qualité bêta du SDK Android des API Home.

Versions minimales

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

Nouvelles fonctionnalités

  • API Automation
    • Les déclencheurs, les conditions et les actions acceptent désormais les structures Matter comme paramètres.
  • API Device
    • Type de périphérique caméra ajouté. Les fonctionnalités de caméra suivantes sont également disponibles pour le type d'appareil "Sonnette" :
      • Flux vidéo en direct de la caméra.
      • Communication bidirectionnelle de la caméra.
      • Démarrer et arrêter l'enregistrement de la caméra
  • Application exemple Android
    • Prise en charge du type d'appareil "Caméra" :
      • Flux vidéo en direct de la caméra.
      • Communication bidirectionnelle de la caméra.
      • Démarrer et arrêter l'enregistrement de la caméra
      • Autorisations restreintes pour les types d'appareils.
    • Mise en service multi-administrateur (partage d'un appareil mis en service).
    • Automatisation prédéfinie OnOff.

Problèmes connus

  • La latence de contrôle des appareils peut augmenter lorsque vous passez du Wi-Fi à un réseau mobile.
  • Le contrôle des types de périphériques de type ventilateur pris en charge par Cloud-to-Cloud peut ne pas fonctionner dans l'application exemple.

Problèmes connus corrigés

  • Lorsqu'un hub actuellement actif est retiré de force, il existe un délai de cinq minutes pendant lequel il est impossible de contrôler certains appareils. Au bout de cinq minutes, la capacité de contrôler les appareils est rétablie.
  • Une fois que l'utilisateur a sélectionné une couleur parmi les préréglages ou à partir du sélecteur de température de couleur, la fonction Extended Color Light ne parvient pas à mettre à jour la couleur.

2025-09-08

L'application exemple pour Android version 1.4.1 a été publiée.

Nouvelles fonctionnalités

  • Créer, renommer, mettre à jour et supprimer une salle.
  • Mise en service d'un tissu 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 correctifs de bugs et améliore la qualité bêta du SDK Android des API Home.

Versions minimales

  • Services Google Play : 25.33.32
  • Versions minimales du micrologiciel des hubs Google :
    • Distribution : 3.76.495998
    • Fuchsia : 27.20250422.103.3600
  • Kit de développement logiciel (SDK) Android : home.android.sdk_1_4_1
  • Application Google Home : fonctionne avec toutes les versions
  • androidx.core bibliothèque : fonctionne avec n'importe quelle version
  • 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 correctifs de bugs et améliore la qualité bêta du SDK Android des API Home.

Versions minimales

  • Services Google Play : 25.23.31
  • Versions minimales du firmware Google Hub :
    • 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
  • androidx.core bibliothèque : fonctionne avec n'importe quelle version
  • Version Matter : 1.4.0.0

Nouvelles fonctionnalités

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

    À compter de cette version, les développeurs doivent inclure les deux artefacts dans les chemins de bibliothèque de compilation et d'exécution de leur projet.

Exemple d'application Android

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

Problèmes connus

  • Les appareils sous vide qui ont été connectés à une station d'accueil n'enregistrent pas l'état « Connecté ».

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
  • androidx.core bibliothèque : fonctionne avec n'importe quelle version
  • 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 l'adresse de la maison n'est pas définie dans l'application Google Home (voir Modifier l'adresse de votre maison Google pour savoir comment définir l'adresse d'une maison).
  • 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

  API Accueil Version bêta publique 1.3  

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 firmware Google Hub :
    • Cast : 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • Kit de développement logiciel (SDK) Android : home.android.sdk_202504_EAP_1_3_RC00
  • Application Google Home : fonctionne avec toutes les versions
  • androidx.core bibliothèque : fonctionne avec n'importe quelle version
  • 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 bien 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 :
    • Distribution : 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
  • androidx.core bibliothèque : 1.10.0
  • Version Matter : 1.4.0.0
1. Cette version est actuellement 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 d'automatisation
    • Ajout de la prise en charge des filtres d'entité , qui permettent aux automatisations de sélectionner dynamiquement des appareils en fonction de critères spécifiés dans l'automatisation.
  • API de l'appareil
    • Les informations relatives aux appareils cloud à cloud sont désormais disponibles dans le BasicInformationTrait.

Problèmes connus

  • La latence de contrôle des appareils peut augmenter lorsque vous passez du Wi-Fi à un réseau mobile.
  • Après une réinitialisation d'usine du hub, certains appareils peuvent apparaître comme étant hors ligne.

Problèmes connus corrigés

  • Si l'API Discovery est appelée avant l'initialisation ou avant que l'initialisation ne soit terminée, une erreur HomeException avec code 14: UNKNOWN et le message « Aucune route trouvée. » est levée.
  • Dans un environnement contenant plusieurs structures et plusieurs utilisateurs, il est possible qu'aucun appareil ne soit renvoyé lorsque vous passez d'une structure ou d'un utilisateur à un autre.

2025-03-14

  API Accueil Version bêta publique 1.2.0  

Cette version contient des correctifs de bugs et améliore la qualité 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
  • Kit de développement logiciel (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 de Matter : 1.3.0.0
    • Remarque : Les types et clusters d'appareils Matter provisoires ne sont pas compatibles.

Nouvelles fonctionnalités

  • API d'automatisation :
    • 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 pas et ne mettez pas en cache les entités candidates. Vérifiez si une entité est en ligne avant d'appeler les méthodes de l'API Discovery sur celle-ci.
  • Dans un environnement comportant plusieurs structures et plusieurs utilisateurs, le passage d'une structure à l'autre et d'un utilisateur à l'autre peut entraîner l'absence de retour des appareils.

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 tout 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.
    • Google Assistant ne peut pas contrôler les appareils Matter.
    • Les écrans intelligents ne peuvent pas contrôler les appareils Matter ni afficher l'état d'un appareil Matter.
  • Sur certains appareils, une application peut ne pas toujours refléter un état précis, et il est possible qu'elle indique un état différent de celui indiqué par une application Google comme Google Home. Cela est généralement dû au fait que les appareils ne transmettent pas leur état à Google.
    • Solution de contournement : vérifier l’état avec une application Google résout le problème de concordance.

2025-01-14

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

Nous avons précisé qu'une instance d'une Home 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 invalides.

2025-01-07

  Sortie de la version bêta publique des API Home  

Durant la phase 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é bêta du SDK Android des API Home, y compris la compatibilité avec les appareils Google Nest Audio et Google TV.

Versions minimales

  • Version minimale des services Google Play : 24.45.34
  • Versions minimales du firmware Google Hub :
    • Version du casting : 3.74.444798
    • Version minimale de Fuchsia : 22.20240805.103.161
  • Kit de développement logiciel (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 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 l'état d'un appareil Matter.
  • Pour certains appareils, il est possible qu'une application ne reflète pas toujours l'état exact. Votre application peut alors indiquer 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 mise en service 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 déclencheurs "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.