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

2025-10-23

  Home APIs Public Beta-Version 1.5.1  

Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Android SDK für Home APIs.

Mindestversionen

  • Google Play-Dienste: 25.41.30
  • Mindestversionen der Google-Hub-Firmware:
    • Cast: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5_1
  • Google Home App: Funktioniert mit jeder Version
  • androidx.core-Bibliothek: Funktioniert mit jeder Version
  • Matter-Version: 1.4.1.0

Neue Funktionen

  • Gebäude-API
    • Mit der Hub-Aktivierungs-API kannst du programmatisch einen Google Home-Hub erkennen und aktivieren. Weitere Informationen finden Sie unter Hub Activation API für Android.
  • Android-Beispiel-App
    • Unterstützung des Gerätetyps „Türklingel“ für:
      • OnOff
      • Livestream
      • Zwei-Wege-Gespräch
    • Hub Activation API: Hubs aktivieren

Behobene bekannte Probleme

  • In der Beispiel-App wird der Gerätestatus in der Ansicht Gerät nicht richtig angezeigt.

2025-09-26

  Home APIs – öffentliche Betaversion 1.5.0  

Dieser Release bietet Unterstützung für Kamerageräte, enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.

Mindestversionen

  • Google Play-Dienste: 25.37.31
  • Mindestversionen der Google-Hub-Firmware:
    • Cast: 3.76.492738
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5
  • Google Home App: Funktioniert mit jeder Version
  • androidx.core-Bibliothek: Funktioniert mit jeder Version
  • Matter-Version: 1.4.1.0

Neue Funktionen

  • Automatisierungs-API
    • Auslöser, Bedingungen und Aktionen akzeptieren jetzt Matter-Strukturen als Parameter.
  • Geräte-API
    • Kameragerätetyp hinzugefügt. Die folgenden Kamerafunktionen sind auch für den Gerätetyp „Türklingel“ verfügbar:
      • Kamera-Livestream
      • Zweiwege-Audiofunktion der Kamera.
      • Kamera startet und stoppt die Aufnahme.
  • Android-Beispiel-App
    • Unterstützung für den Gerätetyp „Kamera“:
      • Kamera-Livestream
      • Zweiwege-Audiofunktion der Kamera.
      • Kamera startet und stoppt die Aufnahme.
      • Eingeschränkte Berechtigungen für Gerätetypen.
    • Inbetriebnahme durch mehrere Administratoren (gemeinsam verwendetes in Betrieb genommenes Gerät)
    • Vordefinierte OnOff-Automatisierung.

Bekannte Probleme

  • Beim Wechsel von WLAN zu einem Mobilfunknetz kann es zu einer erhöhten Latenz bei der Gerätesteuerung kommen.
  • Die Steuerung von Lüftergeräten, die von Cloud-to-Cloud unterstützt werden, funktioniert in der Beispiel-App möglicherweise nicht.

Behobene bekannte Probleme

  • Wenn der derzeit aktive Hub zwangsweise entfernt wird, können einige Geräte fünf Minuten lang nicht gesteuert werden. Nach fünf Minuten können Geräte wieder gesteuert werden.
  • Nachdem der Nutzer eine Farbe aus einer Voreinstellung oder aus der Farbtemperaturauswahl ausgewählt hat, wird die Farbe des Extended Color Light nicht aktualisiert.

2025-09-08

Die Beispiel-App für Android Version 1.4.1 wurde veröffentlicht.

Neue Funktionen

  • Räume erstellen, umbenennen, aktualisieren und löschen.
  • Inbetriebnahme in einem Matter-Fabric eines Drittanbieters

Behobene bekannte Probleme

  • Der Link zur Seite zum Widerrufen von Berechtigungen funktioniert jetzt.

2025-08-29

  Home APIs – öffentliche Betaversion 1.4.1  

Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.

Mindestversionen

  • Google Play-Dienste: 25.33.32
  • Mindestversionen der Google-Hub-Firmware:
    • Cast: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_1
  • Google Home App: Funktioniert mit jeder Version
  • androidx.core-Bibliothek: Funktioniert mit jeder Version
  • Matter-Version: 1.4.0.0

Neue Funktionen

Bekannte Probleme

  • Wenn der derzeit aktive Hub zwangsweise entfernt wird, können einige Geräte fünf Minuten lang nicht gesteuert werden. Nach fünf Minuten können Geräte wieder gesteuert werden.

Behobene bekannte Probleme

  • Die Android-Beispiel-App stürzt ab, wenn ein Nutzer versucht, einen Thermostat auf einen Modus einzustellen, der nicht unterstützt wird.

