Informacje o wersji interfejsu API Home SDK na Androida

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 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, 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.

Doprecyzowaliśmy, że instancja Home powinna być inicjowana 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

  • Wdrażanie 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.