2026-09-23
GA-Release 1.11 der Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Qualität der Home APIs Android SDK für die allgemeine Verfügbarkeit.
Mindestversionen
- Google Play-Dienste: 26.36.25
- Google-Hub-Firmware, Cast, Nest Wifi Pro: 3.78.548779
- Google-Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.79.550760
- Google Hub-Firmware, Fuchsia: 31.20260429.103.8712702
- Google Hub-Firmware, Google TV Streamer (4K): UTTK.260317.003
- Android SDK: home.android.sdk_GHP_1_11
- Google Home App: Funktioniert mit jeder Version
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
- Matter-Version: experimentelle Unterstützung für 1.5.0
Wichtige Updates
-
Ab Version 1.11 ist für die Home-APIs Kotlin 2.4.0 erforderlich. Wenn Sie eine Home APIs-App mit einer früheren Version von Kotlin kompilieren, müssen Sie die Compiler-Option
-Xskip-metadata-version-checkverwenden, um metadatenbezogene Fehler zu unterdrücken. - Ab Version 1.11 müssen Entwickler ihre Gradle-Datei aktualisieren, um die kotlinx.coroutines-Bibliotheken zu importieren, damit die neuesten Kotlin-Coroutines weiterhin unterstützt werden. Bei allen Kotlin-Apps, die die Home-APIs verwenden, tritt ein blockierender Laufzeitfehler auf, wenn dieses Update nicht durchgeführt wird.
Neue Funktionen
Weitere wichtige Änderungen
2026-09-16
Wir haben zwei neue MCP-Server eingeführt. Mit Home MCP können persönliche KI-Agenten sicher mit deinem Smart Home interagieren. Mit Home Developer MCP können deine bevorzugten KI-Agenten Dokumentationen aus dem Home Developer Center und andere Smart-Home-Ressourcen durchsuchen und abfragen.
Neue Funktionen
2026-09-16
Die Android-Beispiel-App für die Home APIs wurde für die Version 1.10.1 der Home APIs aktualisiert.
Beispiel-App
2026-08-28
GA-Release 1.10.1 der Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Qualität der Home APIs Android SDK für die allgemeine Verfügbarkeit.
Mindestversionen
- Google Play-Dienste: 26.34.30
- Google-Hub-Firmware, Cast, Nest Wifi Pro: 3.78.548779
- Google Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.79.547681
- Google Hub-Firmware, Fuchsia: 31.20260429.103.8712702
- Google Hub-Firmware, Google TV Streamer (4K): UTTK.260317.003
- Android SDK: home.android.sdk_GHP_1_10_1
- Google Home App: Funktioniert mit jeder Version
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
- Matter-Version: experimentelle Unterstützung für 1.5.0
Wichtige Updates
Neue Funktionen
- Dynamische Befehlsparameter werden jetzt in der Automation API unterstützt.
- If/else-Logik wird jetzt in der Automation API unterstützt.
Weitere wichtige Änderungen
2026-08-07
Die Android-Beispiel-App für Home APIs wurde für die Version 1.10 der Home APIs aktualisiert.
Beispiel-App
2026-08-03
GA-Release 1.10 der Home-APIsDiese Version enthält Fehlerkorrekturen und das Home APIs Android SDK wurde auf GA-Qualität hochgestuft.
Mindestversionen
- Google Play-Dienste: 26.28.31
- Google Hub-Firmware, Cast, Nest Wifi Pro: 3.78.518349
- Google Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.78.540761
- Google-Hub-Firmware, Fuchsia: 30.20260121.103.1602904
- Google Hub-Firmware, Google TV Streamer (4K): UTTK.260317.003
- Android SDK: home.android.sdk_GHP_1_10
- Google Home App: Funktioniert mit jeder Version
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
- Matter-Version: experimentelle Unterstützung für 1.5.0
2026-07-09
Das Flag forceLaunch wurde verworfen. Apps sollten zur ForcePermissionFlow-Enumeration migriert werden, um das Verhalten der Einwilligungsoberfläche anzugeben.
Anstehende Änderungen
-
Eingestellte API:Die Methode
requestPermissions(forceLaunch: Boolean, ...)wurde im Android Google Home SDK eingestellt. -
Migrationsschritt:Ersetzen Sie boolesche Flags durch
ForcePermissionFlow.FORCE_LAUNCH(fürtrue) oderForcePermissionFlow.DO_NOT_FORCE_LAUNCH(fürfalse).
2026-07-08
Der Leitfaden für Border-Router-Geräte für Android ist jetzt verfügbar.
Neue Inhalte
2026-07-07
Die Android-Beispiel-App für Home-APIs wurde für die Version 1.9.1 der Home-APIs aktualisiert.
Beispiel-App
2026-06-26
Home APIs Public Beta-Version 1.9.1Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Android-SDK für Home APIs.
Mindestversionen
- Google Play-Dienste: 26.24.22
- Google Hub-Firmware, Cast, Nest Wifi Pro: 3.78.518349
- Google Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.78.538123
- Google-Hub-Firmware, Fuchsia: 30.20260121.103.1602904
- Google Hub-Firmware, Google TV Streamer (4K): UTTK.250729.004 (14748786)
- Android SDK: home.android.sdk_1_9_1.zip
- Google Home App: Funktioniert mit jeder Version
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
- Matter-Version: experimentelle Unterstützung für 1.5.0
Neue Funktionen
- Kamera und Türklingel: Status des Akkutauschs
- Unterstützung von Kamerabildern und Bildern von Türklingeln als Vorschau bei der Einrichtung von Aktivitätszonen und Livestreams
Behobene bekannte Probleme
- Die Einrichtung mit Schnelles Pairing wird für die Google Nest Cam (Outdoor, mit Kabel, 2. Generation), die Google Nest Cam (Indoor, mit Kabel, 3. Generation) und die Nest Doorbell (mit Kabel, 3. Generation) nicht unterstützt.
2026-06-09
Die Android-Beispiel-App für die Home-APIs wurde für die Home-APIs 1.9.0 aktualisiert.
Beispiel-App
2026-05-29
Home APIs – öffentliche Betaversion 1.9Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.
Mindestversionen
- Google Play-Dienste: 26.20.31
- Google Hub-Firmware, Cast, Nest Wifi Pro: 3.78.518349
- Google-Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.78.526062
- Google-Hub-Firmware, Fuchsia: 30.20260121.103.1602904
- Google Hub-Firmware, Google TV Streamer (4K): UTTK.250729.004 (14748786)
- Android SDK: home.android.sdk_GHP_1_9
- Google Home App: Funktioniert mit jeder Version
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
- Matter-Version: experimentelle Unterstützung für 1.5.0
Neue Funktionen
- Kamera- und Türklingeleinstellungen: Art der Kamerahalterung
- Kamera- und Türklingeleinstellungen: Benachrichtigungen über Besucher
- Kamera- und Türklingeleinstellungen: Livestream-Qualität
- Kurzantworten bei der Türklingel
- Strukturhinweise, damit Partner Strukturen für den Berechtigungsablauf vorab auswählen können
- Unterstützung von Geräten mit mehreren Teilen in automatisierten Abläufen
-
Updates für die folgenden benutzerdefinierten Google-Traits:
ExtendedFanControl,ExtendedThermostat -
Updates für die folgenden Matter-Traits:
ArmDisarm,FanControl,Thermostat,ThermostatFanControl,ThermostatUserInterfaceConfiguration
Bekannte Probleme
- Die Einrichtung mit Schnelles Pairing wird für die Google Nest Cam (Outdoor, mit Kabel, 2. Generation), die Google Nest Cam (Indoor, mit Kabel, 3. Generation) und die Nest Doorbell (mit Kabel, 3. Generation) nicht unterstützt.
2026-05-26
Die Home APIs Android-Beispiel-App wurde für die Home APIs 1.8.1 aktualisiert.
Beispiel-App
2026-05-01
Home APIs – öffentliche Betaversion 1.8.1Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.
Mindestversionen
- Google Play-Dienste: 26.16.31
- Google Hub-Firmware, Cast, Nest Wifi Pro: 3.78.518349
- Google-Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.78.526062
- Google Hub-Firmware, Fuchsia: 30.20260121.103.1602802
- Google Hub-Firmware, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_8_1
- Google Home App: Version 4.8 oder höher
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
- Matter-Version: experimentelle Unterstützung für 1.5.0
Neue Funktionen
- Das Thermostat-Trait unterstützt jetzt die Funktionen „Lesen/Aktualisieren“, „Ein/Aus“ und „Timer“
Behobene bekannte Probleme
- Die Inbetriebnahme eines Matter-Geräts kann fehlschlagen.
- Der Status der Philips BLE-Lampe wird nicht richtig angezeigt.
- Latenz, die zu Netzwerkinstabilität und langsamen Reaktionszeiten führt.
Bekannte Probleme
- Einige Geräte können nicht mit dem Google TV Streamer (4K) in Betrieb genommen werden.
- Wenn der Hub ein Nest Wifi Pro, Google Nest Hub oder Google Nest Hub Max ist, werden Geräte mit mehreren Teilen in der Google Home App als mehrere Kacheln angezeigt.
2026-04-10
Die Android-Beispiel-App für die Home-APIs wurde für die Home-APIs 1.8 aktualisiert.
Beispiel-App
2026-04-09
Home APIs – öffentliche Betaversion 1.8Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.
Mindestversionen
- Google Play-Dienste: 26.12.32
- Google Hub-Firmware, Cast, Nest Wifi Pro: 3.78.518349
- Google-Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.78.526062
- Google-Hub-Firmware, Fuchsia: 29.20251023.103.2101601
- Google Hub-Firmware, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_8_0
- Google Home App: Funktioniert mit jeder Version
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
- Matter-Version: experimentelle Unterstützung für 1.5.0
Neue Funktionen
- Vorgeschlagene Automatisierungen in der Automations API
- Unterstützung für Geräte mit mehreren Teilen in der Device API
- Einrichtung von Aktivitätszonen für Kameras und Türklingeln in der Geräte-API.
- Einrichtung der Geräuscherkennung für Kameras und Türklingeln in der Geräte-API:
- Aufnahmemodus für Kameras und Türklingeln (CVR/EVR/Kein Verlauf) in der Geräte-API:
Behobene bekannte Probleme
- Die Temperatureinheiten (C/F) des Google Nest Learning Thermostat (4. Generation) können nicht geändert werden.
- In der mobilen Version der Google Home-Webversion werden das obere Symbol und der Button „Zurück“ durch eine Kopfzeile verdeckt. Nutzer können möglicherweise nicht zurückgehen oder wichtige Elemente der Benutzeroberfläche sehen.
- Ein Android TV-Hub meldet Matter-Geräte möglicherweise fälschlicherweise als „Offline“.
Bekannte Probleme
- Die Inbetriebnahme eines Matter-Geräts kann fehlschlagen.
2026-03-13
Öffentliche Betaversion 1.7.1 der Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Android-SDK für Home APIs.
Mindestversionen
- Google Play-Dienste:
- Google Hub-Firmware, Cast, Nest Wifi Pro: 3.78.518349
- Google Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.78.516526
- Google Hub-Firmware, Fuchsia: 29.20251023.103.2201
- Google Hub-Firmware, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_7_1
- Google Home App: 1.7.1
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
- Matter-Version: experimentelle Unterstützung für 1.5.0
Neue Funktionen
- Aktivierung von Kamera- und Türklingelanalysen in der Geräte-API
- Zeitpunkt der letzten Verbindung von Kameras und Türklingeln in der Geräte-API:
- Verbindungsstatus von Kameras und Türklingeln in der Geräte-API:
- Atomare Thermostatanfragen in der Geräte-API:
Weitere wichtige Änderungen
- Der Hubless-Modus wurde entfernt.
Beispiel-App
Behobene bekannte Probleme
- Bei der Nest Cam Indoor/Outdoor (mit Akku oder mit Kabel) und der Nest Doorbell (mit Akku, 2. Generation) ist die Option „Verbleibende Akkulaufzeit“ in den Akkueinstellungen nicht verfügbar.
- Die Einstellung für die Dauer des Glockentons wird ignoriert.
- Eine Philips BLE-Lampe wird fälschlicherweise als „Online“ angezeigt, obwohl das Gerät tatsächlich offline ist.
Bekannte Probleme
- Die Temperatureinheiten (C/F) des Google Nest Learning Thermostat (4. Generation) können nicht geändert werden.
- Es kann zu Verzögerungen bei der Netzwerkstabilität und der Reaktionsfähigkeit des Geräts kommen.
- In der mobilen Version von Google Home-Webversion werden das obere Symbol und der Button „Zurück“ durch einen Header verdeckt. Nutzer können möglicherweise nicht zurückgehen oder wichtige Elemente der Benutzeroberfläche sehen.
- Der Hub bleibt nach der Einrichtung im föderierten Modus möglicherweise im Status „Wird verbunden…“ hängen.
- Die Inbetriebnahme eines Matter-Geräts kann fehlschlagen.
- Ein Android TV-Hub meldet Matter-Geräte möglicherweise fälschlicherweise als offline.
- Möglicherweise wird nicht die richtige Softwareversion für „Aktuelle Softwareversion der Kamera“ angezeigt.
- Auf dem Schieberegler der Thermostat-Benutzeroberfläche werden Temperaturen angezeigt, die außerhalb des zulässigen Bereichs liegen.
- Wenn die Glocken-Dauer festgelegt ist, klingelt das Gerät nicht für die angegebene Dauer.
2026-02-13
Die Android-Beispiel-App für die Home-APIs wurde für die Home-APIs 1.7 aktualisiert.
Beispiel-App
2026-02-09
Public Beta-Release 1.7 der Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Android-SDK für Home APIs.
Mindestversionen
- Google Play-Dienste: 26.02.34
- Google Hub-Firmware, Cast, Nest Wifi Pro: 3.76.508025
- Google Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.77.510748
- Google Hub-Firmware, Fuchsia: 29.20251023.103.2100
- Google Hub-Firmware, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_7
- Google Home App: 1.7
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
- Matter-Version: experimentelle Unterstützung für 1.5.0
Neue Funktionen
- Lokale automatisierte Abläufe: Basierend auf Bedingungen wie Konnektivität, Gerätetypen und Attributen werden einige automatisierte Abläufe jetzt lokal in der Automations API ausgeführt.
- Aktivierung der Kamera bei der Out-of-Box-Experience (OOBE) in Apps in der Geräte-API
- Kamera- und Türklingel-Melodien in der Geräte-API
- Automatischer Energiesparmodus für Kameras und Türklingeln in der Geräte-API:
- Einstellungen für die Akkunutzung von Kameras und Türklingeln in der Geräte-API
- Akkuladestand von Kameras und Türklingeln in der Geräte-API.
- Akkustand von Kameras und Türklingeln in der Geräte-API.
- Seriennummer der Kamera und Türklingel in der Geräte-API.
- Kamera- und Türklingelmodell in der Geräte-API
- Softwareversion der Kamera und Türklingel in der Geräte-API:
- Benutzerdefinierte Schlüssel/Wert-API in der Device API:
- Mit der Berechtigungsabfrage kann eine App ermitteln, auf welche Gerätetypen der Nutzer in der Permissions API Zugriff gewährt hat.
Weitere wichtige Änderungen
-
HomeException.unsupportedwurde durchHomeException.unimplementedersetzt, um den Standardfehlercodes zu entsprechen. - Der verpackte Codegenerator für benutzerdefinierte Eigenschaften hat sich für Version 1.7 geändert. Entwickler mit benutzerdefinierten Attributen müssen ihre Attribute neu kompilieren, nachdem sie das SDK 1.7 eingebunden haben.
Behobene bekannte Probleme
-
Die History API gibt immer
nextPageTokenzurück, was zu einer Endlosschleife führt. - Der Fehler „User cancelled Permission flow“ (Nutzer hat Berechtigungsablauf abgebrochen) tritt auf, wenn Sie versuchen, sich in einem neuen Konto anzumelden.
Bekannte Probleme
- Bei der Nest Cam Indoor/Outdoor (mit Akku oder mit Kabel) und der Nest Doorbell (mit Akku, 2. Generation) ist die Option „Verbleibende Akkulaufzeit“ in den Akkueinstellungen nicht verfügbar.
- Die Einstellung für die Dauer des Glockentons wird ignoriert.
-
Eine Philips BLE-Lampe wird fälschlicherweise als „Online“ angezeigt, obwohl das Gerät tatsächlich offline ist. Workaround: Verlassen Sie sich nicht ausschließlich auf den Onlinestatus des Smart-Home-Geräts (SHDT). Verwenden Sie stattdessen die TDSS-Karte (Target Device State Service) für Geräte mit der Quelle
LOCAL_SYNC.
2025-12-22
Öffentliche Betaversion 1.6 der Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.
Mindestversionen
- Google Play-Dienste: 25.47.30
- Google-Hub-Firmware, Cast, Nest Wifi Pro: 3.75.479819
- Google-Hub-Firmware, Cast, alle anderen Cast-basierten Hubs: 3.77.505721
- Google Hub-Firmware, Fuchsia: 28.20250723.103.2100300
- Google Hub-Firmware, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_6
- Google Home App: 1.6
-
androidx.core-Bibliothek: Funktioniert mit jeder Version - Matter-Version: 1.4.1.0
Neue Funktionen
- Unterstützung von Wetter-Traits in der Automation API. Unterstützung für das Merkmal „Wetter“ in Auslösern und Bedingungen für automatisierte Abläufe hinzugefügt.
- Unterstützung für weitere Funktionen von Kameras und Türklingeln: Neue Einstellungen (Nachtsichtmodus, Status-LED, Viewport, Ausrichtung, Empfindlichkeit, Ereignislänge, Glocke).
- Von der App initiierte Google-Anmeldung zur Optimierung des UX-Ablaufs und zum Eliminieren von Prüfungen aktiver Nutzer:
- Im hublosen Modus können Nutzer bestimmte Matter-Geräte ohne separaten Hub einrichten und steuern.
- Hub Activation API zum Erkennen und Aktivieren von Hubs
Weitere wichtige Änderungen
- In der Android-Beispiel-App wurden Kameraeinstellungen, vordefinierte automatisierte Abläufe, Unterstützung für Ventilatoren und Lautsprecher hinzugefügt.
Bekannte Probleme
- Die Gerätesteuerung funktioniert nach längerer Nutzung nicht mehr. Problemumgehung: Starte den Hub neu.
- Die Inbetriebnahme von Matter-Geräten kann fehlschlagen.
- Beim Versuch, ein neues Konto in der Beispiel-App für Android hinzuzufügen, wird der Fehler „User cancelled Permission flow“ (Nutzer hat Berechtigungsablauf abgebrochen) angezeigt. Problemumgehung: Fügen Sie Google-Konten über die Geräteeinstellungen des Android-Geräts hinzu.
- Eine kabelgebundene Walmart onn.-Sicherheitskamera, die mit dem Android Home APIs SDK in Betrieb genommen wurde, kann nicht über die Google Home App gestreamt werden.
- Bei Kameras, die in Apps mit Home-APIs in Betrieb genommen wurden, können keine Livestream-Sitzungen über die Google Home App gestartet werden.
2025-10-23
Home APIs – öffentliche Betaversion 1.5.1Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Android-SDK für Home APIs.
Mindestversionen
- Google Play-Dienste: 25.41.30
- Google-Hub-Firmware, Cast: 3.76.495998
- Google Hub-Firmware, 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
Weitere wichtige Änderungen
- In der Android-Beispiel-App wurde Unterstützung für den Gerätetyp „Türklingel“ (OnOff, Livestream, Zweiwege-Audiofunktion) und die Implementierung der Hub Activation API hinzugefügt.
Behobene bekannte Probleme
- In der Beispiel-App wird der Gerätestatus in der Geräteansicht nicht richtig angezeigt.
2025-09-26
Home APIs Public Beta-Version 1.5.0Diese Version 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
- Google Hub-Firmware, Cast: 3.76.492738
- Google Hub-Firmware, 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
- Auslöser, Bedingungen und Aktionen akzeptieren jetzt Matter-Strukturen als Parameter in der Automation API.
- Der Geräte-API wurde der Kameragerätetyp hinzugefügt (Livestream, Zweiwege-Audiofunktion, Aufnahme starten/beenden).
Weitere wichtige Änderungen
-
Die Android-Beispiel-App unterstützt jetzt die Kamera, die Inbetriebnahme durch mehrere Administratoren und vordefinierte
OnOff-Automatisierungen.
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.
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 auf Cloud-to-Cloud basieren, funktioniert in der Beispiel-App möglicherweise nicht.
2025-08-29
Home APIs – öffentliche Betaversion 1.4.1Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.
Mindestversionen
- Google Play-Dienste: 25.33.32
- Google-Hub-Firmware, Cast: 3.76.495998
- Google Hub-Firmware, 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
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.
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.
31.07.2025
Öffentliche Betaversion 1.4.0 der Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.
Mindestversionen
- Google Play-Dienste: 25.28.34
- Google Hub-Firmware, Cast: 3.76.486931
- Google Hub-Firmware, 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
- Automatisierungen können in der Automation API so eingeschränkt werden, dass sie nur eine begrenzte Anzahl von Malen ausgeführt werden.
- Matter-Geräte können programmatisch über die Device API entfernt werden.
-
Die eingestellten
HomeDevice-Mitglieder (trait(),isInRoom,isInStructure) wurden entfernt. -
Home.hasPermissions()umfasst jetzt sowohl den OAuth-Strukturzugriff als auch die Erteilung von App-Berechtigungen.
Weitere wichtige Änderungen
- In der Android-Beispiel-App werden reine Matter-Geräte gelöscht, Geräte umbenannt und verworfene API-Aufrufe ersetzt.
Behobene bekannte Probleme
- Bei angedockten Staubsaugerrobotern wird der Status „Gedockt“ nicht registriert.
Bekannte Probleme
- Nachdem Sie sich von einem Smartphone abgemeldet und wieder angemeldet haben, kann eine Home APIs-App Geräte nicht mehr steuern. Problemumgehung: Schließe die App und warte mindestens 10 Sekunden.
26.06.2025
Öffentliche Betaversion 1.3.2 der Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.
Mindestversionen
- Google Play-Dienste: 25.23.31
- Google Hub-Firmware, Cast, Google Home, Google Home Mini und Google Nest Mini: 3.75.468362
- Google Hub-Firmware, Cast, Google Nest Audio: 3.75.476451
- Google Hub-Firmware, 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) und SDK-Traits und Gerätetypen (play-services-home-types-17.0.0.aar). Ab diesem Release müssen Entwickler beide Artefakte in die Bibliotheks-Pfade für die Kompilierzeit und die Laufzeit ihres Projekts einfügen.
Weitere wichtige Änderungen
- Android-Beispiel-App: Nutzer können die Verbindung zur App trennen und Berechtigungen widerrufen.
-
In der Android-Beispiel-App wurden aktualisierte SDK-Artefakte mit
play-services-home-17.0.0undplay-services-home-types-17.0.0hinzugefügt.
Bekannte Probleme
- Bei angedockten Staubsaugerrobotern wird der Status „Gedockt“ nicht registriert.
2025-06-05
Public Beta-Release 1.3.1 für Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.
Mindestversionen
- Google Play-Dienste: 25.19.32
- Google Hub-Firmware, Cast: 3.75.468222
- Google Hub-Firmware, 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
-
Einführung des
SyntheticSwitch-Traits, der die Verarbeitung von Ereignissen vereinfacht, die von Matter-Schaltern generiert werden, und es ermöglicht, dass Schalter Automatisierungs-Auslöser auslösen. -
Die Eigenschaft
ExtendedDoorLockhat eine funktionsgefährdende Änderung: Der Datentyp des Feldsuser_idwurde vonStringinLonggeändert. Apps, die dieses Merkmal verwenden, müssen neu kompiliert werden.
Weitere wichtige Änderungen
- Die Android-Beispiel-App bietet Funktionen zum Protokollieren des Status von Strukturen, Geräten, Typen, Eigenschaften und Automatisierungen, um das Debugging zu erleichtern.
Behobene bekannte Probleme
-
Die Google Home App stürzt beim Erstellen von automatisierten Abläufen mit einem
FailedPreconditionExceptionab, wenn der Standort des Zuhauses nicht in der Google Home App festgelegt ist. -
In der Android-Beispiel-App wurde ein Gerät mit
connectivityStatePARTIALLY_ONLINEzuvor als offline angezeigt. Dieser Status wird jetzt als „Online“ dargestellt.
Bekannte Probleme
- In der Android-Beispiel-App muss der Button „Automatisierung erstellen“ manchmal mehrmals angetippt werden, um ausgelöst zu werden.
2025-05-12
Öffentliche Betaversion 1.3 der Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Home APIs Android SDK.
Mindestversionen
- Google Play-Dienste: 25.16.33
- Google Hub-Firmware, Cast: 3.75.468222
- Google Hub-Firmware, 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
-
Unterstützung für wiederkehrende Auslöser für geplante Ereignisse in der Automation API 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 können jetzt in der Device API umbenannt werden.
- Möglichkeit zum Umbenennen von Räumen in der Structure API hinzugefügt
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.
Bekannte Probleme
2025-04-09
Home APIs – öffentliche Betaversion 1.2.1Diese 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
Neue Funktionen
- Die Leistung beim Laden von Objekten aus dem Home Graph wurde verbessert.
- Automation 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.
- Device API
- Informationen zu Cloud-to-Cloud-Geräten sind jetzt in der
BasicInformationTraitverfügbar.
- Informationen zu Cloud-to-Cloud-Geräten sind jetzt in der
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 eine
HomeExceptionmitcode 14: UNKNOWNund der Meldung „No route found.“ (Keine Route gefunden) ausgegeben. - In einer Umgebung mit mehreren Strukturen und mehreren Nutzern kann es beim Wechseln zwischen Strukturen und Nutzern vorkommen, dass keine Geräte zurückgegeben werden.
2025-03-14
Öffentliche Betaversion 1.2.0 der Home-APIsDiese 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.coreBibliothek – 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 von Zeiträumen und Teildaten in Automatisierungsbedingungen. Weitere Informationen finden Sie unter Datumsangaben mit „zwischen“ verwenden.
- In früheren Releases wurde von der Discovery API für einige Bitmap-Felder ein
NumberSetConstraintzurückgegeben, obwohl einBitmapConstrainthätte zurückgegeben werden sollen. Diese Felder geben jetzt wie erwartet einBitmapConstraintzurück. Dies ist aufoptionsMask- undoptionsOverride-Bitmaps in den Befehlen des TraitsLevelControlbeschrä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 eine
HomeExceptionmitcode 14: UNKNOWNund der Meldung „No route found.“ (Keine Route gefunden) ausgegeben.- Problemumgehung: Rufen Sie die Discovery API nur auf, wenn Sie tatsächlich Automatisierungskandidaten benötigen. Kandidatenentitäten nicht vorab abrufen 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 beim Wechseln zwischen Strukturen und Nutzern vorkommen, dass keine Geräte zurückgegeben werden.
Behobene bekannte Probleme
- Wenn eine Home APIs-App nach dem Starten zum ersten Mal
HomeManager.structures()aufruft, werden keine Gebäude empfangen, auch wenn ein oder mehrere Gebäude vorhanden sind. Dadurch entsteht der falsche Eindruck, dass keine Strukturen mit dem Google-Konto verknüpft sind. - Beim Laden, Erstellen und Bearbeiten von automatisierten Abläufen kann es zu langen Wartezeiten kommen.
- Nutzer, die den Einrichtungsvorgang über die Kamera-App starten, müssen den QR-Code zweimal scannen, um die Matter-Inbetriebnahme abzuschließen.
- In einer Struktur, die mehr als 200 Geräte enthält, gibt die Discovery API möglicherweise einfach keine Kandidaten zurück.
2025-01-29
Öffentliche Betaversion 1.1.0 der Home-APIsDiese Version enthält Fehlerkorrekturen und verbessert die Betaqualitä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 – Mindestversion: 24.20241009.103.1900500
- Android SDK: home.android.sdk_202412_EAP_1_1_RC04
- Mindestversion der Google Home App: funktioniert mit jeder Version
androidx.coreBibliotheks-Mindestversion: 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:
- Bietet Ereignisstreams, die über hinzugefügte, geänderte und entfernte Strukturen, Räume und Geräte informieren.
- Weitere Informationen finden Sie unter Ereignisse für Entitätsbeziehungen abonnieren.
- Batching API (experimentell):
- Ermöglicht 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 automatisierten Abläufen kann es zu langen Wartezeiten kommen.
- Nutzer, die den Einrichtungsvorgang über die Kamera-App starten, müssen den QR-Code zweimal scannen, um die Matter-Inbetriebnahme abzuschließen.
- In einer Struktur, die mehr als 200 Geräte enthält, gibt die Discovery API möglicherweise einfach keine Kandidaten zurück.
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 für Automatisierungen, die das Attribut
MediaPlaybackverwenden. - In einem Zuhause, 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 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 Ihre App meldet möglicherweise einen Status, der sich von dem Status unterscheidet, der von einer Google-App wie der Google Home App gemeldet wird. 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 Abweichung behoben.
2025-01-14
Die Anleitung zur Initialisierung von Home-APIs wurde aktualisiert.
Wir haben deutlicher gemacht, dass eine Instanz eines Zuhauses als Kontext-Singleton initialisiert werden sollte. So wird die Nutzerfreundlichkeit Ihrer App verbessert und Fehler bei ungültigen Sitzungen werden vermieden.
2025-01-07
Öffentliche Betaphase der Home-APIsWährend der öffentlichen Entwickler-Beta können alle Entwickler mit der Entwicklung und dem Testen ihrer Apps beginnen.
Diese Version enthält Fehlerkorrekturen und verbessert die Betaqualität des Android SDK für Home APIs, einschließlich der 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.coreBibliotheks-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 Attribut
MediaPlaybackverwenden. - 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 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. Deine App meldet dann möglicherweise einen Status, der sich von dem Status unterscheidet, der von einer Google-App wie der Google Home App (GHA) gemeldet wird. 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.
Behobene bekannte Probleme
- Die Inbetriebnahme kann fehlschlagen, wenn die App während des Vorgangs minimiert wird.
- Problemumgehung: Verwenden Sie die
suppressHalfSheetNotification()API, um Benachrichtigungen für Halbsheets zu unterdrücken, wenn die Commissioning API in Ihrer App verwendet wird.
- Problemumgehung: Verwenden Sie die
- 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.
- Nach dem Zurücksetzen eines Hubs auf die Werkseinstellungen können Befehle an neu in Betrieb genommene Geräte fehlschlagen, obwohl das Gerät als online gemeldet wird.