2026-02-09
Home APIs Public Beta w wersji 1.7Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Usługi Google Play: 26.02.34
- Minimalne wersje oprogramowania hubów Google:
- Przesyłaj:
- Nest Wifi Pro: 3.76.508025
- Wszystkie pozostałe urządzenia Cast: 3.77.510748
- Fuchsia: 29.20251023.103.2100
- Streamer Google TV, 4K: UTTK.250729.004
- Przesyłaj:
- Android SDK: home.android.sdk_GHP_1_7
- Aplikacja Google Home: 1.7
androidx.corebiblioteka: działa z każdą wersją- Wersja Matter: 1.4.1.0 z eksperymentalną obsługą wersji 1.5.0.
Nowe funkcje
- Automations API
- Automatyzacje lokalne: niektóre automatyzacje mogą być teraz wykonywane lokalnie na podstawie warunków takich jak łączność, typy urządzeń i cechy.
- Device API
- Włączanie początkowej konfiguracji kamery w aplikacjach.
- Nowe funkcje kamer i dzwonków
Szczegółowe informacje znajdziesz w przewodniku po kamerach na Androida i przewodniku po dzwonkach na Androida.
- Ustawienia
- Stan urządzenia
- Informacje o urządzeniu
- Zapytanie o uprawnienia umożliwia aplikacji określenie, do których typów urządzeń użytkownik przyznał dostęp.
Inne ważne zmiany
HomeException.unsupportedzostał zastąpiony przezHomeException.unimplementedw celu dopasowania do standardowych kodów błędów.- W wersji 1.7 zmienił się generator spakowanego kodu dla cech niestandardowych. Deweloperzy, którzy mają niestandardowe cechy, muszą ponownie skompilować swoje cechy po zintegrowaniu pakietu SDK w wersji 1.7.
Rozwiązane znane problemy
- Interfejs History API zawsze zwraca wartość
nextPageToken, co powoduje nieskończoną pętlę. - Podczas próby zalogowania się na nowe konto występuje błąd „User cancelled Permission flow” (Użytkownik anulował proces przyznawania uprawnień).
Znane problemy
- W przypadku kamer Nest Cam wewnętrznych/zewnętrznych (zasilanych baterią lub z sieci) i dzwonków Nest Doorbell (zasilanych baterią, 2 generacji) opcja „Pozostały czas pracy na baterii” nie jest dostępna w ustawieniach baterii.
- Ustawienie czasu trwania dzwonka jest ignorowane.
- Światło Philips BLE jest nieprawidłowo wyświetlane jako „Online”, nawet gdy urządzenie jest w rzeczywistości offline.
- Obejście: nie polegaj wyłącznie na stanie online typu urządzenia inteligentnego (SHDT).
Zamiast tego używaj mapy usługi stanu urządzenia docelowego (TDSS) w przypadku urządzeń ze źródłem
LOCAL_SYNC.
- Obejście: nie polegaj wyłącznie na stanie online typu urządzenia inteligentnego (SHDT).
Zamiast tego używaj mapy usługi stanu urządzenia docelowego (TDSS) w przypadku urządzeń ze źródłem
2025-12-22
Home APIs Public Beta w wersji 1.6Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Usługi Google Play: 25.47.30
- Minimalne wersje oprogramowania hubów Google:
- Przesyłaj:
- Nest Wifi Pro: 3.75.479819
- Wszystkie pozostałe urządzenia Cast: 3.77.505721
- Fuchsia: 28.20250723.103.2100300
- Streamer Google TV, 4K: UTTK.250729.004
- Przesyłaj:
- Android SDK: home.android.sdk_GHP_1_6
- Aplikacja Google Home: 1.6
androidx.corebiblioteka: działa z każdą wersją- Wersja Matter:1.4.1.0
Nowe funkcje
- Automation API
- Obsługa cech związanych z pogodą
Dodaliśmy obsługę cechy Pogoda w poleceniach inicjujących i warunkach automatyzacji. Zobacz Starter na podstawie pogody.
- Obsługa cech związanych z pogodą
- Device API
- Obsługa większej liczby funkcji kamer i dzwonków do drzwi:
- Nowe ustawienia:
- Włączanie i wyłączanie noktowizora.
- Jasność diody stanu.
- Widoczny obszar kamery.
- Orientacja obrazu.
- Czułość wybudzania.
- Maksymalny czas trwania zdarzenia.
- Dźwięki dzwonka.
Więcej informacji znajdziesz w przewodniku po urządzeniach z Androidem z kamerą.
- Nowe ustawienia:
- Obsługa większej liczby funkcji kamer i dzwonków do drzwi:
- Połączenie
- Logowanie się przez Google inicjowane przez aplikację, które umożliwia aplikacjom inicjowanie
HomeClientza pomocą informacji o koncie Google, aby usprawnić UX i wyeliminować konieczność sprawdzania, który użytkownik korzysta z aplikacji. - Tryb bez centrali
Użytkownicy mogą teraz wprowadzać do systemu i sterować niektórymi urządzeniami Matter bez osobnego huba.
- Logowanie się przez Google inicjowane przez aplikację, które umożliwia aplikacjom inicjowanie
- Structure API
- Nowy interfejs API aktywacji hubów, który umożliwia aplikacjom wykrywanie i aktywowanie hubów.
- Przykładowa aplikacja na Androida
- Ustawienia kamery i dzwonka
- Włączanie i wyłączanie mikrofonu.
- Włączanie i wyłączanie nagrywania dźwięku.
- Gotowe automatyzacje
- Dodaliśmy obsługę typów urządzeń Wentylator i Głośnik.
- Ustawienia kamery i dzwonka
- Logowanie przez Google zainicjowane przez aplikację.
Znane problemy
- Elementy sterujące urządzeniem przestają działać po dłuższym okresie użytkowania.
- Obejście problemu: ponownie uruchom hub.
- Konfigurowanie urządzenia Matter może się nie udać.
- Podczas próby dodania nowego konta w aplikacji przykładowej na Androida pojawia się błąd „User cancelled Permission flow” (Użytkownik anulował proces przyznawania uprawnień).
- Obejście: dodaj konta Google w ustawieniach urządzenia z Androidem.
- Kamera monitoringu przewodowa Walmart onn, która została uruchomiona przy użyciu pakietu SDK interfejsów API Home na Androida, nie może przesyłać strumieniowo obrazu na żywo w aplikacji Google Home.
2025-10-23
Home APIs Public Beta w wersji 1.5.1Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Usługi Google Play: 25.41.30
- Minimalne wersje oprogramowania hubów Google:
- Cast: 3.76.495998
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5_1
- Aplikacja Google Home: działa z każdą wersją
androidx.corebiblioteka: działa z każdą wersją- Wersja Matter:1.4.1.0
Nowe funkcje
- Structure API
- Interfejs Hub Activation API umożliwia programowe wykrywanie i aktywowanie urządzenia Google Home. Zobacz interfejs API aktywacji huba na Androidzie.
- Interfejs Hub Activation API umożliwia programowe wykrywanie i aktywowanie urządzenia Google Home. Zobacz interfejs API aktywacji huba na Androidzie.
- Przykładowa aplikacja na Androida
- Obsługa typu urządzenia dzwonek do drzwi w przypadku:
- OnOff
- Transmisja na żywo
- Rozmowa dwukierunkowa
- Interfejs Hub Activation API: aktywowanie hubów
- Obsługa typu urządzenia dzwonek do drzwi w przypadku:
Rozwiązane znane problemy
- Aplikacja przykładowa nie wyświetla prawidłowo stanu urządzenia w widoku Urządzenie.
26.09.2025 r.
Wersja 1.5.0 interfejsów Home API w ramach otwartych testów betaTa wersja wprowadza obsługę urządzeń z kamerą, zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK Androida interfejsów Home API.
Wersje minimalne
- Usługi Google Play: 25.37.31
- Minimalne wersje oprogramowania hubów Google:
- Przesyłanie: 3.76.492738
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5
- Aplikacja Google Home: działa z każdą wersją
androidx.corebiblioteka: działa z każdą wersją- Wersja Matter:1.4.1.0
Nowe funkcje
- Automation API
- Polecenia inicjujące, warunki i działania akceptują teraz struktury Matter jako parametry.
- Device API
- Dodanotyp urządzenia kamery. W przypadku dzwonka do drzwi dostępne są też te funkcje kamery:
- transmisję na żywo z kamery.
- Rozmowa dwukierunkowa z kamery.
- Rozpoczynanie i zatrzymywanie nagrywania kamerą.
- Przykładowa aplikacja na Androida
- Obsługa typu urządzenia Aparat:
- transmisję na żywo z kamery.
- Rozmowa dwukierunkowa z kamery.
- Rozpoczynanie i zatrzymywanie nagrywania kamerą.
- Ograniczone uprawnienia do typów urządzeń.
- Uruchamianie przez wielu administratorów (udostępnianie uruchomionego urządzenia).
- Wstępnie zdefiniowana
OnOffautomatyzacja.
- Obsługa typu urządzenia Aparat:
Znane problemy
- Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniem.
- Sterowanie typami urządzeń Fan obsługiwanych przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.
Rozwiązane znane problemy
- Gdy obecnie aktywny hub zostanie usunięty, przez 5 minut nie będzie można sterować niektórymi urządzeniami. Po 5 minutach możliwość sterowania urządzeniami zostanie przywrócona.
- Gdy użytkownik wybierze kolor z gotowego ustawienia lub selektora temperatury barwowej, rozszerzone światło kolorowe nie zaktualizuje koloru.
2025-09-08
Udostępniliśmy wersję 1.4.1 aplikacji przykładowej na Androida.
Nowe funkcje
- Tworzenie, zmienianie nazwy, aktualizowanie i usuwanie pokoju.
- Uruchamianie w sieci Matter innej firmy.
Rozwiązane znane problemy
- Link do strony wycofania uprawnień działa już prawidłowo.
2025-08-29
Home APIs Public Beta w wersji 1.4.1Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Usługi Google Play: 25.33.32
- Minimalne wersje oprogramowania hubów Google:
- Cast: 3.76.495998
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_4_1
- Aplikacja Google Home: działa z każdą wersją
androidx.corebiblioteka: działa z każdą wersją- Wersja Matter:1.4.0.0
Nowe funkcje
- Device API
- Zdefiniowano nowy kod
DecommissionIneligibleReason, który jest używany podczas próby wycofania urządzenia z wieloma źródłami. Zobacz Urządzenia z wieloma źródłami.
- Zdefiniowano nowy kod
Znane problemy
- Gdy obecnie aktywny hub zostanie usunięty, przez 5 minut nie będzie można sterować niektórymi urządzeniami. Po 5 minutach możliwość sterowania urządzeniami zostanie przywrócona.
Rozwiązane znane problemy
- Przykładowa aplikacja na Androida ulega awarii, gdy użytkownik próbuje ustawić termostat w trybie, którego nie obsługuje.
2025-07-31
Wersja 1.4.0 interfejsów Home API w ramach publicznej wersji betaTa wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Usługi Google Play: 25.28.34
- Minimalne wersje oprogramowania hubów Google:
- Przesyłanie: 3.76.486931
- Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_4_0
- Aplikacja Google Home: działa z każdą wersją
androidx.corebiblioteka: działa z każdą wersją- Wersja Matter:1.4.0.0
Nowe funkcje
- Automation API
- Automatyzacje mogą być ograniczone do określonej liczby wykonań. Zobacz Ogranicz liczbę uruchomień.
- Device API
- Możliwość programowego usuwania urządzenia Matter. Zobacz Usuwanie urządzenia.
- Usunęliśmy te wycofane elementy
HomeDevice:HomeDevice.trait(). Zobacz Dostęp do urządzeń i metadanych urządzeń na Androidzie.HomeDevice.isInRoom. Użyj w zamian formatuHomeDevice.roomId.HomeDevice.isInStructure. Użyj w zamian formatuHomeDevice.structureId.
- Structure API
-
Home.hasPermissions()uwzględnia teraz zarówno stan autoryzacji OAuth użytkownika (dostęp do struktury), jak i przyznane uprawnienia aplikacji.
-
- Przykładowa aplikacja na Androida
- Zastąpiono wycofane wywołania interfejsu API.
- Zmień nazwę urządzenia.
- Usuń urządzenia obsługujące tylko Matter.
Znane problemy
- Po wylogowaniu się z telefonu i ponownym zalogowaniu aplikacja korzystająca z interfejsów Home API nie może sterować urządzeniami.
- Obejście: zamknij aplikację lub przenieś ją w tle, a potem odczekaj co najmniej 10 sekund, zanim spróbujesz ponownie.
Rozwiązane znane problemy
- Odkurzacze, które zostały zadokowane, nie rejestrują stanu zadokowania.
2025-07-08
W przypadku oprogramowania Cast w wersji 3.76.479819 Nest Wifi Pro może teraz działać jako hub interfejsów API Home.
26.06.2025 r.
Interfejsy Home API w wersji beta 1.3.2Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Usługi Google Play: 25.23.31
- Minimalne wersje oprogramowania hubów Google:
- Przesyłaj:
- Google Home, Google Home Mini i Google Nest Mini: 3.75.468362
- Google Nest Audio: 3.75.476451
- Fuchsia: 26.20250116.103.2900
- Przesyłaj:
- Android SDK: home.android.sdk_1_3_2
- Aplikacja Google Home: działa z każdą wersją
androidx.corebiblioteka: działa z każdą wersją- Wersja Matter:1.4.0.0
Nowe funkcje
- Artefakt pakietu SDK został podzielony na 2 osobne artefakty:
- Platforma pakietu SDK interfejsów Home API (
play-services-home-17.0.0.aar) - Cechy pakietu SDK i typy urządzeń (
play-services-home-types-17.0.0.aar)
Od tej wersji deweloperzy muszą uwzględniać oba artefakty w ścieżkach bibliotek czasu kompilacji i wykonywania projektu.
- Platforma pakietu SDK interfejsów Home API (
Przykładowa aplikacja na Androida
- Użytkownicy mogą odłączyć aplikację i cofnąć jej uprawnienia.
- Zaktualizowano artefakty pakietu SDK, aby uwzględniały
play-services-home-17.0.0iplay-services-home-types-17.0.0.
Znane problemy
- Odkurzacze, które zostały zadokowane, nie rejestrują stanu zadokowania.
5.06.2025 r.
Home APIs Public Beta w wersji 1.3.1Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Usługi Google Play: 25.19.32
- Minimalne wersje oprogramowania hubów Google:
- Przesyłanie: 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 każdą wersją
androidx.corebiblioteka: działa z każdą wersją- Wersja Matter:1.4.0.0
Nowe funkcje
Cechy
- Wprowadza cechę
SyntheticSwitch, która upraszcza obsługę zdarzeń generowanych przez urządzenia Matter Switch i umożliwia przełącznikom wywoływanie poleceń inicjujących automatyzację. - Cecha
ExtendedDoorLockuległa zmianie powodującej niezgodność: typ danych polauser_idzostał zmieniony zStringnaLong. ZobaczAplikacje korzystające z tego atrybutu muszą zostać ponownie skompilowane.
Przykładowa aplikacja na Androida
Dodaliśmy funkcje 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ę czasami wymaga kilku kliknięć, aby się aktywować.
Rozwiązane znane problemy
- Aplikacja Google Home ulega awarii (
FailedPreconditionException) podczas tworzenia automatyzacji, jeśli lokalizacja domu nie jest ustawiona w aplikacji Google Home (GHA) (informacje o tym, jak ustawić lokalizację domu, znajdziesz w artykule Zmiana adresu domu w Google). - W przykładowej aplikacji na Androida urządzenie z
connectivityStatePARTIALLY_ONLINEbyło wcześniej wyświetlane użytkownikowi jako offline. Ten stan jest teraz oznaczony jako online.
2025-05-12
Home APIs Public Beta w wersji 1.3Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Usługi Google Play: 25.16.33
- Minimalne wersje oprogramowania hubów Google:
- Przesyłanie: 3.75.468222
- Fuchsia: 26.20250116.103.2201
- Android SDK: home.android.sdk_202504_EAP_1_3_RC00
- Aplikacja Google Home: działa z każdą wersją
androidx.corebiblioteka: działa z każdą wersją- Wersja Matter:1.4.0.0
Nowe funkcje
- Automation API
- Dodaliśmy obsługę
�
cron
- Dodaliśmy obsługę
�
- Device API
- Dodaliśmy możliwość zmiany nazwy urządzeń. Zobacz zmienianie nazwy urządzenia.
- Structure API
- Dodaliśmy możliwość zmiany nazwy pokoi. Zobacz zmienianie nazwy pokoju.
Znane problemy
Aplikacja Google Home ulega awarii z błędem FailedPreconditionException podczas tworzenia automatyzacji, jeśli lokalizacja domu nie jest ustawiona w aplikacji Google Home (GHA) (instrukcje znajdziesz w artykule Zmiana adresu domowego w Google).
- Obejście: przed próbą utworzenia automatyzacji sprawdź, czy adres domowy jest obecny, korzystając z interfejsu Discovery API.
Rozwiązane znane problemy
- Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniem.
- Po przywróceniu huba do ustawień fabrycznych urządzenia mogą być widoczne jako offline.
2025-04-09
Wersja 1.2.1 interfejsów Home API w ramach publicznej wersji betaTa wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Usługi Google Play: 25.09.33
- Minimalne wersje oprogramowania hubów Google:
- Przesyłanie: 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 każdą wersją
androidx.corelibrary: 1.10.0- Wersja Matter:1.4.0.0
Nowe funkcje
- Poprawiliśmy wydajność wczytywania obiektów z Home Graph.
- Automation API
- Dodaliśmy obsługę filtrów encji, które umożliwiają automatyzacji dynamiczne wybieranie urządzeń na podstawie kryteriów określonych w automatyzacji.
- Device API
- Informacje o urządzeniach w chmurze są teraz dostępne w
BasicInformationTrait.
- Informacje o urządzeniach w chmurze są teraz dostępne w
Znane problemy
- Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniem.
- Po przywróceniu huba do ustawień fabrycznych urządzenia mogą być widoczne jako offline.
Rozwiązane znane problemy
- Jeśli interfejs Discovery API zostanie wywołany przed inicjalizacją lub przed jej zakończeniem, zostanie zgłoszony błąd
HomeExceptionz kodemcode 14: UNKNOWNi komunikatem „No route found” (Nie znaleziono trasy). - W środowisku zawierającym wiele struktur i wielu 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
Wersja 1.2.0 interfejsów Home API w ramach publicznej wersji betaTa wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Minimalna wersja Usług Google Play: 25.06.32
- Minimalne wersje oprogramowania hubów Google:
- Wersja Cast: 3.75.456944
- Minimalna wersja Fuchsi: 24.20241009.103.1900601
- Android SDK: home.android.sdk_1_2_0_RC06
- Minimalna wersja aplikacji Google Home: działa z każdą wersją
androidx.coreminimalna 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. Patrz sekcja Używanie dat z warunkiem between.
- W poprzednich wersjach interfejs Discovery API zwracał wartość
NumberSetConstraintw przypadku niektórych pól bitmapy, gdy powinien zwracać wartośćBitmapConstraint. Te pola zwracają teraz wartośćBitmapConstraintzgodnie z oczekiwaniami. Dotyczy to tylko map bitowychoptionsMaskioptionsOverridew poleceniach cechLevelControl.
Znane problemy
- Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniem.
- Po przywróceniu huba do ustawień fabrycznych urządzenia mogą być widoczne jako offline.
- Jeśli interfejs Discovery API zostanie wywołany przed inicjalizacją lub przed jej zakończeniem, zostanie zgłoszony błąd
HomeExceptionz kodemcode 14: UNKNOWNi komunikatem „No route found” (Nie znaleziono trasy).- Obejście: wywołuj interfejs Discovery API tylko wtedy, gdy potrzebujesz kandydatów do automatyzacji. Nie pobieraj wstępnie i nie zapisuj w pamięci podręcznej proponowanych jednostek. Sprawdź, czy podmiot jest online, zanim wywołasz na nim metody interfejsu Discovery API.
- W środowisku zawierającym wiele struktur i wielu 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 korzystająca z interfejsów Home API po raz pierwszy wywoła funkcję
HomeManager.structures()po uruchomieniu, otrzyma zero struktur, nawet jeśli jest ich co najmniej jedna. To stwarza błędne wrażenie, że z kontem Google nie są powiązane żadne struktury. - Podczas wczytywania, tworzenia i edytowania automatyzacji użytkownicy mogą doświadczać długiego czasu oczekiwania.
- Użytkownicy, którzy rozpoczną proces konfiguracji w aplikacji Aparat, muszą dwukrotnie zeskanować kod QR, aby dokończyć wdrożenie Matter.
- W strukturze zawierającej ponad 200 urządzeń interfejs Discovery API może po prostu nie zwracać żadnych kandydatów.
2025-01-29
Home APIs Public Beta w wersji 1.1.0Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida.
Wersje minimalne
- Minimalna wersja Usług Google Play: 25.02.32
- Minimalne wersje oprogramowania hubów Google:
- Wersja Cast: 3.75.456944
- Minimalna wersja Fuksji: 24.20241009.103.1900500
- Android SDK: home.android.sdk_202412_EAP_1_1_RC04
- Minimalna wersja aplikacji Google Home: działa z każdą wersją
androidx.coreminimalna 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
- Streaming API:
- Udostępnia strumienie zdarzeń, które powiadamiają o dodanych, zmienionych i usuniętych strukturach, pomieszczeniach i urządzeniach.
- Zobacz Subskrybowanie zdarzeń związanych z relacjami między elementami.
- Batching API (eksperymentalny):
- Umożliwia deweloperowi wysyłanie wielu poleceń w pakietach, które są wykonywane jednocześnie.
- Zobacz Wysyłanie wielu poleceń jednocześnie.
Znane problemy
- Podczas wczytywania, tworzenia i edytowania automatyzacji użytkownicy mogą doświadczać długiego czasu oczekiwania.
- Użytkownicy, którzy rozpoczną proces konfiguracji w aplikacji Aparat, muszą dwukrotnie zeskanować kod QR, aby dokończyć wdrożenie Matter.
- W strukturze zawierającej ponad 200 urządzeń interfejs Discovery API może po prostu nie zwracać żadnych kandydatów.
Rozwiązane znane problemy
- Przełączenie 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 cechy
MediaPlayback. - W strukturze, która zawiera tylko hub Google:
- Urządzenia Matter mogą być wyświetlane jako offline w aplikacji Google Home.
- Asystent Google nie może sterować urządzeniami Matter.
- Inteligentne wyświetlacze 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 aplikacja może zgłaszać stan inny niż ten zgłaszany przez aplikację Google, np. Google Home. Zwykle dzieje się tak, ponieważ urządzenia nie zgłaszają stanu do Google.
- Obejście: sprawdzenie stanu w aplikacji Google rozwiązuje problem z niezgodnością.
2025-01-14
Zaktualizowane wskazówki dotyczące inicjowania interfejsów Home API.
Wyjaśniliśmy, że instancja Home powinna być inicjowana jako pojedynczy obiekt kontekstu. Zapewnia to większą wygodę użytkownikom aplikacji i zapobiega błędom związanym z nieprawidłowymi sesjami.
2025-01-07
Wersja beta interfejsów Home APIPodczas publicznej wersji beta dla deweloperów wszyscy deweloperzy mogą zacząć tworzyć i testować aplikacje.
Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na Androida, w tym lepszą obsługę urządzeń Google Nest Audio i Google TV.
Wersje minimalne
- Minimalna wersja Usług Google Play: 24.45.34
- Minimalne wersje oprogramowania hubów Google:
- Wersja Cast: 3.74.444798
- Minimalna wersja Fuksji: 22.20240805.103.161
- Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
- Minimalna wersja aplikacji Google Home: działa z dowolną wersją
androidx.coreminimalna wersja biblioteki: 1.10.0- Wersja Matter:1.3.0.0
- Uwaga: tymczasowe typy urządzeń i klastry Matter nie są obsługiwane.
Znane problemy
- Przełączenie zalogowanego konta Google może się nie udać i spowodować błąd.
- Obejście: ponownie uruchom proces przyznawania uprawnień lub ponownie uruchom aplikację.
- Urządzenia Google TV mogą nie działać w przypadku automatyzacji, które korzystają z cechy
MediaPlayback. - W strukturze, która zawiera tylko hub Google:
- Urządzenia Matter mogą być wyświetlane jako offline w aplikacji Google Home (GHA).
- Asystent Google nie może sterować urządzeniami Matter.
- Inteligentne wyświetlacze 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łaszany przez aplikację Google, np. Google Home (GHA). Zwykle dzieje się tak, gdy urządzenia nie przesyłają informacji o stanie do Google.
- Obejście: sprawdzenie stanu w aplikacji Google rozwiązuje problem z niezgodnością.
Rozwiązane znane problemy
- Jeśli podczas procesu aplikacja zostanie zminimalizowana, konfiguracja może się nie udać.
- Obejście: użyj
suppressHalfSheetNotification()API, aby wyłączyć powiadomienia o półarkuszach, gdy w aplikacji używany jest interfejs Commissioning API.
- Obejście: użyj
- Problem po stronie serwera może uniemożliwiać działanie poleceń „Ok Google” w automatyzacjach.
- Jeśli używasz huba z Fuchsią, który nie ma w strukturze żadnych urządzeń Matter, a hub jest nieużywany przez ponad 3 godziny, włączenie pierwszego urządzenia Matter spowoduje, że będzie ono offline.
- Po przywróceniu danych fabrycznych huba polecenia do nowo skonfigurowanych urządzeń mogą nie działać, mimo że urządzenie jest zgłaszane jako online.