Notes de version du SDK Android pour les API Home

2026-05-01

  Version bêta publique 1.8.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 : 26.16.31
• Micrologiciel du hub Google, Cast, Nest Wifi Pro : 3.78.518349
• Micrologiciel du Google Nest Hub, Cast, tous les autres hubs basés sur Cast : 3.78.526062
• Micrologiciel Google Nest Hub, Fuchsia : 30.20260121.103.1602802
• Firmware Google Nest Hub, Google TV Streamer, 4K : UTTK.250729.004
• SDK Android : home.android.sdk_GHP_1_8_1
• Application Google Home : version 4.8 ou ultérieure
• Bibliothèque androidx.core : fonctionne avec toutes les versions
• Version Matter : 1.4.1.0
• Version Matter : compatibilité expérimentale avec la version 1.5.0

Nouvelles fonctionnalités

• Le trait de thermostat est désormais compatible avec les fonctionnalités de lecture/mise à jour, d'activation/désactivation et de minuterie.

Problèmes connus corrigés

• La mise en service d'un appareil Matter peut échouer.
• L'état de la lampe Philips BLE ne s'affiche pas correctement.
• Latence entraînant une instabilité du réseau et des temps de réponse lents.

Problèmes connus

• Impossible de mettre en service certains appareils avec le Google TV Streamer (4K).
• Lorsque le hub est un Nest Wifi Pro, un Google Nest Hub ou un Google Nest Hub Max, l'application Google Home affiche les appareils multipartites sous forme de plusieurs tuiles.

2026-04-10

L'application exemple Android des API Home a été mise à jour pour la version 1.8 des API Home.

Application exemple

• Consultez la version 1.8.0 de GitHub pour obtenir les notes de version complètes.

2026-04-09

  Version bêta publique 1.8 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 : 26.12.32
• Micrologiciel du hub Google, Cast, Nest Wifi Pro : 3.78.518349
• Micrologiciel du Google Nest Hub, Cast, tous les autres hubs basés sur Cast : 3.78.526062
• Micrologiciel du Google Nest Hub, Fuchsia : 29.20251023.103.2101601
• Firmware Google Nest Hub, Google TV Streamer, 4K : UTTK.250729.004
• SDK Android : home.android.sdk_GHP_1_8_0
• Application Google Home : fonctionne avec toutes les versions
• Bibliothèque androidx.core : fonctionne avec toutes les versions
• Version Matter : 1.4.1.0
• Version Matter : compatibilité expérimentale avec la version 1.5.0

Nouvelles fonctionnalités

• Suggestions d'automatisations dans l'API Automatisations.
• Compatibilité avec les appareils multiparties dans l'API Device.
• Configuration des zones d'activité de la caméra et de la sonnette dans l'API Device.
• Configuration de la détection des sons de la caméra et de la sonnette dans l'API Device.
• Mode d'enregistrement de la caméra et de la sonnette (CVR/EVR/Pas d'historique) dans l'API Device.

Problèmes connus corrigés

• Impossible de modifier les unités de température (°C/°F) du Google Nest Learning Thermostat (4e génération).
• Dans la version mobile de Google Home pour le Web, l'icône supérieure et le bouton "Retour" sont masqués par un en-tête. Il est possible que les utilisateurs ne puissent pas revenir en arrière ni voir les principaux éléments de l'interface utilisateur.
• Un hub Android TV peut signaler à tort que les appareils Matter sont hors connexion.

Problèmes connus

• La mise en service d'un appareil Matter peut échouer.

2026-03-13

  Version bêta publique 1.7.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 :
• Micrologiciel du hub Google, Cast, Nest Wifi Pro : 3.78.518349
• Micrologiciel du hub Google, Cast, tous les autres hubs basés sur Cast : 3.78.516526
• Micrologiciel Google Nest Hub, Fuchsia : 29.20251023.103.2201
• Firmware Google Nest Hub, Google TV Streamer, 4K : UTTK.250729.004
• SDK Android : home.android.sdk_GHP_1_7_1
• Application Google Home : 1.7.1
• Bibliothèque androidx.core : fonctionne avec toutes les versions
• Version Matter : 1.4.1.0
• Version Matter : compatibilité expérimentale avec la version 1.5.0

Nouvelles fonctionnalités

• Activation des données analytiques de la caméra et de la sonnette dans l'API Device.
• Heure de la dernière connexion de la caméra et de la sonnette dans l'API Device.
• État de connectivité de la caméra et de la sonnette dans l'API Device.
• Requêtes atomiques du thermostat dans l'API Device.

Autres modifications à noter

• Le mode sans hub a été supprimé.

Application exemple

• Application exemple Home APIs Android v1.7.1. Pour en savoir plus, consultez la version GitHub.

Problèmes connus corrigés