31.07.2025

  Home APIs – öffentliche Betaversion 1.4.0  

Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.

Mindestversionen

  • Google Play-Dienste: 25.28.34
  • Mindestversionen der Google-Hub-Firmware:
    • Cast: 3.76.486931
    • Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_0
  • Google Home App: Funktioniert mit jeder Version
  • androidx.core-Bibliothek: Funktioniert mit jeder Version
  • Matter-Version: 1.4.0.0

Neue Funktionen

  • Automatisierungs-API
    • Automatisierungen können so eingeschränkt werden, dass sie maximal eine endliche Anzahl von Malen ausgeführt werden können. Siehe Limit the number of executions.

Bekannte Probleme

  • Nach dem Ab- und erneuten Anmelden auf einem Telefon kann eine Home APIs-App keine Geräte mehr steuern.
    • Abhilfe: Schließen Sie die App oder verschieben Sie sie in den Hintergrund und warten Sie dann mindestens 10 Sekunden, bevor Sie es erneut versuchen.

Behobene bekannte Probleme

  • Bei angedockten Staubsaugergeräten wird der Status „Angedockt“ nicht registriert.

08.07.2025

Mit der Cast-Firmwareversion 3.76.479819 kann Nest Wifi Pro jetzt als Hub für Home-APIs fungieren.

26.06.2025

  Home APIs Öffentliche Beta-Version 1.3.2  

Diese Version enthält Fehlerbehebungen und verbessert die Beta-Qualität des Home APIs Android SDK.

Mindestversionen

  • Google Play-Dienste: 25.23.31
  • Mindestversionen der Google Hub-Firmware:
    • Besetzung:
      • Google Home, Google Home Mini und Google Nest Mini: 3.75.468362
      • Google Nest Audio: 3.75.476451
    • Fuchsia: 26.20250116.103.2900
  • Android SDK: home.android.sdk_1_3_2
  • Google Home App: funktioniert mit jeder Version
  • androidx.core-Bibliothek: Funktioniert mit jeder Version
  • Matter-Version: 1.4.0.0

Neue Funktionen

  • Das SDK-Artefakt wurde in zwei separate Artefakte unterteilt:
    • Das Home APIs SDK-Framework (play-services-home-17.0.0.aar)
    • SDK-Merkmale und Gerätetypen (play-services-home-types-17.0.0.aar)

    Ab dieser Version müssen Entwickler beide Artefakte in die Bibliotheks-Pfade für die Kompilierzeit und die Laufzeit ihres Projekts einfügen.

Android-Beispiel-App

  • Nutzer können die Verbindung zur App trennen und Berechtigungen widerrufen.
  • Die SDK-Artefakte wurden aktualisiert, um play-services-home-17.0.0 und play-services-home-types-17.0.0 einzuschließen.

Bekannte Probleme

  • Bei angedockten Staubsaugergeräten wird der Status „Angedockt“ nicht registriert.

2025-06-05

  Home APIs – öffentliche Betaversion 1.3.1  

Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.

Mindestversionen

  • Google Play-Dienste: 25.19.32
  • Mindestversionen der Google-Hub-Firmware:
    • Cast: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
  • Google Home App: Funktioniert mit jeder Version
  • androidx.core-Bibliothek: Funktioniert mit jeder Version
  • Matter-Version: 1.4.0.0

Neue Funktionen

Attribute

Android-Beispiel-App

Es wurden Funktionen hinzugefügt, um den Zustand von Strukturen, Geräten, Typen, Eigenschaften und Automatisierungen zu protokollieren und so das Debuggen zu vereinfachen.

Bekannte Probleme

In der Android-Beispiel-App muss die Schaltfläche Automatisierung erstellen gelegentlich mehrmals angetippt werden, um ausgelöst zu werden.

Bekannte Probleme behoben

  • Die Google Home App stürzt beim Erstellen von Automatisierungen mit der Fehlermeldung FailedPreconditionException ab, wenn der Standort des Hauses nicht in der Google Home App (GHA) festgelegt ist (siehe Ändern der Google Home-Adresse für Informationen zum Festlegen des Standorts eines Hauses).
  • In der Android-Beispiel-App wurde dem Benutzer zuvor ein Gerät mit connectivityState PARTIALLY_ONLINE als offline angezeigt. Dieser Status wird jetzt als online dargestellt.

2025-05-12

  Home APIs Öffentliche Beta-Version 1.3  

Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.

Mindestversionen

  • Google Play-Dienste: 25.16.33
  • Mindestversionen der Google-Hub-Firmware:
    • Cast: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • Google Home App: funktioniert mit jeder Version
  • androidx.core Bibliothek: funktioniert mit jeder Version
  • Matter-Version: 1.4.0.0

