Informacje o wersji interfejsu API Home SDK na Androida

2026-09-23

  Interfejsy Home API w wersji 1.11 ogólnodostępnej  

Ta wersja zawiera poprawki błędów i poprawia jakość GA w przypadku pakietu SDK Home API na Androida.

Wersje minimalne

Ważne aktualizacje

Nowe funkcje

Inne istotne zmiany

2026-09-16

Uruchomiliśmy 2 nowe serwery MCP. Domowy MCP umożliwia agentom osobistym bezpieczne interakcje z Twoim inteligentnym domem, a domowy MCP dla deweloperów udostępnia dokumentację z Centrum deweloperów domowych i inne zasoby dotyczące inteligentnego domu, które Twoi ulubieni agenci mogą przeszukiwać i o które mogą wysyłać zapytania.

Nowe funkcje

2026-09-16

Aplikacja próbna Home API na Androida została zaktualizowana do wersji Home API 1.10.1.

Przykładowa aplikacja

2026-08-28

  Interfejsy Home API w wersji 1.10.1 dostępne dla wszystkich użytkowników  

Ta wersja zawiera poprawki błędów i poprawia jakość GA w przypadku pakietu SDK Home API na Androida.

Wersje minimalne

Ważne aktualizacje

Nowe funkcje

Inne istotne zmiany

2026-08-07

Aplikacja próbna Home API na Androida została zaktualizowana do wersji 1.10.

Przykładowa aplikacja

2026-08-03

  Interfejsy Home API w wersji 1.10 ogólnodostępnej  

Ta wersja zawiera poprawki błędów i podnosi jakość pakietu SDK Home APIs na Androida do poziomu GA.

Wersje minimalne

2026-07-09

Flaga forceLaunch została wycofana. Aplikacje powinny przejść na wyliczenie ForcePermissionFlow, aby określać działanie interfejsu zgody użytkownika.

Nadchodzące zmiany

2026-07-08

Dostępny jest już przewodnik po urządzeniu routera granicznego na Androida.

Nowe treści

2026-07-07

Aplikacja próbna Home API na Androida została zaktualizowana do wersji Home API 1.9.1.

Przykładowa aplikacja

2026-06-26

  Home APIs Public Beta w wersji 1.9.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

Nowe funkcje

Rozwiązane znane problemy

  • Szybkie parowanie nie jest obsługiwane w przypadku modeli urządzeń 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

Aplikacja próbna interfejsów Home API na Androida została zaktualizowana do wersji 1.9.0 interfejsów Home API.

Przykładowa aplikacja

2026-05-29

  Interfejsy Home API w wersji beta 1.9  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

Nowe funkcje

Znane problemy

  • Szybkie parowanie nie jest obsługiwane w przypadku modeli urządzeń 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

Aplikacja próbna Home API na Androida została zaktualizowana do wersji Home API 1.8.1.

Przykładowa aplikacja

2026-05-01

  Home APIs Public Beta w wersji 1.8.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

Nowe funkcje

  • Cechy termostatu obsługują teraz odczytywanie i aktualizowanie, włączanie i wyłączanie oraz funkcje timera

Rozwiązane znane problemy

  • Wprowadzanie urządzenia Matter do eksploatacji może się nie udać.
  • Światło Philips BLE nie wyświetla prawidłowego stanu.
  • Opóźnienie powodujące niestabilność sieci i długie czasy odpowiedzi.

Znane problemy

  • Nie można uruchomić niektórych urządzeń za pomocą streamera Google TV 4K.
  • Gdy hubem 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

Aplikacja próbna Home API na Androida została zaktualizowana do wersji 1.8 interfejsów Home API.

Przykładowa aplikacja

2026-04-09

  Home APIs Public Beta w wersji 1.8  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

  • Usługi Google Play: 26.12.32
  • Oprogramowanie Google Hub, Cast, Nest Wifi Pro: 3.78.518349
  • Oprogramowanie Google Hub, Cast, wszystkie inne urządzenia Cast: 3.78.526062
  • Oprogramowanie układowe huba Google, Fuchsia: 29.20251023.103.2101601
  • Oprogramowanie sprzętowe hubu Google, 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ą
  • androidx.core biblioteka: działa z każdą wersją
  • Wersja Matter: 1.4.1.0
  • Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

Rozwiązane znane problemy

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

Znane problemy

  • Wprowadzanie urządzenia Matter do eksploatacji może się nie udać.

2026-03-13

  Home APIs Public Beta w wersji 1.7.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

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

Nowe funkcje

Inne istotne zmiany

  • Tryb bez huba został usunięty.

Przykładowa aplikacja

