Informacje o wersji interfejsu API Home SDK na Androida

2026-10-22

  Wersja 1.11.1 interfejsów API Google Home z ogólną dostępnością  

Ta wersja zawiera poprawki błędów i ulepszenia jakości GA w pakiecie Android SDK interfejsów Home API.

Wersje minimalne

• Usługi Google Play: 26.40.32
• Oprogramowanie układowe centrów Google, Cast, Nest WiFi Pro: 3.78.556638
• Oprogramowanie układowe centrów Google, Cast, wszystkie inne centra oparte na Cast: 3.79.558061
• Oprogramowanie układowe Google Hub, Fuchsia: 31.20260429.103.8713700
• Oprogramowanie układowe centrów Google, streamer Google TV (4K): UTTK.260317.003
• Android SDK: home.android.sdk_1_11_1.zip
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

• Obsługa tworzenia, aktualizowania i usuwania automatycznych krzywych oświetlenia, które dostosowują jasność i temperaturę kolorów w ciągu dnia w pomieszczeniach lub na określonych urządzeniach oświetleniowych.
• Dodaliśmy wskazówki dotyczące tego, jak platforma obsługuje automatyczne usuwanie danych użytkownika, gdy opuszcza on dom lub usuwa swoje konto Google, oraz jak użytkownicy mogą eksportować swoje dane za pomocą Google Takeout.
• Obsługa konfigurowania i pobierania języka aplikacji za pomocą setLocale() i getLocale() w przypadku procesów interfejsu hostowanych przez pakiet SDK, a także zlokalizowanych pól tekstowych (localizedTexts i localizedBodies) w napisach AI i podsumowaniach wygenerowanych przez AI zdarzeń w chmurze.
• Obsługa sterowania urządzeniem DeviceGroup jako pojedynczą encją za pomocą części typu urządzenia, a także sprawdzania członkostwa w grupach na poszczególnych urządzeniach i grupowania poleceń dla członków grupy.

Inne istotne zmiany

• Zaktualizowaliśmy dokumentację interfejsu API w języku Kotlin.

Znane problemy

• Po ponownym uruchomieniu kamery jej stan połączenia może być wyświetlany jako PARTIAL_ONLINE zamiast ONLINE. Wszystkie funkcje kamery w chmurze będą działać normalnie, z wyjątkiem wycofania Matter.

2026-09-23

  Interfejsy API Google Home w wersji GA 1.11  

Ta wersja zawiera poprawki błędów i ulepszenia jakości GA w pakiecie Android SDK interfejsów Home API.

Wersje minimalne

• Usługi Google Play: 26.36.25
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.78.548779
• Oprogramowanie układowe koncentratora Google, Cast, wszystkie inne koncentratory oparte na Cast: 3.79.550760
• Oprogramowanie układowe Google Hub, Fuchsia: 31.20260429.103.8712702
• Oprogramowanie układowe centrów Google, streamer Google TV (4K): UTTK.260317.003
• Android SDK: home.android.sdk_GHP_1_11
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

warning Ważne aktualizacje warning

• Od wersji 1.11 interfejsy Home API wymagają Kotlina w wersji 2.4.0. Jeśli kompilujesz aplikację Home APIs za pomocą starszej wersji Kotlina, musisz użyć opcji kompilatora -Xskip-metadata-version-check, aby ukryć błędy związane z metadanymi.
• Od wersji 1.11 deweloperzy muszą zaktualizować plik gradle, aby zaimportować biblioteki kotlinx.coroutines i zachować obsługę najnowszych współprogramów Kotlin. Jeśli nie wprowadzisz tej zmiany, we wszystkich aplikacjach Kotlin korzystających z interfejsów Home API wystąpi błąd środowiska wykonawczego.

Nowe funkcje

• Grupy urządzeń można tworzyć w jednej strukturze. Grupa urządzeń to zdefiniowany przez użytkownika zbiór urządzeń.

Inne istotne zmiany

• Zaktualizowaliśmy dokumentację interfejsu API w języku Kotlin.

2026-09-16

Uruchomiliśmy 2 nowe serwery MCP. Home MCP umożliwia osobistym agentom bezpieczną interakcję z inteligentnym domem, a Home Developer MCP udostępnia dokumentację z Home Developer Center i inne zasoby dotyczące inteligentnego domu, aby ulubieni agenci mogli je wyszukiwać i odpytywać.

Nowe funkcje

• Przewodnik użytkownika dotyczący MCP w domu
• Przewodnik użytkownika dotyczący konsoli Home Developer Console

2026-09-16

Przykładowa aplikacja na Androida korzystająca z interfejsów API Google Home została zaktualizowana do wersji 1.10.1.

Przykładowa aplikacja

• Pełne informacje o wersji znajdziesz w informacjach o wersji 1.10.1 na GitHubie.

2026-08-28

  Wersja 1.10.1 interfejsów Home API dostępna dla wszystkich użytkowników  

Ta wersja zawiera poprawki błędów i ulepszenia jakości GA w pakiecie Android SDK interfejsów Home API.

Wersje minimalne

• Usługi Google Play: 26.34.30
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.78.548779
• Oprogramowanie układowe koncentratora Google, Cast, wszystkie inne koncentratory oparte na Cast: 3.79.547681
• Oprogramowanie układowe Google Hub, Fuchsia: 31.20260429.103.8712702
• Oprogramowanie układowe centrów Google, streamer Google TV (4K): UTTK.260317.003
• Android SDK: home.android.sdk_GHP_1_10_1
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

