2025-01-29
Interfejsy Home API w wersji publicznej beta 1.1.0Ta 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
- Streaming API:
- Dostarcza strumienie zdarzeń, które powiadamią o dodanych, zmienionych i usuniętych strukturach, salach i urządzeniach.
- Zapoznaj się z sekcją Subskrybuj zdarzenia dotyczące relacji między elementami.
- Interfejs API grupowania (eksperymentalny):
- Umożliwia deweloperowi wysyłanie wielu poleceń w partiach, które są wykonywane jednocześnie.
- Zobacz Wysyłanie wielu poleceń jednocześnie.
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 releasePodczas 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.
- Sposób obejścia problemu: użyj interfejsu
- 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.