Informacje o wersji interfejsu API Home SDK na Androida

2025-03-14

  Interfejsy Home API w wersji publicznej beta 1.2.0  

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

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 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 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 urządzenia.
  • Po zresetowaniu koncentratora do ustawień fabrycznych urządzenia mogą wydawać się 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 „No route found” (Nie znaleziono trasy).
    • Sposób obejścia problemu: wywołuj interfejs Discovery API tylko wtedy, gdy potrzebujesz kandydatów do automatyzacji. 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

  • Gdy aplikacja interfejsów API Home po uruchomieniu po raz pierwszy wywoła funkcję HomeManager.structures(), otrzyma zero struktur, nawet jeśli jest ich więcej. Daje to nieprawdziwe 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 pakietu Android SDK interfejsów API Home.

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 urządzeń i klastry 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, np. 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, zgodnie z którymi występowanie Home powinno być inicjowane jako pojedynczy kontekst. 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 ogólnodostępnej (GA) pakietu SDK interfejsów API Home na Androida, 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 podczas tego 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 zarejestrowanych urządzeń mogą się nie powieść, mimo że urządzenie jest online.