Informacje o wersji interfejsu API Home SDK na Androida

2025-06-05

  Interfejsy Home API w wersji publicznej beta 1.3.1  

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

Minimalne wersje

  • Usługi Google Play: 25.19.32
  • Minimalne wersje oprogramowania Google Hub:
    • Cast: 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 dowolną wersją.
  • androidx.core biblioteka: działa z dowolną wersją
  • Wersja Matter: 1.4.0.0

Nowe funkcje

Cechy

Przykładowa aplikacja na Androida

Dodaliśmy funkcje do 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ę wymaga czasami kilku kliknięć, aby się uaktywnić.

Znane problemy

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

2025-05-12

  Interfejsy Home API w wersji publicznej beta 1.3  

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

Minimalne wersje

  • Usługi Google Play: 25.16.33
  • Minimalne wersje oprogramowania Google Hub:
    • Cast: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • Aplikacja Google Home: działa z dowolną wersją.
  • androidx.core biblioteka: działa z dowolną wersją
  • Wersja Matter: 1.4.0.0

Nowe funkcje

  • Automation API
    • Dodano obsługę cyklicznych zaplanowanych inicjatorów zdarzeń, które umożliwiają deweloperom tworzenie automatyzacji, które działają okresowo na podstawie czasu zegara, czasu słonecznego i warunków opartych na kalendarzu, przy użyciu wyrażeń cron.
  • Interfejs Device API
  • Struktura interfejsu API

Znane problemy

Aplikacja Google Home ulega awarii (FailedPreconditionException) podczas tworzenia automatyzacji, jeśli lokalizacja domu nie jest ustawiona w aplikacji Google Home (GHA). Aby to zrobić, zapoznaj się z informacjami w sekcji Zmienianie adresu domowego w Google.

  • Rozwiązanie: zanim spróbujesz utworzyć automatyzacje, sprawdź, czy adres domowy jest obecny w interfejsie Discovery API.

Znane problemy

  • Podczas przełączania się z sieci Wi-Fi na sieć komórkową może wystąpić wydłużenie czasu reakcji sterowania urządzeniem.
  • Po przywróceniu urządzenia do ustawień fabrycznych może się wydawać, że jest offline.

2025-04-09

  Interfejsy Home API w wersji publicznej beta 1.2.1  

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

Minimalne wersje

  • Usługi Google Play: 25.09.33
  • Minimalne wersje oprogramowania Google Hub:
    • Cast: 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 dowolną wersją.
  • androidx.core biblioteka: 1.10.0
  • Wersja Matter: 1.4.0.0
1. Ta wersja jest obecnie wdrażana w wersji produkcyjnej i będzie dostępna na wszystkich urządzeniach do 22 kwietnia 2025 r.

Nowe funkcje

  • Zwiększona wydajność podczas wczytywania obiektów z domowego grafu.
  • Automation API
    • Dodaliśmy obsługę filtrów elementów, które umożliwiają automatyzacjom dynamiczne wybieranie urządzeń na podstawie kryteriów określonych w automatyzacji.
  • Interfejs Device API

Znane problemy

  • Podczas przełączania się z sieci Wi-Fi na sieć komórkową może wystąpić wydłużenie czasu reakcji sterowania urządzeniem.
  • Po przywróceniu urządzenia do ustawień fabrycznych może się wydawać, że jest offline.

Rozwiązane znane problemy

  • Jeśli interfejs Discovery API zostanie wywołany przed zainicjowaniem lub przed zakończeniem inicjalizacji, zostanie zwrócony błąd HomeException z  code 14: UNKNOWN i wyświetlony komunikat „Nie znaleziono trasy”.
  • W środowisku zawierającym wiele struktur i 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

  Interfejsy Home API w wersji publicznej beta 1.2.0  

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

Minimalne wersje

  • Minimalna wersja Usług Google Play: 25.06.32
  • Minimalne wersje oprogramowania Google Hub:
    • 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 dowolną wersją
  • androidx.core Minimalna wersja biblioteki: 1.10.0
  • Wersja Matter: 1.3.0.0
    • Uwaga: tymczasowe typy i klastry urządzeń 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 opcją „między”.
    • 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. Jest to ograniczone do bitmap optionsMask i optionsOverride w poleceniach atrybutów LevelControl.

Znane problemy

  • Podczas przełączania się z sieci Wi-Fi na sieć komórkową może wystąpić wydłużenie czasu reakcji sterowania urządzeniem.
  • Po przywróceniu urządzenia do ustawień fabrycznych może się wydawać, że jest offline.
  • Jeśli interfejs Discovery API zostanie wywołany przed zainicjowaniem lub przed zakończeniem inicjalizacji, zostanie zwrócony błąd HomeException code 14: UNKNOWN i wyświetlony komunikat „Nie znaleziono trasy”.
    • Sposób obejścia problemu: wywołuj interfejs Discovery API tylko wtedy, gdy potrzebujesz automatyzacji kandydatów. Nie pobieraj wstępne ani nie przechowuj w pamięci podręcznej kandydatów do encji. Zanim wywołasz metody interfejsu Discovery API, sprawdź, czy dany obiekt jest online.
  • W środowisku zawierającym wiele struktur i 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

  • Przy pierwszym wywołaniu interfejsu API Home po uruchomieniu aplikacji HomeManager.structures() nie ma żadnych struktur, nawet jeśli jest ich więcej niż 1. Daje to błędne wrażenie, że z kontem Google nie są powiązane żadne struktury.
  • Podczas wczytywania, tworzenia i edytowania automatyzacji użytkownicy mogą napotkać długie czasy oczekiwania.
  • Użytkownicy, którzy rozpoczną proces konfiguracji z aplikacji Aparat, muszą zeskanować kod QR dwa razy, aby dokończyć konfigurowanie Matter.
  • W strukturze zawierającej ponad 200 urządzeń interfejs Discovery API może po prostu nie zwrócić żadnych kandydatów.

