Versionshinweise zum Android SDK für Smart-Home-APIs

2025-03-14

  Home APIs Public Beta-Release 1.2.0  

Diese Version enthält Fehlerkorrekturen und verbessert die Qualität der allgemeinen Verfügbarkeit (General Availability, GA) für das Android SDK der Home APIs.

Mindestversionen

  • Mindestversion der Google Play-Dienste: 25.06.32
  • Mindestversionen der Google-Hub-Firmware:
    • Cast-Version: 3.75.456944
    • Mindestversion von Fuchsia: 24.20241009.103.1900601
  • Android SDK: home.android.sdk_202412_EAP_1_2_RC01
  • Mindestversion der Google Home App: Funktioniert mit jeder Version
  • androidx.core Mindestversion der Bibliothek: 1.10.0
  • Matter-Version: 1.3.0.0
    • Hinweis:Vorläufige Matter-Gerätetypen und ‑Cluster werden nicht unterstützt.

Neue Funktionen

  • Automatisierungs-API:
    • Unterstützung für Zeiträume und Teildaten in Automatisierungsbedingungen Weitere Informationen finden Sie unter Datumsangaben mit „between“ verwenden.
    • In früheren Releases gab die Discovery API für einige Bitmap-Felder NumberSetConstraint zurück, obwohl BitmapConstraint hätte zurückgegeben werden sollen. Diese Felder geben jetzt wie erwartet einen BitmapConstraint zurück. Dies ist auf optionsMask- und optionsOverride-Bitmaps in den LevelControl-Merkmalsbefehlen beschränkt.

Bekannte Probleme

  • Beim Wechsel von WLAN zu einem Mobilfunknetz kann es zu einer erhöhten Latenz bei der Gerätesteuerung kommen.
  • Nach dem Zurücksetzen eines Hubs werden Geräte möglicherweise als offline angezeigt.
  • Wenn die Discovery API vor der Initialisierung oder vor Abschluss der Initialisierung aufgerufen wird, wird eine HomeException mit code 14: UNKNOWN und die Meldung „Kein Weg gefunden“ ausgegeben.
    • Umgehung: Rufen Sie die Discovery API nur dann auf, wenn Sie tatsächlich Kandidaten für die Automatisierung benötigen. Vorabladen und Zwischenspeichern von Kandidatenentitäten nicht aktivieren. Prüfen Sie, ob ein Rechtssubjekt online ist, bevor Sie Discovery API-Methoden darauf aufrufen.
  • In einer Umgebung mit mehreren Gebäuden und mehreren Nutzern kann das Wechseln zwischen Gebäuden und Nutzern dazu führen, dass keine Geräte zurückgegeben werden.

Bekannte Probleme behoben

  • Wenn eine Home APIs-App nach dem Starten zum ersten Mal HomeManager.structures() aufruft, werden keine Gebäude zurückgegeben, auch wenn mindestens ein Gebäude vorhanden ist. Das vermittelt den falschen Eindruck, dass mit dem Google-Konto keine Gebäude verknüpft sind.
  • Beim Laden, Erstellen und Bearbeiten von Automatisierungen kann es zu langen Wartezeiten kommen.
  • Nutzer, die die Einrichtung über die Kamera-App starten, müssen den QR-Code zweimal scannen, um die Matter-Inbetriebnahme abzuschließen.
  • In einem Gebäude mit mehr als 200 Geräten gibt die Discovery API möglicherweise keine Kandidaten zurück.

2025-01-29

  Home APIs Public Beta-Release 1.1.0  

Diese Version enthält Fehlerkorrekturen und verbessert die Qualität der allgemeinen Verfügbarkeit (General Availability, GA) für das Android SDK der Home APIs.

Mindestversionen

  • Mindestversion der Google Play-Dienste: 25.02.32
  • Mindestversionen der Google-Hub-Firmware:
    • Cast-Version: 3.75.456944
    • Mindestversion von Fuchsia: 24.20241009.103.1900500
  • Android SDK: home.android.sdk_202412_EAP_1_1_RC04
  • Mindestversion der Google Home App: Funktioniert mit jeder Version
  • androidx.core Mindestversion der Bibliothek: 1.10.0
  • Matter-Version: 1.3.0.0
    • Hinweis:Vorläufige Matter-Gerätetypen und ‑Cluster werden nicht unterstützt.

Neue Funktionen

  • Streaming API:
  • Batching API (experimentell):
    • Ermöglicht es dem Entwickler, mehrere Befehle in Batches zu senden, die gleichzeitig ausgeführt werden.
    • Weitere Informationen finden Sie unter Mehrere Befehle gleichzeitig senden.

