Informacje o wersji interfejsu API Home SDK na Androida

2025-09-26

  Wersja 1.5.0 interfejsów Home API w ramach otwartych testów beta  

Ta wersja wprowadza obsługę urządzeń z kamerą, 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.37.31
  • Minimalne wersje oprogramowania hubów Google:
    • Przesyłanie: 3.76.492738
    • 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

  • Automation API
    • Polecenia inicjujące, warunki i działania akceptują teraz struktury Matter jako parametry.
  • Device API
    • Dodanotyp urządzenia kamery. W przypadku dzwonka do drzwi dostępne są też te funkcje kamery:
      • transmisję na żywo z kamery.
      • dwukierunkowa rozmowa za pomocą kamery,
      • Rozpoczynanie i zatrzymywanie nagrywania kamerą.
  • Przykładowa aplikacja na Androida
    • Obsługa typu urządzenia Kamera:
      • transmisję na żywo z kamery.
      • dwukierunkowa rozmowa za pomocą kamery,
      • Rozpoczynanie i zatrzymywanie nagrywania kamerą.
      • Ograniczone uprawnienia do typów urządzeń.
    • Konfigurowanie przez wielu administratorów (udostępnianie skonfigurowanego urządzenia).
    • Wstępnie zdefiniowana OnOff automatyzacja.

Znane problemy

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

Rozwiązane znane problemy

  • Gdy obecnie aktywny hub zostanie usunięty siłowo, przez 5 minut nie będzie można sterować niektórymi urządzeniami. Po 5 minutach przywrócimy możliwość sterowania urządzeniami.
  • Gdy użytkownik wybierze kolor z gotowego ustawienia lub selektora temperatury barwowej, rozszerzone światło kolorowe nie zaktualizuje koloru.

2025-09-08

Udostępniliśmy aplikację przykładową na Androida w wersji 1.4.1.

Nowe funkcje

  • Tworzenie, zmienianie nazwy, aktualizowanie i usuwanie pokoju.
  • Uruchamianie w sieci Matter innej firmy.

Rozwiązane znane problemy

  • Link do strony wycofania uprawnień działa już prawidłowo.

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 Home API na Androida.

Wersje minimalne

  • Usługi Google Play: 25.33.32
  • Minimalne wersje oprogramowania hubów Google:
    • Cast: 3.76.495998
    • 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

Znane problemy

  • Gdy obecnie aktywny hub zostanie usunięty siłowo, przez 5 minut nie będzie można sterować niektórymi urządzeniami. Po 5 minutach przywrócimy możliwość sterowania urządzeniami.

Rozwiązane znane problemy

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

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 Home API na Androida.

Wersje minimalne

  • Usługi Google Play: 25.28.34
  • Minimalne wersje oprogramowania hubów Google:
    • Przesyłanie: 3.76.486931
    • 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

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ę lub przenieś ją w tle, a potem odczekaj co najmniej 10 sekund, zanim spróbujesz ponownie.

Rozwiązane znane problemy

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

2025-07-08

W przypadku oprogramowania Cast w wersji 3.76.479819 Nest Wifi Pro może teraz działać jako hub interfejsów API Home.

2025-06-26

  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
  • Minimalne wersje oprogramowania hubów Google:
    • Przesyłaj:
      • Google Home, Google Home Mini i Google Nest Mini: 3.75.468362
      • Google Nest Audio: 3.75.476451
    • Fuchsia: 26.20250116.103.2900
  • Android SDK: home.android.sdk_1_3_2
  • 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 pakietu SDK został podzielony na 2 osobne artefakty:
    • Platforma pakietu SDK interfejsów Home API (play-services-home-17.0.0.aar)
    • Cechy pakietu 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.

Przykładowa aplikacja na Androida

  • Użytkownicy mogą odłączyć aplikację i cofnąć jej uprawnienia.
  • Zaktualizowano artefakty pakietu SDK, aby uwzględniały 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.

2025-06-05

  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
  • Minimalne wersje oprogramowania hubów Google:
    • Przesyłanie: 3.75.468222
    • 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

Cechy

Przykładowa aplikacja na Androida

Dodaliśmy funkcje rejestrowania stanu struktur, urządzeń, typów, cech i automatyzacji, aby ułatwić debugowanie.

Znane problemy

W przykładowej aplikacji na Androida przycisk Utwórz automatyzację czasami wymaga kilku kliknięć, aby się aktywować.

Rozwiązane znane problemy

  • Aplikacja Google Home ulega awarii (FailedPreconditionException) podczas tworzenia automatyzacji, jeśli lokalizacja domu nie jest ustawiona w aplikacji Google Home (GHA) (informacje o tym, jak ustawić lokalizację domu, znajdziesz w artykule Zmiana adresu domu w Google).
  • W przykładowej aplikacji na Androida urządzenie z connectivityState PARTIALLY_ONLINE było wcześniej wyświetlane użytkownikowi jako offline. Ten stan jest teraz oznaczony jako online.

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
  • Minimalne wersje oprogramowania hubów Google:
    • Przesyłanie: 3.75.468222
    • 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

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 (GHA) (instrukcje znajdziesz w artykule Zmiana adresu domowego w Google).

  • Obejście: przed próbą utworzenia automatyzacji sprawdź, czy adres domowy jest obecny, korzystając z interfejsu Discovery API.

Rozwiązane znane problemy

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

2025-04-09

  Wersja 1.2.1 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.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 library: 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

  • Poprawiliśmy wydajność wczytywania obiektów z Home Graph.
  • Automation API
    • Dodaliśmy obsługę filtrów encji, które umożliwiają automatyzacji dynamiczne wybieranie urządzeń na podstawie kryteriów określonych w automatyzacji.
  • Device API

Znane problemy

  • Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Po przywróceniu huba 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 zgłoszony błąd HomeException z kodem code 14: UNKNOWN i komunikatem „No route found” (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. Patrz sekcja 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 cech LevelControl.

Znane problemy

  • Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Po przywróceniu huba 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 zgłoszony błąd HomeException z kodem code 14: UNKNOWN i komunikatem „No route found” (Nie znaleziono trasy).
    • Obejście: wywołuj interfejs Discovery API tylko wtedy, gdy potrzebujesz kandydatów do automatyzacji. Nie pobieraj wstępnie 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 struktur, nawet jeśli jest ich co najmniej jedna. 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 dokoń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

  Wersja 1.1.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.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 dokoń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 udać 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 pojedynczy obiekt kontekstu. Zapewnia to większą wygodę użytkownikom 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 SDK interfejsów Home API na Androida, w tym lepszą obsługę urządzeń Google Nest Audio i 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 dowolną 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 udać 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. aplikację Google Home (GHA). Zwykle dzieje się tak, gdy 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ą nie działać, mimo że urządzenie jest zgłaszane jako online.