2025-01-29

  Interfejsy Home API w wersji publicznej beta 1.1.0  

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

Minimalne wersje

  • Minimalna wersja Usług Google Play: 25.02.32
  • Minimalne wersje oprogramowania Google Hub:
    • 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 dowolną wersją
  • androidx.core Minimalna wersja biblioteki: 1.10.0
  • Wersja Matter: 1.3.0.0
    • Uwaga: tymczasowe typy i klastry urządzeń Matter nie są obsługiwane.

Nowe funkcje

Znane problemy

  • Podczas wczytywania, tworzenia i edytowania automatyzacji użytkownicy mogą napotkać długie czasy oczekiwania.
  • Użytkownicy, którzy rozpoczną proces konfiguracji z aplikacji Aparat, muszą zeskanować kod QR dwa razy, aby dokończyć konfigurowanie Matter.
  • W strukturze zawierającej ponad 200 urządzeń interfejs Discovery API może po prostu nie zwrócić żadnych kandydatów.

Rozwiązane znane problemy

  • Zmiana 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 atrybutu MediaPlayback.
  • W strukturze zawierającej tylko 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ć stanu żadnego urządzenia Matter.
  • W przypadku niektórych urządzeń aplikacja może nie zawsze odzwierciedlać dokładny stan, a stan zgłoszony przez Twoją aplikację może być inny niż ten zgłoszony przez aplikację Google, na przykład Google Home. Jest to zwykle spowodowane tym, że urządzenia nie zgłaszają stanu do Google.
    • Sposób obejścia problemu: sprawdzenie stanu w aplikacji Google rozwiązuje niezgodność.

2025-01-14

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

Wprowadziliśmy bardziej przejrzyste zasady dotyczące inicjowania wystąpienia Home jako pojedynczego kontekstu. Zapewnia to płynniejsze działanie aplikacji i unikanie błędów związanych z nieprawidłowymi sesjami.

2025-01-07

  Home APIs Public Beta release  

Podczas publicznej wersji beta deweloperzy mogą zacząć tworzyć i testować swoje aplikacje.

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

Minimalne wersje

  • Minimalna wersja Usług Google Play: 24.45.34
  • Minimalne wersje oprogramowania Google Hub:
    • Wersja Cast: 3.74.444798
    • Minimalna wersja Fuchsia: 22.20240805.103.161
  • Pakiet SDK Androida: home.android.sdk_202411_EAP_1_0_1_RC00
  • Minimalna wersja aplikacji Google Home (GHA): działa z dowolną wersją
  • androidx.core Minimalna wersja biblioteki: 1.10.0
  • Wersja Matter: 1.3.0.0
    • Uwaga: tymczasowe typy i klastry urządzeń Matter nie są obsługiwane.

Znane problemy

  • Zmiana zalogowanego konta Google może się nie udać i spowodować błąd.
    • Sposób obejścia problemu: ponownie uruchom proces przyznawania uprawnień lub uruchom ponownie aplikację.
  • Urządzenia Google TV mogą nie działać w przypadku automatyzacji, które korzystają z atrybutu MediaPlayback.
  • W strukturze zawierającej tylko Google Hub:
    • Urządzenia Matter mogą być widoczne jako offline w aplikacji Google Home (GHA).
    • Asystent Google nie może sterować urządzeniami Matter.
    • Inteligentne ekrany 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łoszony przez aplikację Google, np. Google Home (GHA). Dzieje się tak zazwyczaj dlatego, że urządzenia nie przekazują stanu do Google.
    • Sposób obejścia problemu: sprawdzenie stanu w aplikacji Google rozwiązuje niezgodność.

Rozwiązane znane problemy

  • Wdrożenie może się nie udać, jeśli aplikacja zostanie zminimalizowana w trakcie procesu.
    • Sposób obejścia problemu: użyj interfejsu suppressHalfSheetNotification() API, aby wyłączyć powiadomienia w układce Halfsheet, gdy w aplikacji używany jest interfejs Commissioning API.
  • Problemy po stronie serwera mogą uniemożliwić działanie inicjatorów OkGoogle w automatyzacjach.
  • Jeśli używasz koncentratora z systemem Fuchsia, który nie ma w strukturze żadnych urządzeń Matter, a koncentrator jest nieaktywny przez ponad 3 godziny, uruchomienie pierwszego urządzenia Matter spowoduje, że to urządzenie przejdzie w tryb offline.
  • Po przywróceniu danych fabrycznych na koncentratorze polecenia wysyłane do nowo zainstalowanych urządzeń mogą się nie powieść, mimo że urządzenie jest online.