Rozwiązane znane problemy

  • W przypadku kamery wewnętrznej Nest Cam Indoor/zewnętrznej (zasilanej baterią lub przewodowo) i urządzenia Nest Doorbell (na baterie, 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 oznaczana jako „Online”, nawet gdy urządzenie jest w rzeczywistości offline.

Znane problemy

  • Nie można zmienić jednostek temperatury (C/F) na termostacie Google Nest Learning Thermostat (4 gen.).
  • Możliwe opóźnienia w stabilności sieci i reakcji urządzenia.
  • W mobilnej wersji Google Home w internecie górna ikona i przycisk Wstecz są zasłonięte przez nagłówek. Użytkownicy mogą nie mieć możliwości powrotu lub wyświetlania kluczowych elementów interfejsu.
  • Po przeprowadzeniu procesu OOBE w trybie federacyjnym centrala może utknąć w stanie „Łączenie…”.
  • Wprowadzanie urządzenia Matter do eksploatacji może się nie udać.
  • Centrum Androida TV może błędnie zgłaszać urządzenia Matter jako offline.
  • W przypadku bieżącej wersji oprogramowania kamery może nie być widoczna prawidłowa wersja oprogramowania.
  • Suwak interfejsu termostatu pokazuje temperatury, które są poza zakresem.
  • Gdy ustawiony jest czas trwania dzwonka, urządzenie nie dzwoni przez określony czas.

2026-02-13

Aplikacja próbna Home API na Androida została zaktualizowana do wersji 1.7 interfejsów Home API.

Przykładowa aplikacja

2026-02-09

  Home APIs Public Beta w wersji 1.7  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

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

Nowe funkcje

Inne istotne zmiany

Rozwiązane znane problemy

  • Interfejs History API zawsze zwraca wartość nextPageToken, co powoduje nieskończoną pętlę.
  • Błąd „User cancelled Permission flow” (Użytkownik anulował proces przyznawania uprawnień) występuje podczas próby zalogowania się na nowe konto.

Znane problemy

  • W przypadku kamery wewnętrznej Nest Cam Indoor/zewnętrznej (zasilanej baterią lub przewodowo) i urządzenia Nest Doorbell (na baterie, 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 oznaczana jako „Online”, nawet gdy urządzenie jest w rzeczywistości offline. Obejście: nie polegaj wyłącznie na stanie online typu inteligentnego urządzenia domowego (SHDT). Zamiast tego użyj mapy usługi stanu urządzenia docelowego (TDSS) w przypadku urządzeń ze źródłem LOCAL_SYNC.

2025-12-22

  Home APIs Public Beta w wersji 1.6  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

  • Usługi Google Play: 25.47.30
  • Oprogramowanie Google Hub, Cast, Nest Wifi Pro: 3.75.479819
  • Oprogramowanie układowe centrali Google, Cast, wszystkie pozostałe centrale oparte na Cast: 3.77.505721
  • Oprogramowanie układowe hubu Google, Fuchsia: 28.20250723.103.2100300
  • Oprogramowanie sprzętowe hubu Google, streamer Google TV, 4K: UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_6
  • Aplikacja Google Home: 1.6
  • androidx.core biblioteka: działa z każdą wersją
  • Wersja Matter: 1.4.1.0

Nowe funkcje

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

  • Elementy sterujące urządzeniem przestają działać po dłuższym okresie użytkowania. Obejście: ponownie uruchom hub.
  • Konfigurowanie urządzenia Matter może się nie udać.
  • Podczas próby dodania nowego konta w aplikacji przykładowej na Androida pojawia się błąd „User cancelled Permission flow” (Użytkownik anulował proces przyznawania uprawnień). Obejście: dodaj konta Google w ustawieniach urządzenia z Androidem.
  • Kamera przewodowa Walmart onn, która została uruchomiona przy użyciu pakietu SDK interfejsów Android Home API, nie może przesyłać strumieniowo obrazu na żywo w aplikacji Google Home.
  • Kamery skonfigurowane w aplikacjach korzystających z interfejsów Home API nie mogą rozpoczynać sesji transmisji na żywo w aplikacji Google Home.

2025-10-23

  Home APIs Public Beta w wersji 1.5.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

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

Nowe funkcje

Inne istotne zmiany

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

Rozwiązane znane problemy

  • Aplikacja przykładowa nie wyświetla prawidłowo stanu urządzenia w widoku Urządzenie.

26.09.2025 r.

  Wersja 1.5.0 interfejsów Home API w ramach publicznej wersji beta  

Ta wersja wprowadza obsługę urządzeń z kamerą, zawiera poprawki błędów i poprawia jakość wersji beta pakietu Home API SDK na Androida.

Wersje minimalne

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

Nowe funkcje

Inne istotne zmiany

  • Przykładowa aplikacja na Androida obsługuje teraz aparat, wdrażanie przez wielu administratorów i wcześniej zdefiniowaną automatyzację OnOff.

Rozwiązane znane problemy

  • Gdy obecnie aktywny hub zostanie usunięty, 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 gotowego ustawienia lub selektora temperatury kolorów, lampa Extended Color Light nie zaktualizuje koloru.

Znane problemy

  • Podczas przełączania z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie sterowania urządzeniem.
  • Sterowanie typami urządzeń Fan obsługiwanych przez Cloud-to-cloud może nie działać w przykładowej aplikacji.

2025-08-29

  Home APIs Public Beta w wersji 1.4.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

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

Nowe funkcje

Rozwiązane znane problemy

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

Znane problemy

  • Gdy obecnie aktywny hub zostanie usunięty, 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

  Wersja 1.4.0 interfejsów Home API w ramach publicznej wersji beta  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

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

Nowe funkcje

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

  • Urządzenia odkurzające, które zostały zadokowane, nie rejestrują stanu zadokowania.

Znane problemy

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

26.06.2025 r.

  Interfejsy Home API w wersji beta 1.3.2  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

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

Nowe funkcje

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

Inne istotne zmiany

  • Aplikacja przykładowa na Androida: użytkownicy mogą odłączyć aplikację i cofnąć jej uprawnienia.
  • W przykładowej aplikacji na Androida dodano zaktualizowane artefakty pakietu SDK, które obejmują play-services-home-17.0.0 i play-services-home-types-17.0.0.

Znane problemy

  • Urządzenia odkurzające, które zostały zadokowane, nie rejestrują stanu zadokowania.

5.06.2025 r.

  Home APIs Public Beta w wersji 1.3.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

  • Usługi Google Play: 25.19.32
  • Oprogramowanie układowe Google Hub, Cast: 3.75.468222
  • Oprogramowanie układowe hubów Google, 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ą
  • androidx.core biblioteka: działa z każdą wersją
  • Wersja Matter: 1.4.0.0

Nowe funkcje

Inne istotne zmiany

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

Rozwiązane znane problemy

Znane problemy

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

2025-05-12

  Home APIs Public Beta w wersji 1.3  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

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

Nowe funkcje

Rozwiązane znane problemy

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

Znane problemy

2025-04-09

  Home APIs Public Beta w wersji 1.2.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

  • Usługi Google Play: 25.09.33
  • Minimalne wersje oprogramowania hubów Google:
    • Przesyłanie: 3.75.468222
    • Fuchsia: 24.20241009.103.19006011
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • Aplikacja Google Home: działa z każdą wersją
  • androidx.core biblioteka: 1.10.0
  • Wersja Matter:1.4.0.0
1. Ta kompilacja jest obecnie wdrażana w wersji produkcyjnej i będzie dostępna na wszystkich urządzeniach do 22 kwietnia 2025 r.

Nowe funkcje

  • Zwiększyliśmy wydajność 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

Znane problemy

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

Rozwiązane znane problemy

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

2025-03-14

  Wersja 1.2.0 interfejsów Home API w ramach publicznej wersji beta  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

  • Minimalna wersja Usług Google Play: 25.06.32
  • Minimalne wersje oprogramowania hubów Google:
    • Wersja Cast: 3.75.456944
    • Minimalna wersja Fuksji: 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 dat częściowych w warunkach automatyzacji. Zobacz Używanie dat z warunkiem between.
    • W poprzednich wersjach interfejs Discovery API zwracał wartość NumberSetConstraint w przypadku niektórych pól bitmapy, gdy powinien zwracać wartość 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 z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie sterowania urządzeniem.
  • Po przywróceniu huba do ustawień fabrycznych urządzenia mogą być widoczne jako offline.
  • Jeśli wywołanie interfejsu Discovery API nastąpi przed inicjalizacją lub przed jej zakończeniem, zostanie zgłoszony błąd HomeException z kodem code 14: UNKNOWN i komunikatem „Nie znaleziono trasy”.
    • Obejście: wywołuj interfejs Discovery API tylko wtedy, gdy potrzebujesz kandydatów do automatyzacji. Nie pobieraj z wyprzedzeniem i nie zapisuj w pamięci podręcznej jednostek kandydatów. Sprawdź, czy podmiot jest online, zanim wywołasz na nim metody interfejsu Discovery API.
  • W środowisku zawierającym wiele struktur i wielu użytkowników przełączanie się między strukturami 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 Home API po raz pierwszy wywoła funkcję HomeManager.structures() po uruchomieniu, otrzyma zero domów, nawet jeśli jest ich co najmniej jeden. To stwarza błędne wrażenie, że z kontem Google nie są powiązane żadne struktury.
  • Podczas wczytywania, tworzenia i edytowania automatyzacji użytkownicy mogą długo czekać.
  • Użytkownicy, którzy rozpoczną proces konfiguracji w aplikacji Aparat, muszą dwukrotnie zeskanować kod QR, aby ukończyć wdrażanie Matter.
  • W strukturze zawierającej ponad 200 urządzeń interfejs Discovery API może po prostu nie zwracać żadnych kandydatów.

2025-01-29

  Home APIs Public Beta w wersji 1.1.0  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.

Wersje minimalne

  • Minimalna wersja Usług Google Play: 25.02.32
  • Minimalne wersje oprogramowania hubów Google:
    • Wersja Cast: 3.75.456944
    • Minimalna wersja Fuksji: 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

Znane problemy

  • Podczas wczytywania, tworzenia i edytowania automatyzacji użytkownicy mogą długo czekać.
  • Użytkownicy, którzy rozpoczną proces konfiguracji w aplikacji Aparat, muszą dwukrotnie zeskanować kod QR, aby ukończyć wdrażanie Matter.
  • W strukturze zawierającej ponad 200 urządzeń interfejs Discovery API może po prostu nie zwracać ż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 korzystają z cechy MediaPlayback.
  • W strukturze, która zawiera tylko hub Google:
    • Urządzenia Matter mogą być wyświetlane jako offline w aplikacji Google Home.
    • Asystent Google nie może sterować urządzeniami Matter.
    • Inteligentne wyświetlacze nie mogą sterować urządzeniami Matter ani wyświetlać stanu żadnego urządzenia Matter.
  • W przypadku niektórych urządzeń aplikacja może nie zawsze odzwierciedlać dokładny stan, a aplikacja może zgłaszać stan inny niż ten zgłaszany przez aplikację Google, np. Google Home. Zwykle dzieje się tak, ponieważ urządzenia nie zgłaszają stanu do Google.
    • Obejście: sprawdzenie stanu w aplikacji Google rozwiązuje problem z niezgodnością.

2025-01-14

Zaktualizowane wskazówki dotyczące inicjowania interfejsów Home API.

Wyjaśniliśmy, że instancja Home powinna być inicjowana jako pojedyncza instancja kontekstu. Zapewnia to większą wygodę użytkowników w aplikacji i zapobiega błędom związanym z nieprawidłowymi sesjami.

2025-01-07

  Wersja beta interfejsów Home API  

Podczas publicznej wersji beta dla deweloperów wszyscy deweloperzy mogą zacząć tworzyć i testować aplikacje.

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu Android SDK interfejsów Home API, w tym lepszą 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 hubów Google:
    • Wersja Cast: 3.74.444798
    • Minimalna wersja Fuksji: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • 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.

Znane problemy

  • Przełączenie zalogowanego konta Google może się nie powieść i spowodować błąd.
    • Obejście: ponownie uruchom proces przyznawania uprawnień lub ponownie uruchom aplikację.
  • Urządzenia Google TV mogą nie działać w przypadku automatyzacji, które korzystają z cechy MediaPlayback.
  • W strukturze, która zawiera tylko hub Google:
    • Urządzenia Matter mogą być wyświetlane jako offline w aplikacji Google Home (GHA).
    • Asystent Google nie może sterować urządzeniami Matter.
    • Inteligentne wyświetlacze nie mogą sterować urządzeniami Matter ani wyświetlać stanu żadnego urządzenia Matter.
  • W przypadku niektórych urządzeń aplikacja może nie zawsze odzwierciedlać dokładny stan, a Twoja aplikacja może zgłaszać stan inny niż ten zgłaszany przez aplikację Google, np. Google Home (GHA). Zwykle dzieje się tak, ponieważ urządzenia nie przesyłają informacji o stanie do Google.
    • Obejście: sprawdzenie stanu w aplikacji Google rozwiązuje problem z niezgodnością.

Rozwiązane znane problemy

  • Jeśli podczas procesu aplikacja zostanie zminimalizowana, konfiguracja może się nie powieść.
  • Problem po stronie serwera może uniemożliwiać działanie poleceń „Ok Google” w automatyzacjach.
  • Jeśli używasz huba z Fuchsią, który nie ma w strukturze żadnych urządzeń Matter, a hub jest nieużywany przez ponad 3 godziny, włączenie pierwszego urządzenia Matter spowoduje, że będzie ono offline.
  • Po przywróceniu danych fabrycznych huba polecenia do nowo skonfigurowanych urządzeń mogą się nie powieść, mimo że urządzenie jest zgłaszane jako online.