warning Ważne aktualizacje warning

• Od wersji 1.11 deweloperzy muszą zaktualizować plik gradle, aby zaimportować biblioteki kotlinx.coroutines i zachować obsługę najnowszych współprogramów Kotlin. Jeśli nie wprowadzisz tej zmiany, we wszystkich aplikacjach Kotlin korzystających z interfejsów Home API wystąpi błąd środowiska wykonawczego.

Nowe funkcje

• Interfejs Automation API obsługuje teraz dynamiczne parametry poleceń.
• Interfejs Automation API obsługuje teraz logikę if/else.

Inne istotne zmiany

• Zaktualizowaliśmy dokumentację interfejsu API w języku Kotlin.

2026-08-07

Przykładowa aplikacja interfejsów API Google Home na Androida została zaktualizowana do wersji 1.10.

Przykładowa aplikacja

• Pełne informacje o wersji znajdziesz w informacjach o wersji 1.10 na GitHubie.

2026-08-03

  Interfejsy API Google Home – wersja GA 1.10  

Ta wersja zawiera poprawki błędów i podnosi jakość pakietu Android SDK interfejsów Home API do poziomu GA.

Wersje minimalne

• Usługi Google Play: 26.28.31
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.78.518349
• Oprogramowanie układowe Google Hub, Cast, wszystkie inne centra oparte na Cast: 3.78.540761
• Oprogramowanie układowe Google Hub, Fuchsia: 30.20260121.103.1602904
• Oprogramowanie układowe centrów Google, streamer Google TV (4K): UTTK.260317.003
• Android SDK: home.android.sdk_GHP_1_10
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

2026-07-09

Flaga forceLaunch została wycofana. Aplikacje powinny przejść na typ wyliczeniowy ForcePermissionFlow, aby określać zachowanie interfejsu użytkownika dotyczącego zgody.

Nadchodzące zmiany

• Wycofany interfejs API: metoda requestPermissions(forceLaunch: Boolean, ...) została wycofana w pakiecie SDK Google Home na Androida.
• Krok migracji: zastąp flagi logiczne wartością ForcePermissionFlow.FORCE_LAUNCH (w przypadku true) lub ForcePermissionFlow.DO_NOT_FORCE_LAUNCH (w przypadku false).

2026-07-08

Przewodnik po urządzeniach z routerem granicznym na Androida jest już dostępny.

Nowe treści

• Przewodnik po urządzeniach z routerem granicznym na Androida jest już dostępny.

2026-07-07

Przykładowa aplikacja Home APIs na Androida została zaktualizowana do wersji Home APIs 1.9.1.

Przykładowa aplikacja

• Pełne informacje o wersji znajdziesz w informacjach o wersji 1.9.1 na GitHubie.

2026-06-26

  Interfejsy API Google Home w publicznej wersji beta 1.9.1  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play: 26.24.22
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.78.518349
• Oprogramowanie układowe Google Hub, Cast, wszystkie inne centra oparte na Cast: 3.78.538123
• Oprogramowanie układowe Google Hub, Fuchsia: 30.20260121.103.1602904
• Oprogramowanie układowe centrów Google, streamer Google TV (4K): UTTK.250729.004 (14748786)
• Android SDK: home.android.sdk_1_9_1.zip
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

• Kamera i dzwonek: stan wymiany baterii
• Obsługa zdjęć z kamery i dzwonka do drzwi jako podglądu podczas konfigurowania strefy aktywności i widoku na żywo.

Rozwiązane znane problemy

• Uruchamianie Szybkiego parowania nie jest obsługiwane w przypadku modeli Google Nest Cam Outdoor (zasilana z sieci, 2 generacji), Google Nest Cam Indoor (zasilana z sieci, 3 generacji) i Doorbell (zasilany z sieci, 3 generacji).

2026-06-09

Przykładowa aplikacja na Androida korzystająca z interfejsów Home API została zaktualizowana do wersji 1.9.0.

Przykładowa aplikacja

• Pełne informacje o wersji znajdziesz w informacjach o wersji 1.9.0 na GitHubie

2026-05-29

  Interfejsy API Google Home – publiczna wersja beta 1.9  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play: 26.20.31
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.78.518349
• Oprogramowanie układowe Google Hub, Cast, wszystkie inne urządzenia hub oparte na Cast: 3.78.526062
• Oprogramowanie układowe Google Hub, Fuchsia: 30.20260121.103.1602904
• Oprogramowanie układowe centrów Google, streamer Google TV (4K): UTTK.250729.004 (14748786)
• Android SDK: home.android.sdk_GHP_1_9
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

• Ustawienia kamery i dzwonka: typ uchwytu kamery
• Ustawienia kamery i dzwonka: powiadomienia o gościach
• Ustawienia kamery i dzwonka: preferencje dotyczące jakości transmisji na żywo
• Szybkie odpowiedzi dzwonka
• Sugerowanie obiektu, aby umożliwić partnerom wstępne wybieranie obiektów w procesie przyznawania uprawnień
• Obsługa urządzeń wieloczęściowych w automatyzacjach
• Aktualizacje tych niestandardowych cech Google: ExtendedFanControl, ExtendedThermostat
• Aktualizacje tych cech Matter: ArmDisarm, FanControl, Thermostat, ThermostatFanControl, ThermostatUserInterfaceConfiguration

