Notes de version du SDK Android pour les API Home

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 disponibilité générale (GA) pour le SDK Android des API Home.

Versions minimales

• Version minimale des services Google Play: 25.06.32
• Versions minimales du micrologiciel du hub Google :
  • Version de Cast: 3.75.456944
  • Version minimale de Fuchsia: 24.20241009.103.1900601
• SDK Android: home.android.sdk_202412_EAP_1_2_RC01
• Version minimale de l'application Google Home: fonctionne avec n'importe quelle version
• Version minimale de la bibliothèque androidx.core: 1.10.0
• Version Matter : 1.3.0.0
  • Remarque:Les types et clusters d'appareils Matter provisoires ne sont pas acceptés.

Nouvelles fonctionnalités

• API Automation :
  • Prise en charge des plages de dates et des dates partielles dans les conditions d'automatisation. Consultez la section Utiliser des dates avec "entre".
  • 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 est limité aux bitmaps optionsMask et optionsOverride dans les commandes de trait LevelControl.

Problèmes connus

• La latence de contrôle de l'appareil peut augmenter lors du passage du Wi-Fi à un réseau mobile.
• Une fois la configuration d'usine rétablie sur un hub, les appareils peuvent sembler être hors connexion.
• Si l'API Discovery est appelée avant l'initialisation ou avant la fin de l'initialisation, une HomeException avec code 14: UNKNOWN et le message "No route found." (Aucun itinéraire trouvé) est générée.
  • Solution de contournement: n'appelez l'API Discovery que lorsque vous avez réellement besoin de candidats d'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.
• Dans un environnement contenant plusieurs structures et plusieurs utilisateurs, le fait de passer d'une structure à une autre ou d'un utilisateur à un autre peut entraîner l'absence de retour d'appareils.

Problèmes connus corrigés

• La première fois qu'une application d'API Home appelle HomeManager.structures() après son lancement, elle ne reçoit aucune structure, même si une ou plusieurs structures sont présentes. Cela donne l'impression incorrecte qu'aucune structure n'est associée au compte Google.
• Lorsque vous chargez, créez et modifiez des automatisations, les temps d'attente peuvent être longs.
• Les utilisateurs qui lancent le flux de configuration à partir de l'application Appareil photo doivent scanner le code QR deux fois pour terminer la mise en service de 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 de l'API Home 1.1.0  

Cette version contient des corrections de bugs et améliore la qualité de disponibilité générale (GA) pour le SDK Android des API Home.

Versions minimales

• Version minimale des services Google Play: 25.02.32
• Versions minimales du micrologiciel du hub Google :
  • Version de 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 n'importe quelle version
• Version minimale de la bibliothèque androidx.core: 1.10.0
• Version Matter : 1.3.0.0
  • Remarque:Les types et clusters d'appareils Matter provisoires ne sont pas acceptés.

Nouvelles fonctionnalités

• API Streaming :
  • Fournit des flux d'événements qui signalent 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 d'entité.
• API de traitement par lots (expérimentale) :
  • Permet au développeur d'envoyer plusieurs commandes par lots qui sont exécutées simultanément.
  • Consultez la section Envoyer plusieurs commandes à la fois.

Problèmes connus

• Lorsque vous chargez, créez et modifiez des automatisations, les temps d'attente peuvent être longs.
• Les utilisateurs qui lancent le flux de configuration à partir de l'application Appareil photo doivent scanner le code QR deux fois pour terminer la mise en service de Matter.
• Dans une structure contenant plus de 200 appareils, l'API Discovery peut simplement ne renvoyer aucun candidat.

Problèmes connus corrigés

• Le changement de compte Google connecté peut échouer et entraîner une erreur.
• Les appareils Google TV peuvent ne pas fonctionner avec les automatisations qui utilisent la caractéristique MediaPlayback.
• Dans une structure ne contenant qu'un hub Google :
  • Les appareils Matter peuvent apparaître comme étant 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 de ces appareils.
• Pour certains appareils, une application peut ne pas toujours refléter l'état exact, et votre application peut signaler un état différent de celui signalé par une application Google telle que l'application Google Home. Cela est généralement dû au fait que les appareils ne signalent pas l'état à Google.
  • Solution de contournement: Vérifier l'état avec une application Google résout le problème de non-concordance.

2025-01-14

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

Nous avons clarifié 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 disponibilité générale (GA) pour le 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 du hub Google :
  • Version de 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 (GHA) : fonctionne avec n'importe quelle version
• Version minimale de la bibliothèque androidx.core: 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

• Le changement de compte Google connecté peut échouer et entraîner une erreur.
  • Solution: exécutez à nouveau le flux d'autorisations ou redémarrez l'application.
• Les appareils Google TV peuvent ne pas fonctionner avec les automatisations qui utilisent la caractéristique MediaPlayback.
• Dans une structure ne contenant qu'un hub Google :
  • Il est possible que les appareils Matter apparaissent hors connexion dans l'application Google Home (GHA).
  • 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 de ces appareils.
• Pour certains appareils, une application peut ne pas toujours refléter l'état exact, et votre application peut signaler un état différent de celui signalé par une application Google telle que l'application Google Home (GHA). 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 non-concordance.

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-écran lorsque l'API de mise en service 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 exécutant Fuchsia qui ne comporte aucun appareil Matter dans la structure, si le hub est laissé inutilisé pendant plus de trois heures, la mise en service du premier appareil Matter entraîne la mise hors service de l'appareil Matter.
• Une fois la configuration d'usine rétablie pour un hub, les commandes envoyées aux appareils nouvellement mis en service peuvent échouer, même si l'appareil est signalé comme étant en ligne.