Bekannte Probleme

  • Beim Laden, Erstellen und Bearbeiten von Automatisierungen kann es zu langen Wartezeiten kommen.
  • Nutzer, die die Einrichtung über die Kamera-App starten, müssen den QR-Code zweimal scannen, um die Matter-Inbetriebnahme abzuschließen.
  • In einem Gebäude mit mehr als 200 Geräten gibt die Discovery API möglicherweise keine Kandidaten zurück.

Bekannte Probleme behoben

  • Das Wechseln des angemeldeten Google-Kontos kann fehlschlagen und zu einem Fehler führen.
  • Google TV-Geräte funktionieren möglicherweise nicht für Automatisierungen, bei denen das Attribut MediaPlayback verwendet wird.
  • In einem Gebäude, das nur einen Google-Hub enthält:
    • Matter-Geräte werden in der Google Home App möglicherweise als offline angezeigt.
    • Google Assistant kann Matter-Geräte nicht steuern.
    • Smart Displays können keine Matter-Geräte steuern oder den Status eines Matter-Geräts anzeigen.
  • Bei einigen Geräten wird der Status in einer App möglicherweise nicht immer korrekt angezeigt. Außerdem kann es sein, dass Ihre App einen anderen Status meldet als eine Google-App wie die Google Home App. Das liegt in der Regel daran, dass Geräte ihren Status nicht an Google senden.
    • Problemumgehung: Wenn Sie den Status mit einer Google-App prüfen, wird die Abweichung behoben.

2025-01-14

Aktualisierte Anleitung zur Initialisierung von Home APIs.

Wir haben klarer formuliert, dass eine Instanz eines Zuhauses als Kontext-Singleton initialisiert werden sollte. So wird die Nutzerfreundlichkeit in Ihrer App verbessert und Fehler bei ungültigen Sitzungen vermieden.

2025-01-07

  Öffentliche Betaversion der Home APIs  

Während der öffentlichen Entwickler-Betaphase können alle Entwickler mit dem Erstellen und Testen ihrer Apps beginnen.

Diese Version enthält Fehlerkorrekturen und verbessert die allgemeine Verfügbarkeit (GA) für das Android SDK der Home APIs. Außerdem wird die Unterstützung für Google Nest Audio- und Google TV-Geräte verbessert.

Mindestversionen

  • Mindestversion der Google Play-Dienste: 24.45.34
  • Mindestversionen der Google-Hub-Firmware:
    • Cast-Version: 3.74.444798
    • Mindestversion von Fuchsia: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • Mindestversion der Google Home App (GHA): Funktioniert mit jeder Version
  • androidx.core Mindestversion der Bibliothek: 1.10.0
  • Matter-Version: 1.3.0.0
    • Hinweis: Vorläufige Matter-Gerätetypen und -Cluster werden nicht unterstützt.

Bekannte Probleme

  • Das Wechseln des angemeldeten Google-Kontos kann fehlschlagen und zu einem Fehler führen.
    • Problemumgehung: Führen Sie den Berechtigungsablauf noch einmal aus oder starten Sie die App neu.
  • Google TV-Geräte funktionieren möglicherweise nicht für Automatisierungen, bei denen das Attribut MediaPlayback verwendet wird.
  • In einem Gebäude, das nur einen Google-Hub enthält:
    • Matter-Geräte werden in der Google Home App (GHA) möglicherweise als offline angezeigt.
    • Google Assistant kann Matter-Geräte nicht steuern.
    • Smart Displays können keine Matter-Geräte steuern oder den Status eines Matter-Geräts anzeigen.
  • Bei einigen Geräten spiegelt eine App möglicherweise nicht immer den korrekten Status wider. Außerdem kann es sein, dass Ihre App einen anderen Status meldet als eine Google-App wie die Google Home App (GHA). Das liegt in der Regel daran, dass Geräte ihren Status nicht an Google melden.
    • Problemumgehung: Wenn Sie den Status mit einer Google-App prüfen, wird die Abweichung behoben.

Bekannte Probleme behoben

  • Die Inbetriebnahme kann fehlschlagen, wenn die App während des Vorgangs minimiert wird.
    • Problemumgehung: Verwenden Sie die suppressHalfSheetNotification() API, um Benachrichtigungen im Halbbildschirmmodus zu unterdrücken, wenn die Commissioning API in Ihrer App verwendet wird.
  • Ein serverseitiges Problem kann verhindern, dass OkGoogle-Auslöser in Automatisierungen funktionieren.
  • Wenn Sie einen Hub mit Fuchsia verwenden, in dem sich keine Matter-Geräte im Gebäude befinden, und der Hub länger als 3 Stunden inaktiv bleibt, wird das erste Matter-Gerät bei der Inbetriebnahme offline geschaltet.
  • Nachdem ein Hub auf die Werkseinstellungen zurückgesetzt wurde, können Befehle an neu in Betrieb genommene Geräte fehlschlagen, obwohl das Gerät als online angezeigt wird.