Znane problemy

• Uruchamianie Szybkiego parowania nie jest obsługiwane w przypadku modeli Google Nest Cam Outdoor (zasilana z sieci, 2 generacji), Google Nest Cam Indoor (zasilana z sieci, 3 generacji) i Doorbell (zasilany z sieci, 3 generacji).

2026-05-26

Przykładowa aplikacja Home APIs na Androida została zaktualizowana do wersji 1.8.1 interfejsów Home API.

Przykładowa aplikacja

• Pełne informacje o wersji znajdziesz w informacjach o wersji 1.8.1 na GitHubie.

2026-05-01

  Interfejsy API Google Home w publicznej wersji beta 1.8.1  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play: 26.16.31
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.78.518349
• Oprogramowanie układowe Google Hub, Cast, wszystkie inne urządzenia hub oparte na Cast: 3.78.526062
• Oprogramowanie układowe Google Hub, Fuchsia: 30.20260121.103.1602802
• Oprogramowanie układowe Google Hub, streamer Google TV, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_8_1
• Aplikacja Google Home: 4.8 lub nowsza
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

• Atrybut termostatu obsługuje teraz funkcje odczytu/aktualizacji, włączania/wyłączania i minutnika

Rozwiązane znane problemy

• Uruchomienie urządzenia Matter może się nie udać.
• Światło Philips BLE nie pokazuje prawidłowego stanu.
• Opóźnienie powodujące niestabilność sieci i wolne czasy odpowiedzi.

Znane problemy

• Nie można uruchomić niektórych urządzeń za pomocą streamera Google TV (4K).
• Jeśli koncentratorem jest Nest Wifi Pro, Google Nest Hub lub Google Nest Hub Max, aplikacja Google Home wyświetla urządzenia wieloczęściowe jako kilka kafelków.

2026-04-10

Przykładowa aplikacja na Androida korzystająca z Home APIs została zaktualizowana do wersji 1.8.

Przykładowa aplikacja

• Pełne informacje o wersji znajdziesz w informacjach o wersji 1.8.0 na GitHubie.

2026-04-09

  Interfejsy API Google Home w publicznej wersji beta 1.8  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play: 26.12.32
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.78.518349
• Oprogramowanie układowe Google Hub, Cast, wszystkie inne urządzenia hub oparte na Cast: 3.78.526062
• Oprogramowanie układowe Google Hub, Fuchsia: 29.20251023.103.2101601
• Oprogramowanie układowe Google Hub, streamer Google TV, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_8_0
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

• Sugerowane automatyzacje w interfejsie Automations API.
• Obsługa urządzeń wieloczęściowych w interfejsie Device API.
• Konfigurowanie stref aktywności kamery i dzwonka w interfejsie Device API.
• Konfiguracja wykrywania dźwięku przez kamerę i dzwonek w interfejsie Device API.
• Tryb nagrywania kamery i dzwonka (CVR/EVR/brak historii) w interfejsie Device API.

Rozwiązane znane problemy

• Nie można zmienić jednostek temperatury (C/F) na termostacie Google Nest Learning Thermostat (4 generacji).
• W mobilnej wersji przeglądarkowej wersji Google Home górna ikona i przycisk Wstecz są zasłonięte przez nagłówek. Użytkownicy mogą nie mieć możliwości powrotu lub wyświetlenia kluczowych elementów interfejsu.
• Centrum Android TV może nieprawidłowo zgłaszać urządzenia Matter jako „Offline”.

Znane problemy

• Uruchomienie urządzenia Matter może się nie udać.

2026-03-13

  Publiczna wersja beta interfejsów Home API 1.7.1  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play:
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.78.518349
• Oprogramowanie układowe Google Hub, Cast, wszystkie inne centra oparte na Cast: 3.78.516526
• Oprogramowanie układowe huba Google, Fuchsia: 29.20251023.103.2201
• Oprogramowanie układowe Google Hub, streamer Google TV, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_7_1
• Aplikacja Google Home: 1.7.1
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

• Akceptacja analityki kamery i dzwonka w interfejsie Device API.
• Ostatni czas połączenia kamery i dzwonka w interfejsie Device API.
• Stan połączenia kamery i dzwonka w interfejsie Device API.
• Żądania niepodzielne dotyczące termostatu w interfejsie Device API.

Inne istotne zmiany

• Tryb bez centrum został usunięty.

Przykładowa aplikacja

• Przykładowa aplikacja na Androida korzystająca z interfejsów API Google Home w wersji 1.7.1. Szczegółowe informacje znajdziesz w wersji na GitHubie.

Rozwiązane znane problemy

• W przypadku kamer Nest Cam Indoor/Outdoor (zasilanych bateryjnie lub z sieci) i urządzeń Nest Doorbell (zasilanych bateryjnie, 2 generacji) opcja „Pozostały czas pracy na baterii” nie jest dostępna w ustawieniach baterii.
• Ustawienie czasu trwania dzwonka jest ignorowane.
• Lampa Philips BLE jest nieprawidłowo wyświetlana jako „Online”, nawet gdy urządzenie jest offline.

Znane problemy