Neue Funktionen

  • Automatisierungen-API
    • Unterstützung für Auslöser für wiederkehrende geplante Ereignisse hinzugefügt. Damit können Entwickler automatisierte Abläufe erstellen, die regelmäßig auf Grundlage von Uhrzeit, Sonnenzeit und kalenderbasierten Bedingungen mit cron-Ausdrücken ausgeführt werden.
  • Geräte-API
  • Gebäude-API

Bekannte Probleme

Die Google Home App stürzt mit einem FailedPreconditionException ab, wenn beim Erstellen von automatisierten Abläufen der Standort des Zuhauses nicht in der Google Home App festgelegt ist. Hier erfährst du, wie du die Privatadresse ändern kannst.

  • Problemumgehung: Prüfen Sie mit der Discovery API, ob die Adresse des Zuhauses vorhanden ist, bevor Sie versuchen, Automatisierungen zu erstellen.

Behobene 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 auf die Werkseinstellungen werden Geräte möglicherweise als offline angezeigt.

2025-04-09

  Home APIs – öffentliche Betaversion 1.2.1  

Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.

Mindestversionen

  • Google Play-Dienste: 25.09.33
  • Mindestversionen der Google-Hub-Firmware:
    • Cast: 3.75.468222
    • Fuchsia: 24.20241009.103.19006011
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • Google Home App: Funktioniert mit jeder Version
  • androidx.core-Bibliothek: 1.10.0
  • Matter-Version: 1.4.0.0
1. Dieser Build wird derzeit in der Produktion eingeführt und ist ab dem 22. April 2025 für alle Geräte verfügbar.

Neue Funktionen

  • Die Leistung beim Laden von Objekten aus dem Home Graph wurde verbessert.
  • Automatisierungen-API
    • Unterstützung für Entitätsfilter hinzugefügt, mit denen Geräte in Automatisierungen dynamisch anhand von in der Automatisierung angegebenen Kriterien ausgewählt werden können.
  • Geräte-API

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 auf die Werkseinstellungen werden Geräte möglicherweise als offline angezeigt.

Behobene bekannte Probleme

  • Wenn die Discovery API vor der Initialisierung oder vor Abschluss der Initialisierung aufgerufen wird, wird ein HomeException mit code 14: UNKNOWN und der Meldung „No route found.“ ausgegeben.
  • In einer Umgebung mit mehreren Strukturen und mehreren Nutzern kann es vorkommen, dass beim Wechseln zwischen Strukturen und Nutzern keine Geräte zurückgegeben werden.

2025-03-14

  Home APIs Public Beta – Version 1.2.0  

Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.

Mindestversionen

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

Neue Funktionen

  • Automation API:
    • Unterstützung für Datumsbereiche und Teildaten in Automatisierungsbedingungen. Weitere Informationen finden Sie unter Datumsangaben mit „zwischen“ verwenden.
    • In früheren Releases hat die Discovery API für einige Bitmap-Felder NumberSetConstraint zurückgegeben, obwohl BitmapConstraint hätte zurückgegeben werden sollen. Diese Felder geben jetzt wie erwartet BitmapConstraint zurück. Dies ist auf optionsMask- und optionsOverride-Bitmaps in den Befehlen des Traits LevelControl 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 auf die Werkseinstellungen werden Geräte möglicherweise als offline angezeigt.
  • Wenn die Discovery API vor der Initialisierung oder vor Abschluss der Initialisierung aufgerufen wird, wird ein HomeException mit code 14: UNKNOWN und der Meldung „No route found.“ ausgegeben.
    • Problemumgehung: Rufen Sie die Discovery API nur auf, wenn Sie tatsächlich Automatisierungskandidaten benötigen. Kandidatenentitäten nicht vorabrufen und im Cache speichern Prüfen Sie, ob eine Einheit online ist, bevor Sie Discovery API-Methoden für sie aufrufen.
  • In einer Umgebung mit mehreren Strukturen und mehreren Nutzern kann es vorkommen, dass beim Wechseln zwischen Strukturen und Nutzern keine Geräte zurückgegeben werden.

Behobene bekannte Probleme

  • Wenn eine Home APIs-App nach dem Start zum ersten Mal HomeManager.structures() aufruft, empfängt sie null Strukturen, selbst wenn eine oder mehrere Strukturen vorhanden sind. Dadurch entsteht der falsche Eindruck, dass keine Strukturen mit dem Google-Konto verknüpft sind.
  • Beim Laden, Erstellen und Bearbeiten von Automatisierungen kann es zu langen Wartezeiten kommen.
  • Benutzer, die den Einrichtungsvorgang über die Kamera-App starten, müssen den QR-Code zweimal scannen, um die Matter-Inbetriebnahme abzuschließen.
  • In einer Struktur mit mehr als 200 Geräten gibt die Discovery API möglicherweise einfach keine Kandidaten zurück.