• Pour les Nest Cam Intérieur/Extérieur (batterie ou filaire) et la Nest Doorbell (batterie, 2e génération), l'option "Autonomie restante" n'est pas disponible dans les paramètres de la batterie.
• Le paramètre de durée du carillon est ignoré.
• Le voyant Philips BLE s'affiche incorrectement comme étant "en ligne", même lorsque l'appareil est en fait hors connexion.

Problèmes connus

• Impossible de modifier les unités de température (°C/°F) du Google Nest Learning Thermostat (4e génération).
• Retards potentiels dans la stabilité du réseau et la réactivité des appareils.
• Dans la version mobile de Google Home pour le Web, l'icône en haut de l'écran et le bouton "Retour" sont masqués par un en-tête. Il est possible que les utilisateurs ne puissent pas revenir en arrière ni voir les principaux éléments de l'interface utilisateur.
• Le hub peut rester bloqué à l'état "Connexion en cours" après l'OOBE en mode fédéré.
• La mise en service d'un appareil Matter peut échouer.
• Un hub Android TV peut signaler à tort que les appareils Matter sont hors connexion.
• Il est possible que la version logicielle correcte ne s'affiche pas pour la version logicielle actuelle de la caméra.
• Un curseur de l'interface utilisateur du thermostat affiche des températures hors plage.
• Lorsque la durée de la sonnerie est définie, l'appareil ne sonne pas pendant la durée spécifiée.

2026-02-13

L'application exemple Android des API Home a été mise à jour pour la version 1.7 des API Home.

Application exemple

• Consultez la version 1.7.0 de GitHub pour obtenir les notes de version complètes.

2026-02-09

  Version bêta publique 1.7 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 : 26.02.34
• Firmware du hub Google, Cast, Nest Wifi Pro : 3.76.508025
• Micrologiciel du hub Google, Cast, tous les autres hubs basés sur Cast : 3.77.510748
• Micrologiciel Google Nest Hub, Fuchsia : 29.20251023.103.2100
• Firmware Google Nest Hub, Google TV Streamer, 4K : UTTK.250729.004
• SDK Android : home.android.sdk_GHP_1_7
• Application Google Home : 1.7
• Bibliothèque androidx.core : fonctionne avec toutes les versions
• Version Matter : 1.4.1.0
• Version Matter : compatibilité expérimentale avec la version 1.5.0

Nouvelles fonctionnalités

• Automatisations locales : en fonction de conditions telles que la connectivité, les types d'appareils et les caractéristiques, certaines automatisations peuvent désormais s'exécuter localement dans l'API Automations.
• Activation de l'expérience out-of-box (OOBE) de l'appareil photo dans les applications de l'API Device.
• Thèmes de carillon pour caméras et sonnettes dans l'API Device.
• Économiseur de batterie automatique pour les caméras et les sonnettes dans l'API Device.
• Préférences d'utilisation de la batterie de la caméra et de la sonnette dans l'API Device.
• État de charge de la batterie de la caméra et de la sonnette dans l'API Device.
• Niveaux de batterie de la caméra et de la sonnette dans l'API Device.
• Numéro de série de la caméra et de la sonnette dans l'API Device.
• Modèle de caméra et de sonnette dans l'API Device.
• Version logicielle de la caméra et de la sonnette dans l'API Device.
• API de paires clé-valeur personnalisées dans l'API Device.
• Une requête d'autorisations permet à une application de déterminer les types d'appareils auxquels l'utilisateur a accordé l'accès dans l'API Permissions.

Autres modifications à noter

• HomeException.unsupported a été remplacé par HomeException.unimplemented pour s'aligner sur les codes d'erreur standards.
• Le générateur de code packagé pour les traits personnalisés a été modifié pour la version 1.7. Les développeurs qui ont des traits personnalisés doivent recompiler leurs traits une fois qu'ils ont intégré le SDK 1.7.

Problèmes connus corrigés

• L'API History renvoie toujours un nextPageToken, ce qui provoque une boucle infinie.
• L'erreur "L'utilisateur a annulé le flux d'autorisation" se produit lorsque vous essayez de vous connecter à un nouveau compte.

Problèmes connus

• Pour les Nest Cam Intérieur/Extérieur (batterie ou filaire) et la Nest Doorbell (batterie, 2e génération), l'option "Autonomie restante" n'est pas disponible dans les paramètres de la batterie.
• Le paramètre de durée du carillon est ignoré.
• Le voyant Philips BLE s'affiche incorrectement comme étant "en ligne", même lorsque l'appareil est en fait hors connexion. Solution de contournement : ne vous fiez pas uniquement à l'état en ligne du type d'appareil pour la maison connectée. Utilisez plutôt le mappage TDSS (Target Device State Service) pour les appareils avec la source LOCAL_SYNC.