• Nie można zmienić jednostek temperatury (C/F) na termostacie Google Nest Learning Thermostat (4 generacji).
• Możliwe opóźnienia w stabilności sieci i reagowaniu urządzenia.
• W wersji mobilnej przeglądarkowej wersji Google Home górna ikona i przycisk Wstecz są zasłonięte przez nagłówek. Użytkownicy mogą nie mieć możliwości powrotu lub wyświetlenia kluczowych elementów interfejsu.
• Po zakończeniu początkowej konfiguracji w trybie federacyjnym centrum może utknąć w stanie „Łączę…”.
• Uruchomienie urządzenia Matter może się nie udać.
• Centrum Android TV może nieprawidłowo zgłaszać urządzenia Matter jako offline.
• W sekcji Bieżąca wersja oprogramowania kamery może nie być widoczna prawidłowa wersja oprogramowania.
• Suwak interfejsu termostatu pokazuje temperatury spoza zakresu.
• Gdy ustawisz czas trwania dzwonka, urządzenie nie będzie dzwonić przez określony czas.

2026-02-13

Przykładowa aplikacja Home APIs na Androida została zaktualizowana do wersji 1.7 interfejsów Home API.

Przykładowa aplikacja

• Pełne informacje o wersji znajdziesz w informacjach o wersji 1.7.0 na GitHubie

2026-02-09

  Interfejsy Home API w publicznej wersji beta 1.7  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play: 26.02.34
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.76.508025
• Oprogramowanie układowe Google Hub, Cast, wszystkie inne centra oparte na Cast: 3.77.510748
• Oprogramowanie układowe huba Google, Fuchsia: 29.20251023.103.2100
• Oprogramowanie układowe Google Hub, streamer Google TV, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_7
• Aplikacja Google Home: 1.7
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0
• Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

• Automatyzacje lokalne: w zależności od warunków, takich jak połączenie, typy urządzeń i cechy, niektóre automatyzacje mogą być teraz wykonywane lokalnie w interfejsie Automations API.
• Włączanie początkowej konfiguracji aparatu w aplikacjach w interfejsie Device API.
• Motywy dzwonka kamery i dzwonka do drzwi w interfejsie Device API.
• Automatyczne oszczędzanie baterii w kamerze i dzwonku w interfejsie Device API.
• Ustawienia wykorzystania baterii przez kamerę i dzwonek w interfejsie Device API.
• Stan ładowania baterii kamery i dzwonka w interfejsie Device API.
• Poziomy baterii kamery i dzwonka w interfejsie Device API.
• Numer seryjny kamery i dzwonka w interfejsie Device API.
• Model kamery i dzwonka w interfejsie Device API.
• Wersja oprogramowania kamery i dzwonka w interfejsie Device API.
• Niestandardowy interfejs API klucz-wartość w Device API.
• Zapytanie o uprawnienia pozwala aplikacji określić, którym typom urządzeń użytkownik przyznał dostęp w interfejsie Permissions API.

Inne istotne zmiany

• HomeException.unsupported został zastąpiony przez HomeException.unimplemented, aby zachować zgodność ze standardowymi kodami błędów.
• W wersji 1.7 zmienił się generator kodu pakietu dla cech niestandardowych. Deweloperzy, którzy mają cechy niestandardowe, muszą je ponownie skompilować po zintegrowaniu pakietu SDK w wersji 1.7.

Rozwiązane znane problemy

• Interfejs History API zawsze zwraca nextPageToken, co powoduje nieskończoną pętlę.
• Podczas próby zalogowania się na nowe konto pojawia się błąd „Użytkownik anulował proces przyznawania uprawnień”.

Znane problemy

• W przypadku kamer Nest Cam Indoor/Outdoor (zasilanych bateryjnie lub z sieci) i urządzeń Nest Doorbell (zasilanych bateryjnie, 2 generacji) opcja „Pozostały czas pracy na baterii” nie jest dostępna w ustawieniach baterii.
• Ustawienie czasu trwania dzwonka jest ignorowane.
• Lampa Philips BLE jest nieprawidłowo wyświetlana jako „Online”, nawet gdy urządzenie jest offline. Obejście problemu: nie polegaj wyłącznie na stanie online typu inteligentnego urządzenia domowego (SHDT). Zamiast tego użyj mapy Target Device State Service (TDSS) dla urządzeń ze źródłem LOCAL_SYNC.

2025-12-22

  Interfejsy API Google Home w publicznej wersji beta 1.6  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play: 25.47.30
• Oprogramowanie układowe Google Hub, Cast, Nest WiFi Pro: 3.75.479819
• Oprogramowanie układowe centrów Google, Cast, wszystkie inne centra oparte na Cast: 3.77.505721
• Oprogramowanie układowe Google Hub, Fuchsia: 28.20250723.103.2100300
• Oprogramowanie układowe Google Hub, streamer Google TV, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_6
• Aplikacja Google Home: 1.6
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0

Nowe funkcje

• Obsługa cechy Weather w interfejsie Automation API. Dodaliśmy obsługę cechy Pogoda w poleceniach inicjujących i warunkach automatyzacji.
• Obsługa większej liczby funkcji kamer i dzwonków: nowe ustawienia (noktowizja, dioda LED stanu, widoczny obszar, orientacja, czułość, długość zdarzenia, dzwonek).
• Logowanie się w Google inicjowane przez aplikację, aby usprawnić proces UX i wyeliminować sprawdzanie aktywnych użytkowników.
• Tryb bez huba umożliwia użytkownikom wprowadzanie i kontrolowanie niektórych urządzeń Matter bez samodzielnego huba.
• Hub Activation API do wykrywania i aktywowania centrów.