2025-01-29

  Home APIs Öffentliche Beta-Version 1.1.0  

Diese Version enthält Fehlerbehebungen und verbessert die Beta-Qualität des Home APIs Android SDK.

Mindestversionen

  • Mindestversion der Google Play-Dienste: 25.02.32
  • Mindestversionen der Google-Hub-Firmware:
    • Cast-Version: 3.75.456944
    • Fuchsia min version: 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 Bibliothek – Mindestversion: 1.10.0
  • Matter-Version: 1.3.0.0
    • Hinweis: Vorläufige Gerätetypen und Cluster werden nicht unterstützt.

Neue Funktionen

Bekannte Probleme

  • Beim Laden, Erstellen und Bearbeiten von automatisierten Abläufen kann es zu langen Wartezeiten kommen.
  • Benutzer, die den Einrichtungsvorgang über die Kamera-App starten, müssen den QR-Code zweimal scannen, um die Matter-Inbetriebnahme abzuschließen.
  • In einer Struktur mit mehr als 200 Geräten kann die Discovery API möglicherweise einfach keine Kandidaten zurückgeben.

Behobene bekannte Probleme

  • Das Wechseln des angemeldeten Google-Kontos kann fehlschlagen und zu einem Fehler führen.
  • Google TV-Geräte funktionieren möglicherweise nicht mit Automatisierungen, die das MediaPlayback-Trait verwenden.
  • In einer Struktur, die 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 Matter-Geräte nicht steuern und auch nicht den Status von Matter-Geräten anzeigen.
  • Bei manchen Geräten spiegelt eine App möglicherweise nicht immer den korrekten Status wider, und Ihre App meldet unter Umständen einen anderen Status als eine Google-App wie die Google Home App. Dies liegt in der Regel daran, dass die Geräte ihren Status nicht an Google übermitteln.
    • Abhilfe: Die Diskrepanz lässt sich durch Überprüfung des Status mit einer Google-App beheben.

2025-01-14

Aktualisierte Anleitung zur Initialisierung der Home-APIs.

Wir haben deutlicher gemacht, dass eine Instanz von Home als Kontext-Singleton initialisiert werden sollte. So wird eine reibungslosere Nutzererfahrung in Ihrer App gewährleistet und Fehler bei ungültigen Sitzungen werden vermieden.

2025-01-07

  Öffentliche Betaversion der Home-APIs  

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

Diese Version enthält Fehlerbehebungen und verbessert die Beta-Qualität des Home APIs Android SDK, einschließlich einer verbesserten Unterstützung für Google Nest Audio- und Google TV-Geräte.

Mindestversionen

  • Mindestversion der Google Play-Dienste: 24.45.34
  • Mindestversionen der Google-Hub-Firmware:
    • Cast-Version: 3.74.444798
    • Fuchsia-Mindestversion: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • Google Home App (GHA), Mindestversion: Funktioniert mit jeder Version
  • androidx.core Bibliothek – Mindestversion: 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, die das Merkmal MediaPlayback verwenden.
  • In einer Struktur, die 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 Matter-Geräte nicht steuern und den Status von Matter-Geräten nicht anzeigen.
  • Bei einigen Geräten wird der Status in einer App möglicherweise nicht immer korrekt angezeigt und deine App meldet möglicherweise einen anderen Status als eine Google-App wie die Google Home App (GHA). Das liegt in der Regel daran, dass Geräte den Status nicht an Google melden.
    • Problemumgehung: Wenn Sie den Status mit einer Google-App prüfen, wird die Diskrepanz behoben.

Behobene bekannte Probleme

  • Die Inbetriebnahme kann fehlschlagen, wenn die App während des Vorgangs minimiert wird.
  • Ein serverseitiges Problem kann verhindern, dass „Ok Google“-Starter in automatisierten Abläufen funktionieren.
  • Wenn du einen Hub mit Fuchsia verwendest, der keine Matter-Geräte im Zuhause hat, und der Hub länger als 3 Stunden im Leerlauf ist, führt die Inbetriebnahme des ersten Matter-Geräts dazu, dass das Matter-Gerät offline ist.
  • Nachdem ein Hub auf die Werkseinstellungen zurückgesetzt wurde, schlagen Befehle an neu in Betrieb genommene Geräte möglicherweise fehl, obwohl das Gerät als online gemeldet wird.