Informacje o wersji interfejsu API Home SDK na Androida

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
  • Android SDK: 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: typy i klastry urządzeń tymczasowych nie są obsługiwane.

Znane problemy

  • Zmiana zalogowanego konta Google może się nie udać i spowodować błąd.
    • Rozwiązanie: 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 swojej 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.