Inne istotne zmiany

• Przykładowa aplikacja na Androida dodaje ustawienia kamery, wstępnie zdefiniowane automatyzacje oraz obsługę wentylatora i głośnika.

Znane problemy

• Sterowanie urządzeniem przestaje działać po dłuższym okresie użytkowania. Obejście problemu: uruchom ponownie centrum.
• Uruchomienie urządzenia Matter może się nie powieść.
• Podczas próby dodania nowego konta w przykładowej aplikacji na Androida pojawia się błąd „Użytkownik anulował proces przyznawania uprawnień”. Obejście problemu: dodaj konta Google w ustawieniach urządzenia z Androidem.
• Przewodowa kamera monitoringu Walmart onn, która została uruchomiona za pomocą pakietu SDK interfejsów API Google Home na Androida, nie może transmitować na żywo w aplikacji Google Home.
• Kamery uruchomione w aplikacjach interfejsów API Home nie mogą rozpoczynać sesji transmisji na żywo z aplikacji Google Home.

2025-10-23

  Home APIs Public Beta release 1.5.1  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play: 25.41.30
• Oprogramowanie układowe Google Hub, Cast: 3.76.495998
• Oprogramowanie układowe Google Hub, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5_1
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0

Nowe funkcje

• Interfejs API aktywacji centrum umożliwia automatyczne wykrywanie i aktywowanie centrum Google Home w interfejsie Structure API.

Inne istotne zmiany

• Przykładowa aplikacja na Androida dodaje obsługę typu urządzenia dzwonek (włączanie/wyłączanie, transmisja na żywo, rozmowa dwukierunkowa) i implementację interfejsu API aktywacji centrum.

Rozwiązane znane problemy

• Przykładowa aplikacja nie wyświetla prawidłowo stanu urządzenia w widoku urządzenia.

26.09.2025 r.

  Interfejsy Home API w publicznej wersji beta 1.5.0  

Ta wersja wprowadza obsługę kamer, zawiera poprawki błędów i ulepsza jakość wersji beta pakietu Android SDK interfejsów Home API.

Wersje minimalne

• Usługi Google Play: 25.37.31
• Oprogramowanie układowe Google Hub, Cast: 3.76.492738
• Oprogramowanie układowe Google Hub, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.1.0

Nowe funkcje

• Polecenia inicjujące, warunki i działania akceptują teraz struktury Matter jako parametry w interfejsie Automation API.
• Do interfejsu Device API dodano typ urządzenia „kamera” (transmisja na żywo, rozmowa dwukierunkowa, rozpoczęcie/zatrzymanie nagrywania).

Inne istotne zmiany

• Przykładowa aplikacja na Androida obsługuje teraz kamerę, wieloadministracyjne uruchamianie i wstępnie zdefiniowaną automatyzację OnOff.

Rozwiązane znane problemy

• Gdy obecnie aktywne centrum zostanie usunięte wymuszenie, przez 5 minut nie będzie można sterować niektórymi urządzeniami. Po 5 minutach możliwość sterowania urządzeniami zostanie przywrócona.
• Gdy użytkownik wybierze kolor z ustawień wstępnych lub z selektora temperatury kolorów, rozszerzone oświetlenie kolorowe nie aktualizuje koloru.

Znane problemy

• Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić zwiększone opóźnienie sterowania urządzeniem.
• Sterowanie urządzeniami typu wentylator obsługiwanymi przez Cloud-to-cloud może nie działać w przykładowej aplikacji.

2025-08-29

  Publiczna wersja beta interfejsów Home API 1.4.1  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play: 25.33.32
• Oprogramowanie układowe Google Hub, Cast: 3.76.495998
• Oprogramowanie układowe Google Hub, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_1
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.0.0

Nowe funkcje

• Zdefiniowano nowy błąd DecommissionIneligibleReason, który pojawia się, gdy próba wycofania urządzenia z wieloma źródłami w interfejsie Device API się nie powiedzie.

Rozwiązane znane problemy

• Przykładowa aplikacja na Androida ulega awarii, gdy użytkownik próbuje ustawić termostat w trybie, którego on nie obsługuje.

Znane problemy

• Gdy obecnie aktywne centrum zostanie usunięte wymuszenie, przez 5 minut nie będzie można sterować niektórymi urządzeniami. Po 5 minutach możliwość sterowania urządzeniami zostanie przywrócona.

2025-07-31

  Home APIs publiczna wersja beta, wersja 1.4.0  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home.

Wersje minimalne

• Usługi Google Play: 25.28.34
• Oprogramowanie układowe Google Hub, Cast: 3.76.486931
• Oprogramowanie układowe Google Hub, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_0
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.0.0

Nowe funkcje

• W interfejsie Automation API można ograniczyć liczbę wykonań automatyzacji do określonej liczby.
• Możliwość automatycznego usuwania urządzenia Matter w interfejsie Device API.
• Usunięto wycofane elementy HomeDevice (trait(), isInRoom, isInStructure).
• Home.hasPermissions() obejmuje teraz zarówno dostęp do struktury OAuth, jak i przyznawanie uprawnień aplikacji.