2025-12-22

  Version bêta publique 1.6 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.47.30
• Micrologiciel du hub Google, Cast, Nest Wifi Pro : 3.75.479819
• Micrologiciel du hub Google, Cast, tous les autres hubs basés sur Cast : 3.77.505721
• Micrologiciel Google Hub, Fuchsia : 28.20250723.103.2100300
• Firmware Google Nest Hub, Google TV Streamer, 4K : UTTK.250729.004
• SDK Android : home.android.sdk_GHP_1_6
• Application Google Home : 1.6
• Bibliothèque androidx.core : fonctionne avec toutes les versions
• Version Matter : 1.4.1.0

Nouvelles fonctionnalités

• Compatibilité du trait météo de l'API Automation. Ajout de la compatibilité avec le trait "Météo" dans les déclencheurs et les conditions d'automatisation.
• Prise en charge de davantage de fonctionnalités des caméras et sonnettes : nouveaux paramètres (vision nocturne, voyant d'état, fenêtre d'affichage, orientation, sensibilité, durée de l'événement, carillon).
• Connexion Google initiée par l'application pour simplifier le flux UX et éliminer les vérifications des utilisateurs actifs.
• Le mode sans hub permet aux utilisateurs d'intégrer et de contrôler certains appareils Matter sans hub autonome.
• API Hub Activation pour découvrir et activer les hubs.

Autres modifications à noter

• L'application exemple Android ajoute les paramètres de la caméra, les automatisations prédéfinies, ainsi que la prise en charge du ventilateur et du haut-parleur.

Problèmes connus

• Les commandes de l'appareil cessent de fonctionner après une utilisation prolongée. Solution : Redémarrez le hub.
• La mise en service d'un appareil Matter peut échouer.
• L'erreur "User cancelled Permission flow" (L'utilisateur a annulé le flux d'autorisation) s'affiche lorsque vous essayez d'ajouter un compte dans l'application exemple pour Android. Solution : Ajoutez des comptes Google via les paramètres de l'appareil Android.
• Une caméra de sécurité filaire Walmart onn mise en service à l'aide du SDK Android Home APIs ne peut pas diffuser de flux vidéo en direct dans l'application Google Home.
• Les caméras mises en service dans les applications des API Home ne peuvent pas démarrer de sessions de diffusion en direct depuis l'application Google 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
• Micrologiciel du hub Google, Cast : 3.76.495998
• Micrologiciel Google Hub, 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 : fonctionne avec toutes les versions
• Version Matter : 1.4.1.0

Nouvelles fonctionnalités

• L'API d'activation du hub vous permet de découvrir et d'activer par programmation un hub Google Home dans l'API Structure.

Autres modifications à noter

• L'application exemple Android ajoute la prise en charge du type d'appareil Sonnette (OnOff, Diffusion en direct, Communication bidirectionnelle) et l'implémentation de l'API Hub Activation.

Problèmes connus corrigés

• L'application exemple n'affiche pas correctement l'état de l'appareil dans la vue "Appareil".

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
• Micrologiciel du hub Google, Cast : 3.76.492738
• Micrologiciel Google Hub, Fuchsia : 27.20250422.103.3600
• SDK Android : home.android.sdk_1_5
• Application Google Home : fonctionne avec toutes les versions
• Bibliothèque androidx.core : fonctionne avec toutes les versions
• Version Matter : 1.4.1.0

Nouvelles fonctionnalités

• Les déclencheurs, les conditions et les actions acceptent désormais les structures Matter comme paramètres dans l'API Automation.
• Ajout du type d'appareil photo à l'API Device (diffusion en direct, communication bidirectionnelle, démarrage/arrêt de l'enregistrement)

Autres modifications à noter

• L'application exemple Android est désormais compatible avec l'appareil photo, la mise en service multi-administrateur et l'automatisation prédéfinie OnOff.

Problèmes connus corrigés

• Lorsqu'un hub actif est supprimé de force, il s'écoule cinq minutes pendant lesquelles il est impossible de contrôler certains appareils. Au bout de cinq minutes, vous pouvez à nouveau contrôler les appareils.
• Lorsque l'utilisateur sélectionne une couleur dans un préréglage ou dans le sélecteur de température des couleurs, la couleur de la lumière de couleur étendue ne se met pas à jour.

Problèmes connus

• La latence de contrôle des appareils peut augmenter lorsque vous passez du Wi-Fi à un réseau mobile.
• Il est possible que le contrôle des types d'appareils de ventilation compatibles avec le cloud à cloud ne fonctionne pas dans l'application exemple.

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
• Micrologiciel du hub Google, Cast : 3.76.495998
• Micrologiciel Google Hub, 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 : fonctionne avec toutes les versions
• Version Matter : 1.4.0.0

Nouvelles fonctionnalités

• Une nouvelle DecommissionIneligibleReason est définie pour tenter de désactiver un appareil multisource dans l'API Device.

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.

Problèmes connus

• Lorsqu'un hub actif est supprimé de force, il s'écoule cinq minutes pendant lesquelles il est impossible de contrôler certains appareils. Au bout de cinq minutes, vous pouvez à nouveau contrôler les appareils.

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
• Micrologiciel du Google Nest Hub, Cast : 3.76.486931
• Micrologiciel Google Hub, 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 : fonctionne avec toutes les versions
• Version Matter : 1.4.0.0

Nouvelles fonctionnalités

• Les automatisations peuvent être limitées à un nombre fini d'exécutions dans l'API Automations.
• Possibilité de supprimer un appareil Matter de manière programmatique dans l'API Device.
• Suppression des membres HomeDevice obsolètes (trait(), isInRoom, isInStructure).
• Home.hasPermissions() intègre désormais l'accès à la structure OAuth et les autorisations accordées aux applications.

Autres modifications à noter

• L'application exemple Android supprime les appareils Matter uniquement, renomme les appareils et remplace les appels d'API obsolètes.

Problèmes connus corrigés

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

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 et attendez au moins 10 secondes.

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
• Micrologiciel du hub Google, Cast, Google Home, Google Home Mini et Google Nest Mini : 3.75.468362
• Micrologiciel du hub Google, Cast, Google Nest Audio : 3.75.476451
• Micrologiciel du Google Nest Hub, 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 : fonctionne avec toutes les versions
• Version Matter : 1.4.0.0

Nouvelles fonctionnalités

• L'artefact SDK a été divisé en deux artefacts distincts : le framework SDK des API Home (play-services-home-17.0.0.aar) et les traits et types d'appareils du SDK (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.

Autres modifications à noter

• L'exemple d'application Android ajoute : les utilisateurs peuvent se déconnecter et révoquer les autorisations de l'application.
• L'application exemple Android ajoute : mise à jour des artefacts 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
• Micrologiciel du hub Google, Cast : 3.75.468222
• Micrologiciel Google Nest Hub, 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 : fonctionne avec toutes les versions
• Version Matter : 1.4.0.0

Nouvelles fonctionnalités

• Présentation du trait SyntheticSwitch qui simplifie la gestion des événements générés par les appareils Matter Switch et permet aux commutateurs de déclencher des déclencheurs d'automatisation.
• Le trait ExtendedDoorLock a subi une modification destructive : le type de données du champ user_id est passé de String à Long. Les applications qui utilisent ce trait doivent être recompilées.

Autres modifications à noter

• L'application exemple Android ajoute des fonctions pour enregistrer l'état des structures, des appareils, des types, des traits et des automatisations afin de faciliter le débogage.

Problèmes connus corrigés

• 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.
• Dans l'application exemple Android, un appareil avec connectivityState PARTIALLY_ONLINE était auparavant affiché comme hors connexion. Cet état est désormais représenté comme étant en ligne.

Problèmes connus

• Dans l'application exemple Android, il arrive que le bouton "Créer une automatisation" nécessite plusieurs appuis pour se déclencher.

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
• Micrologiciel du hub Google, Cast : 3.75.468222
• Micrologiciel Google Nest Hub, 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 : fonctionne avec toutes les versions
• Version Matter : 1.4.0.0

Nouvelles fonctionnalités

• Ajout de la compatibilité avec les déclencheurs d'événements programmés récurrents dans l'API Automations, qui permet aux développeurs de créer des automatisations qui s'exécutent périodiquement en fonction de l'heure, de l'heure solaire et de conditions basées sur l'agenda, à l'aide d'expressions cron.
• Possibilité de renommer les appareils dans l'API Devices.
• Possibilité de renommer des pièces dans l'API Structure

Problèmes connus corrigés

• 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

• 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. Solution : Vérifiez que l'adresse de la maison est présente à l'aide de l'API Discovery avant de tenter de créer des automatisations.

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 des hubs Google :
  • Cast : 3.75.468222
  • Fuchsia : 24.20241009.103.1900601¹
• 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. Ce build 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 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
  • Les informations sur les appareils cloud à cloud sont désormais disponibles dans BasicInformationTrait.

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 pas et ne mettez pas 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

• API de streaming :
  • Fournit des flux d'événements qui notifient les structures, les pièces et les appareils qui ont été ajoutés, modifiés et supprimés.
  • Consultez S'abonner aux événements de relation entre entités.
• API Batching (expérimentale) :
  • Permet au développeur d'envoyer plusieurs commandes par lots qui sont exécutées simultanément.
  • Consultez Envoyer plusieurs commandes à la fois.

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 à des 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 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 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.