Inne istotne zmiany

• Przykładowa aplikacja na Androida usuwa urządzenia obsługujące tylko Matter, zmienia nazwy urządzeń i zastępuje wycofane wywołania interfejsu API.

Rozwiązane znane problemy

• Odkurzacze, które zostały zadokowane, nie rejestrują stanu zadokowania.

Znane problemy

• Po wylogowaniu się z telefonu i ponownym zalogowaniu aplikacja Home APIs nie może sterować urządzeniami. Obejście problemu: zamknij aplikację i odczekaj co najmniej 10 sekund.

26.06.2025 r.

  Home APIs publiczna wersja beta, wersja 1.3.2  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów Home API.

Wersje minimalne

• Usługi Google Play: 25.23.31
• Oprogramowanie układowe Google Hub, Cast, Google Home, Google Home Mini i Google Nest Mini: 3.75.468362
• Oprogramowanie układowe Google Hub, Cast, Google Nest Audio: 3.75.476451
• Oprogramowanie układowe Google Hub, Fuchsia: 26.20250116.103.2900
• Android SDK: home.android.sdk_1_3_2
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.0.0

Nowe funkcje

• Komponent SDK został podzielony na 2 osobne komponenty: platformę SDK interfejsów Home API (play-services-home-17.0.0.aar) oraz cechy i typy urządzeń SDK (play-services-home-types-17.0.0.aar). Od tej wersji deweloperzy muszą uwzględniać oba komponenty w ścieżkach bibliotek czasu kompilacji i czasu działania projektu.

Inne istotne zmiany

• Przykładowa aplikacja na Androida: użytkownicy mogą odłączyć aplikację i cofnąć jej uprawnienia.
• Przykładowa aplikacja na Androida: zaktualizowano artefakty pakietu SDK, aby uwzględnić play-services-home-17.0.0 i play-services-home-types-17.0.0.

Znane problemy

• Odkurzacze, które zostały zadokowane, nie rejestrują stanu zadokowania.

5.06.2025 r.

  Interfejsy API Google Home w publicznej wersji beta 1.3.1  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów Home API.

Wersje minimalne

• Usługi Google Play: 25.19.32
• Oprogramowanie układowe Google Hub, Cast: 3.75.468222
• Oprogramowanie układowe Google Hub, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.0.0

Nowe funkcje

• Wprowadziliśmy cechę SyntheticSwitch, która upraszcza obsługę zdarzeń generowanych przez urządzenia Matter Switch i umożliwia przełącznikom aktywowanie modułów uruchamiających automatyzację.
• W cechach ExtendedDoorLock wprowadzono zmianę powodującą niezgodność: typ danych pola user_id został zmieniony z String na Long. Aplikacje, które używają tej cechy, muszą zostać ponownie skompilowane.

Inne istotne zmiany

• Przykładowa aplikacja na Androida dodaje funkcje rejestrowania stanu domów, urządzeń, typów, cech i automatyzacji, aby ułatwić debugowanie.

Rozwiązane znane problemy

• Aplikacja Google Home ulega awarii i wyświetla błąd FailedPreconditionException podczas tworzenia automatyzacji, jeśli lokalizacja domu nie jest ustawiona w aplikacji Google Home.
• W przykładowej aplikacji na Androida urządzenie z connectivityState PARTIALLY_ONLINE było wcześniej wyświetlane jako offline. Ten stan jest teraz reprezentowany jako online.

Znane problemy

• W przykładowej aplikacji na Androida przycisk Utwórz automatyzację czasami wymaga wielokrotnego kliknięcia, aby się uruchomić.

2025-05-12

  Interfejsy API Google Home – publiczna wersja beta 1.3  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów Home API.

Wersje minimalne

• Usługi Google Play: 25.16.33
• Oprogramowanie układowe Google Hub, Cast: 3.75.468222
• Oprogramowanie układowe Google Hub, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202504_EAP_1_3_RC00
• Aplikacja Google Home: działa z każdą wersją.
• Biblioteka androidx.core: działa z każdą wersją
• Wersja Matter: 1.4.0.0

Nowe funkcje

• Dodaliśmy obsługę elementów inicjujących cykliczne zaplanowane wydarzenia w interfejsie Automation API, co pozwala deweloperom tworzyć automatyzacje, które działają okresowo na podstawie czasu zegarowego, czasu słonecznego i warunków kalendarzowych, przy użyciu wyrażeń cron.
• Dodano możliwość zmieniania nazw urządzeń w interfejsie Device API.
• Dodano możliwość zmieniania nazw pomieszczeń w interfejsie Structure API.

Rozwiązane znane problemy

• Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić zwiększone opóźnienie sterowania urządzeniem.
• Po przywróceniu koncentratora do ustawień fabrycznych urządzenia mogą być widoczne jako offline.

Znane problemy

• Aplikacja Google Home ulega awarii z błędem FailedPreconditionException podczas tworzenia automatyzacji, jeśli lokalizacja domu nie jest ustawiona w aplikacji Google Home. Obejście problemu: przed próbą utworzenia automatyzacji sprawdź za pomocą interfejsu Discovery API, czy adres domowy jest podany.

2025-04-09

  Interfejsy API Google Home w publicznej wersji beta 1.2.1  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów Home API.

Wersje minimalne

• Usługi Google Play: 25.09.33
• Minimalne wersje oprogramowania koncentratora Google:
  • Cast: 3.75.468222
  • Fuchsia: 24.20241009.103.1900601¹
• Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
• Aplikacja Google Home: działa z każdą wersją
• Biblioteka androidx.core: 1.10.0
• Wersja Matter: 1.4.0.0

^{1. Ta kompilacja jest obecnie wdrażana w środowisku produkcyjnym i będzie dostępna na wszystkich urządzeniach do 22 kwietnia 2025 r.}

Nowe funkcje

• Zwiększyliśmy wydajność podczas wczytywania obiektów z Home Graph.
• Automation API
  • Dodaliśmy obsługę filtrów encji, które umożliwiają automatyzacjom dynamiczne wybieranie urządzeń na podstawie kryteriów określonych w automatyzacji.
• Device API
  • Informacje o urządzeniach połączonych z chmurą są teraz dostępne w  BasicInformationTrait.

Znane problemy

• Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić zwiększone opóźnienie sterowania urządzeniem.
• Po przywróceniu koncentratora do ustawień fabrycznych urządzenia mogą być widoczne jako offline.

Rozwiązane znane problemy

• Jeśli interfejs Discovery API zostanie wywołany przed inicjalizacją lub przed jej zakończeniem, zostanie wygenerowany błąd HomeException z  code 14: UNKNOWN i komunikatem „Nie znaleziono trasy”.
• W środowisku zawierającym wiele domów i wielu użytkowników przełączanie się między domami i użytkownikami może spowodować, że nie zostaną zwrócone żadne urządzenia.

2025-03-14

  Interfejsy API Google Home w publicznej wersji beta 1.2.0  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów Home API.

Wersje minimalne

• Minimalna wersja usług Google Play: 25.06.32
• Minimalne wersje oprogramowania układowego koncentratora Google:
  • Wersja Cast: 3.75.456944
  • Minimalna wersja Fuchsia: 24.20241009.103.1900601
• Android SDK: home.android.sdk_1_2_0_RC06
• Minimalna wersja aplikacji Google Home: działa z każdą wersją
• androidx.core – minimalna wersja biblioteki: 1.10.0
• Wersja Matter: 1.3.0.0
  • Uwaga: tymczasowe typy urządzeń i klastry Matter nie są obsługiwane.

Nowe funkcje

• Automation API:
  • Obsługa zakresów dat i częściowych dat w warunkach automatyzacji. Zobacz Używanie dat z operatorem between.
  • W poprzednich wersjach interfejs Discovery API zwracał NumberSetConstraint w przypadku niektórych pól bitmapy, gdy powinien zwracać BitmapConstraint. Te pola zwracają teraz wartość BitmapConstraint zgodnie z oczekiwaniami. Dotyczy to tylko bitmap optionsMask i optionsOverride w poleceniach cechy LevelControl.

Znane problemy

• Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić zwiększone opóźnienie sterowania urządzeniem.
• Po przywróceniu koncentratora do ustawień fabrycznych urządzenia mogą być widoczne jako offline.
• Jeśli interfejs Discovery API zostanie wywołany przed inicjalizacją lub przed jej zakończeniem, zostanie wygenerowany błąd HomeException z  code 14: UNKNOWN i komunikatem „Nie znaleziono trasy”.
  • Obejście problemu: wywołuj interfejs Discovery API tylko wtedy, gdy faktycznie potrzebujesz kandydatów do automatyzacji. Nie pobieraj z wyprzedzeniem ani nie zapisuj w pamięci podręcznej encji kandydujących. Przed wywołaniem metod interfejsu Discovery API sprawdź, czy encja jest online.
• W środowisku zawierającym wiele domów i wielu użytkowników przełączanie się między domami i użytkownikami może spowodować, że nie zostaną zwrócone żadne urządzenia.

Rozwiązane znane problemy

• Gdy aplikacja korzystająca z interfejsów API Google Home po raz pierwszy po uruchomieniu wywoła metodę HomeManager.structures(), nie otrzyma żadnych domów, nawet jeśli jest ich co najmniej 1. Może to sprawiać błędne wrażenie, że z kontem Google nie są powiązane żadne domy.
• Podczas wczytywania, tworzenia i edytowania automatyzacji użytkownicy mogą doświadczyć długiego czasu oczekiwania.
• Użytkownicy, którzy rozpoczynają proces konfiguracji w aplikacji Aparat, muszą dwukrotnie zeskanować kod QR, aby dokończyć proces uruchamiania Matter.
• W domu, w którym znajduje się ponad 200 urządzeń, interfejs Discovery API może nie zwrócić żadnych kandydatów.

2025-01-29

  Interfejsy API Google Home w publicznej wersji beta 1.1.0  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów Home API.

Wersje minimalne

• Minimalna wersja Usług Google Play: 25.02.32
• Minimalne wersje oprogramowania układowego koncentratora Google:
  • Wersja Cast: 3.75.456944
  • Minimalna wersja Fuchsia: 24.20241009.103.1900500
• Android SDK: home.android.sdk_202412_EAP_1_1_RC04
• Minimalna wersja aplikacji Google Home: działa z każdą wersją
• androidx.core – minimalna wersja biblioteki: 1.10.0
• Wersja Matter: 1.3.0.0
  • Uwaga: tymczasowe typy urządzeń i klastry Matter nie są obsługiwane.

Nowe funkcje

• Interfejs API strumieniowania:
  • Zapewnia strumienie zdarzeń, które powiadamiają o dodaniu, zmianie i usunięciu domów, pomieszczeń i urządzeń.
  • Zobacz Subskrybowanie zdarzeń dotyczących relacji między elementami.
• Batching API (funkcja eksperymentalna):
  • Umożliwia deweloperowi wysyłanie wielu poleceń w partiach, które są wykonywane jednocześnie.
  • Zobacz Wysyłanie wielu poleceń naraz.

Znane problemy

• Podczas wczytywania, tworzenia i edytowania automatyzacji użytkownicy mogą doświadczyć długiego czasu oczekiwania.
• Użytkownicy, którzy rozpoczynają proces konfiguracji w aplikacji Aparat, muszą dwukrotnie zeskanować kod QR, aby dokończyć proces uruchamiania Matter.
• W domu, w którym znajduje się ponad 200 urządzeń, interfejs Discovery API może po prostu nie zwrócić żadnych kandydatów.

Rozwiązane znane problemy

• Przełączenie zalogowanego konta Google może się nie powieść i spowodować błąd.
• Urządzenia Google TV mogą nie działać w przypadku automatyzacji, które używają cechy MediaPlayback.
• W domu, w którym znajduje się tylko urządzenie Google Hub:
  • Urządzenia Matter mogą być widoczne jako offline w aplikacji Google Home.
  • Asystent Google nie może sterować urządzeniami Matter.
  • Inteligentne ekrany nie mogą sterować urządzeniami Matter ani wyświetlać ich stanu.
• W przypadku niektórych urządzeń aplikacja nie zawsze odzwierciedla dokładny stan i może zgłaszać stan inny niż zgłaszany przez aplikację Google, taką jak aplikacja Google Home. Zwykle wynika to z tego, że urządzenia nie zgłaszają stanu do Google.
  • Obejście problemu: sprawdzenie stanu za pomocą aplikacji Google rozwiązuje problem z niezgodnością.

2025-01-14

Zaktualizowaliśmy wskazówki dotyczące inicjowania interfejsów API Google Home.

Wyjaśniliśmy, że instancja Home powinna być inicjowana jako singleton kontekstu. Zapewnia to płynniejsze działanie aplikacji i zapobiega błędom związanym z nieprawidłowymi sesjami.

2025-01-07

  Publiczna wersja beta interfejsów API Google Home  

Podczas publicznych testów wersji beta wszyscy deweloperzy mogą zacząć tworzyć i testować swoje aplikacje.

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu Android SDK interfejsów API Google Home, w tym ulepszoną obsługę urządzeń Google Nest Audio i urządzeń Google TV.

Wersje minimalne

• Minimalna wersja Usług Google Play: 24.45.34
• Minimalne wersje oprogramowania układowego koncentratora Google:
  • Wersja Cast: 3.74.444798
  • Minimalna wersja Fuchsia: 22.20240805.103.161
• Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
• Minimalna wersja aplikacji Google Home (GHA): działa z każdą wersją
• androidx.core – minimalna wersja biblioteki: 1.10.0
• Wersja Matter: 1.3.0.0
  • Uwaga: tymczasowe typy urządzeń Matter i klastry nie są obsługiwane.

Znane problemy

• Przełączenie zalogowanego konta Google może się nie powieść i spowodować błąd.
  • Obejście problemu: ponownie uruchom proces przyznawania uprawnień lub aplikację.
• Urządzenia Google TV mogą nie działać w przypadku automatyzacji, które używają cechy MediaPlayback.
• W domu, w którym znajduje się tylko urządzenie Google Hub:
  • Urządzenia Matter mogą być widoczne w aplikacji Google Home jako offline.
  • Asystent Google nie może sterować urządzeniami Matter.
  • Inteligentne ekrany nie mogą sterować urządzeniami Matter ani wyświetlać ich stanu.
• W przypadku niektórych urządzeń aplikacja nie zawsze odzwierciedla dokładny stan i może zgłaszać stan inny niż zgłaszany przez aplikację Google, taką jak aplikacja Google Home (GHA). Zwykle dzieje się tak, gdy urządzenia nie zgłaszają stanu do Google.
  • Obejście problemu: sprawdzenie stanu za pomocą aplikacji Google rozwiązuje problem z niezgodnością.

Rozwiązane znane problemy

• Jeśli aplikacja zostanie zminimalizowana podczas procesu, uruchomienie może się nie powieść.
  • Obejście problemu: użyj interfejsu suppressHalfSheetNotification() API, aby wyłączyć powiadomienia na połowie ekranu, gdy w aplikacji jest używany interfejs Commissioning API.
• Problem po stronie serwera może uniemożliwiać działanie poleceń „OK Google” w automatyzacjach.
• Jeśli używasz koncentratora z systemem Fuchsia, który nie ma w strukturze żadnych urządzeń Matter, i pozostawisz go bezczynnego przez ponad 3 godziny, uruchomienie pierwszego urządzenia Matter spowoduje, że będzie ono offline.
• Po przywróceniu danych fabrycznych na urządzeniu centralnym polecenia wysyłane do nowo uruchomionych urządzeń mogą się nie powieść, mimo że urządzenie jest zgłaszane jako online.