Informacje o wersji pakietu SDK interfejsu Home API na iOS

2026-05-06

Aplikacja próbna Home API na iOS została zaktualizowana do wersji 1.8.1.

Przykładowa aplikacja

2026-05-01

  Home APIs Public Beta w wersji 1.8.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

Nowe funkcje

Rozwiązane znane problemy

  • Gdy aplikacja przykładowa jest przenoszona na pierwszy plan i do tła, transmisja na żywo zostaje przerwana.
  • Aplikacja Google Home może ulec awarii, jeśli użytkownik cofnie uprawnienia na stronie Moje konto. Aby obejść ten problem, uruchom ponownie aplikację.
  • Urządzenie Philips BLE nie wyświetla prawidłowego stanu.

Znane problemy

  • Nie można uruchomić niektórych urządzeń za pomocą streamera Google TV 4K.
  • W przypadku niektórych dzwonków do drzwi pole adresu IP nie jest wypełnione.
  • Jeśli hubem jest Nest Wifi Pro, Google Nest Hub lub Google Nest Hub Max, aplikacja Google Home wyświetla urządzenia wieloczęściowe jako kilka kafelków.

2026-04-10

Aplikacja próbna Home API na iOS została zaktualizowana do wersji 1.8 interfejsów Home API.

Przykładowa aplikacja

2026-04-09

  Wersja 1.8 interfejsów Home API w ramach publicznej wersji beta  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

  • Oprogramowanie Google Hub, Cast, Nest Wifi Pro: 3.78.518349
  • Oprogramowanie Google Hub, Cast, wszystkie inne huby oparte na Cast: 3.78.526062
  • Oprogramowanie huba Google, Fuchsia: 29.20251023.103.2101601
  • Oprogramowanie Google Hub, streamer Google TV, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.8.0_0
  • Aplikacja Google Home: działa z każdą wersją
  • androidx.core biblioteka: działa z dowolną wersją;
  • Wersja Matter: 1.4.1.0
  • Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

Rozwiązane znane problemy

  • Proces konfiguracji kamery Nest Cam Outdoor (zasilanej z sieci, 2 generacji) może się nie powieść. Jego kafel pozostaje wyszarzony, pojawiają się komunikaty o błędach i nie można sterować kamerą.
  • Nie można zmienić jednostek temperatury (C/F) na termostacie Google Nest Learning Thermostat (4 gen.) w wersji 4.
  • W przeglądarkowej wersji Google Home górna ikona i przycisk Wstecz są zasłonięte przez nagłówek. Użytkownicy mogą nie mieć możliwości powrotu lub wyświetlenia kluczowych elementów interfejsu.
  • Po przełączeniu użytkowników na tym samym kontrolerze kafelki urządzeń GHA przechodzą w tryb offline. W gospodarstwach domowych, w których wielu użytkowników korzysta z tego samego kontrolera, urządzenia mogą być niedostępne w trybie offline, dopóki aplikacja nie zostanie ponownie uruchomiona.

Znane problemy

  • Wprowadzanie urządzeń Matter do eksploatacji może się nie udać.

2026-03-13

  Home APIs Public Beta w wersji 1.7.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

  • iOS: iOS 17.0 lub nowszy, Xcode 15.3 lub nowszy
  • W przypadku uruchamiania urządzeń Matter: iOS 17.6 lub nowszy
  • Oprogramowanie Google Hub, Cast, Nest Wifi Pro: 3.78.518349
  • Oprogramowanie huba Google, Cast, wszystkie inne huby oparte na Cast: 3.78.516526
  • Oprogramowanie układowe hubów Google, Fuchsia: 29.20251023.103.2201
  • Oprogramowanie sprzętowe hubu Google, streamer Google TV, 4K: UTTK.260120.001
  • iOS SDK: home_platform_ios_1.7.1
  • Minimalna wersja aplikacji Google Home: 1.7.1
  • Wersja Matter: 1.4.1.0
  • Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

Inne ważne zmiany

  • Uproszczony proces uzyskiwania zgody na subskrypcje.

Przykładowa aplikacja

Rozwiązane znane problemy

  • Filtrowanie historii nie wyświetla wszystkich oczekiwanych zdarzeń z danego dnia i urządzenia podczas początkowego wczytywania. Obejście: wyczyść wszystkie filtry, aby wyświetlić wszystkie wydarzenia.
  • W przypadku kamer Nest Cam wewnętrznych/zewnętrznych (zasilanych baterią lub przewodowo) i dzwonków Nest Doorbell (zasilanych baterią, 2 generacji) opcja „Pozostały czas pracy na baterii” nie jest dostępna w ustawieniach baterii.

Znane problemy

  • Proces konfiguracji kamery Nest Cam Outdoor (zasilanej z sieci, 2 generacji) może się nie powieść. Jego kafel pozostaje wyszarzony, pojawiają się komunikaty o błędach i nie można sterować kamerą.
  • Nie można zmienić jednostek temperatury (C/F) na termostacie Google Nest Learning Thermostat (4 gen.) w wersji 4.
  • W przeglądarkowej wersji Google Home górna ikona i przycisk Wstecz są zasłonięte przez nagłówek. Użytkownicy mogą nie mieć możliwości powrotu lub wyświetlenia kluczowych elementów interfejsu.
  • Po przełączeniu użytkowników na tym samym kontrolerze kafelki urządzeń GHA przechodzą w tryb offline. W gospodarstwach domowych, w których wielu użytkowników korzysta z tego samego kontrolera, urządzenia mogą być niedostępne w trybie offline, dopóki aplikacja nie zostanie ponownie uruchomiona.
  • Wprowadzanie urządzeń Matter do eksploatacji może się nie udać.

2026-02-13

Aplikacja próbna Home API na iOS została zaktualizowana do wersji Home API 1.7.

Przykładowa aplikacja

2026-02-09

  Home APIs Public Beta w wersji 1.7  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

  • iOS: iOS 17.0 lub nowszy, Xcode 15.3 lub nowszy
  • W przypadku uruchamiania urządzeń Matter: iOS 17.6 lub nowszy
  • Oprogramowanie Google Hub, Cast, Nest Wifi Pro: 3.76.508025
  • Oprogramowanie Google Hub, Cast, wszystkie inne urządzenia Cast: 3.77.510748
  • Oprogramowanie układowe hubów Google, Fuchsia: 29.20251023.103.2100
  • Oprogramowanie Google Hub, streamer Google TV, 4K: UTTK.250729.004
  • Pakiet SDK na iOS: home_platform_ios_1.7.0
  • Minimalna wersja aplikacji Google Home: 1.7
  • Wersja Matter: 1.4.1.0
  • Wersja Matter: eksperymentalna obsługa wersji 1.5.0

Nowe funkcje

Inne ważne zmiany

Rozwiązane znane problemy

  • Interfejs History API zawsze zwraca nextPageToken, co powoduje nieskończoną pętlę.
  • Błąd „stream disconnected” (strumień odłączony) może przerywać długotrwałe sesje transmisji z kamery.
  • Konfiguracja urządzenia Matter nie powiodła się podczas wykonywania polecenia CommissionDeviceCommand.

Znane problemy

  • Filtrowanie historii nie wyświetla wszystkich oczekiwanych zdarzeń z danego dnia i urządzenia podczas początkowego wczytywania. Obejście: wyczyść wszystkie filtry, aby wyświetlić wszystkie wydarzenia.
  • W przypadku kamer Nest Cam wewnętrznych / zewnętrznych (zasilanych baterią lub przewodowo) i dzwonków Nest Doorbell (zasilanych baterią, 2 generacji) opcja „Pozostały czas pracy na baterii” nie jest dostępna w ustawieniach baterii.
  • W przypadku bieżącej wersji oprogramowania kamery może nie być widoczna prawidłowa wersja oprogramowania.
  • Ustawienie czasu trwania dzwonka jest ignorowane.
  • Wyłączenie kamery Nest Doorbell (na baterie, 2 generacji) powoduje zamrożenie ekranu.
  • W ustawieniach kamery Nest Cam IQ powinny być widoczne tylko 3 motywy dzwonka, ale pojawia się ich znacznie więcej.
  • Lampa Philips BLE jest nieprawidłowo wyświetlana jako „Online”, nawet gdy urządzenie jest w rzeczywistości offline. Obejście: nie polegaj wyłącznie na stanie online typu inteligentnego urządzenia domowego (SHDT). Zamiast tego używaj mapy usługi stanu urządzenia docelowego (TDSS) w przypadku urządzeń ze źródłem LOCAL_SYNC.

2025-12-22

  Home APIs Public Beta w wersji 1.6  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

  • iOS: iOS 17.0 lub nowszy, Xcode 15.3 lub nowszy
  • W przypadku uruchamiania urządzeń Matter: iOS 17.6 lub nowszy
  • Oprogramowanie Google Hub, Cast, Nest Wifi Pro: 3.75.479819
  • Oprogramowanie Google Hub, Cast, wszystkie pozostałe huby oparte na Cast: 3.77.505721
  • Oprogramowanie układowe hubów Google, Fuchsia: 28.20250723.103.2100300
  • Oprogramowanie Google Hub, streamer Google TV, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.6.0
  • Minimalna wersja aplikacji Google Home: 1.6
  • Wersja Matter: 1.4.1.0

Nowe funkcje

Inne ważne zmiany

  • Przykładowa aplikacja na iOS dodaje więcej ustawień kamery i dzwonka, a także domyślnie integruje pakiet SDK za pomocą Swift Package Manager.

Rozwiązane znane problemy

  • Podczas przełączania z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Sterowanie typami urządzeń Fan obsługiwanymi przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.

2025-10-22

  Home APIs Public Beta w wersji 1.5.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

  • iOS: iOS 17.0 lub nowszy, Xcode 15.3 lub nowszy
  • W przypadku uruchamiania urządzeń Matter: iOS 17.6 lub nowszy
  • Oprogramowanie huba Google, Cast: 3.76.495998
  • Oprogramowanie układowe hubów Google, Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.1.zip
  • Minimalna wersja aplikacji Google Home: działa z dowolną wersją
  • Wersja Matter: 1.4.1.0

Nowe funkcje

Rozwiązane znane problemy

  • Podczas korzystania z aplikacji przykładowej transmisja na żywo nieoczekiwanie się zamykała.

Znane problemy

  • Podczas przełączania z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Sterowanie typami urządzeń Fan obsługiwanymi przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.
  • Podczas uruchamiania urządzenia Matter-over-Thread za pomocą interfejsu iOS Home API występuje błąd. Obejście: dodaj router graniczny Thread za pomocą aplikacji Google Home na iOS na tym samym telefonie.

26.09.2025 r.

  Wersja 1.5.0 interfejsów Home API w ramach otwartych testów beta  

Wprowadziliśmy w niej obsługę urządzeń z kamerą, poprawki błędów i ulepszenia jakości wersji beta pakietu Home API SDK na iOS.

Wersje minimalne

  • iOS: iOS 17.0 lub nowszy, Xcode 15.3 lub nowszy
  • W przypadku uruchamiania urządzeń Matter: iOS 17.6 lub nowszy
  • Oprogramowanie huba Google, Cast: 3.76.495998
  • Oprogramowanie układowe hubów Google, Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.0.zip
  • Minimalna wersja aplikacji Google Home: działa z dowolną wersją
  • Wersja Matter: 1.4.1.0

Nowe funkcje

Inne ważne zmiany

  • Przykładowa aplikacja na iOS obsługuje teraz typ urządzenia Camera i aktywację Hub.

Rozwiązane znane problemy

  • Podczas tworzenia automatyzacji występuje błąd, a nieokreślone urządzenie jest nieprawidłowo wyświetlane jako opcja do wyboru.

Znane problemy

  • Podczas przełączania z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Sterowanie typami urządzeń Fan obsługiwanymi przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.
  • Podczas uruchamiania urządzenia Matter-over-Thread za pomocą interfejsu iOS Home API występuje błąd. Obejście: dodaj router graniczny Thread za pomocą aplikacji Google Home na iOS na tym samym telefonie.

2025-08-28

  Home APIs Public Beta w wersji 1.4.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

  • iOS: iOS 17.0 lub nowszy, Xcode 15.3 lub nowszy
  • W przypadku uruchamiania urządzeń Matter: iOS 17.6 lub nowszy
  • Oprogramowanie huba Google, Cast: 3.76.495998
  • Oprogramowanie układowe hubów Google, Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.4.1.zip
  • Minimalna wersja aplikacji Google Home: działa z dowolną wersją
  • Wersja Matter: 1.4.1.0

Nowe funkcje

Inne ważne zmiany

  • Przykładowa aplikacja na iOS z dodatkową funkcją sterowania termostatem.

Znane problemy

  • Podczas przełączania z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Sterowanie typami urządzeń Fan obsługiwanymi przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.
  • Podczas uruchamiania urządzenia Matter-over-Thread za pomocą interfejsu iOS Home API występuje błąd. Obejście: dodaj router graniczny Thread za pomocą aplikacji Google Home na iOS na tym samym telefonie.

2025-07-30

  Wersja 1.4.0 interfejsów Home API w ramach publicznej wersji beta  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

  • iOS: iOS 17.0 lub nowszy, Xcode 15.3 lub nowszy
  • W przypadku uruchamiania urządzeń Matter: iOS 17.6 lub nowszy
  • Oprogramowanie huba Google, Cast: 3.75.456944
  • Oprogramowanie huba Google, Fuchsia: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.4.0.zip
  • Minimalna wersja aplikacji Google Home: działa z dowolną wersją
  • Wersja Matter: 1.4.0.0

Nowe funkcje

Inne ważne zmiany

  • Przykładowa aplikacja na iOS traci możliwość usuwania urządzeń obsługujących tylko Matter.

Znane problemy

  • Podczas przełączania z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Sterowanie typami urządzeń Fan obsługiwanymi przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.
  • Podczas uruchamiania urządzenia Matter-over-Thread za pomocą interfejsu iOS Home API występuje błąd. Obejście: dodaj router graniczny Thread za pomocą aplikacji Google Home na iOS na tym samym telefonie.

26.06.2025 r.

  Interfejsy Home API w wersji beta 1.3.2  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

  • iOS: iOS 16.4 lub nowszy, Xcode 15.3 lub nowszy
  • Oprogramowanie huba Google, Cast: 3.75.456944
  • Oprogramowanie huba Google, Fuchsia: 24.20241009.103.1900601
  • Pakiet SDK na iOS: home_platform_ios_1.3.2.zip
  • Minimalna wersja aplikacji Google Home: działa z dowolną wersją
  • Wersja Matter: 1.4.0.0

Nowe funkcje

Rozwiązane znane problemy

  • Termostaty obsługiwane przez połączenie Cloud-to-Cloud mogą nie działać.

Znane problemy

  • Podczas przełączania z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Sterowanie typami urządzeń Fan obsługiwanymi przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.
  • Podczas uruchamiania urządzenia Matter-over-Thread za pomocą interfejsu iOS Home API występuje błąd. Obejście: dodaj router graniczny Thread za pomocą aplikacji Google Home na iOS na tym samym telefonie.

5.06.2025 r.

  Home APIs Public Beta w wersji 1.3.1  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

Inne ważne zmiany

Rozwiązane znane problemy

  • Wersja GHA na iOS może ulec awarii podczas zmiany sieci z lokalnej na Wi-Fi lub przełączania się między aplikacjami.

Znane problemy

  • Podczas przełączania z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Termostaty obsługiwane przez połączenie Cloud-to-Cloud mogą nie działać.
  • Sterowanie typami urządzeń Fan obsługiwanymi przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.
  • Podczas uruchamiania urządzenia Matter-over-Thread za pomocą interfejsu iOS Home API występuje błąd. Obejście: dodaj router graniczny Thread za pomocą aplikacji Google Home na iOS na tym samym telefonie.

2025-05-09

  Home APIs Public Beta w wersji 1.3  

Ta wersja zawiera poprawki błędów i poprawia jakość wersji beta pakietu SDK interfejsów Home API na iOS.

Wersje minimalne

Nowe funkcje

Rozwiązane znane problemy

  • Podczas przyznawania uprawnień w wersji aplikacji Google Home na iOS przyciski Więcej informacji i Wstecz mogą nie reagować. Obejście: przytrzymaj link Więcej informacji, aby otworzyć go w przeglądarce systemowej, lub kliknij przycisk zamykania w lewym górnym rogu, aby zamknąć widok.
  • Podstawowy odtwarzacz wideo może nie działać w aplikacji przykładowej.
  • Sterowanie urządzeniami typu Window Covering obsługiwanymi przez Cloud-to-Cloud może nie działać.
  • Cofnięcie uprawnień podczas otwartej aplikacji Google Home spowoduje jej zamknięcie.

Znane problemy

  • Podczas przełączania z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Termostaty obsługiwane przez połączenie Cloud-to-Cloud mogą nie działać.
  • Sterowanie typami urządzeń Fan obsługiwanymi przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.
  • Wersja GHA na iOS może ulec awarii podczas zmiany sieci z lokalnej na Wi-Fi lub przełączania się między aplikacjami.

2025-04-09

  Publiczna wersja beta interfejsów API Home na iOS  

Podczas publicznej wersji beta dla deweloperów wszyscy deweloperzy mogą zacząć tworzyć i testować aplikacje na iOS.

Ta wersja zawiera poprawki błędów i poprawia jakość ogólnej dostępności pakietu SDK Home API na iOS.

Wersje minimalne

  • Podsumowuje connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS: iOS 16.4 lub nowszy, Xcode 15.3 lub nowszy
  • Minimalne wersje oprogramowania hubów Google:
    • Wersja Cast: 3.75.456944
    • Minimalna wersja Fuksji: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.0_1.zip
  • Minimalna wersja aplikacji Google Home: działa z każdą wersją
  • Wersja Matter:1.4.0.0
    • Uwaga: tymczasowe typy urządzeń i klastry standardu Matter nie są obsługiwane.

Znane problemy

  • Podczas przełączania się z Wi-Fi na sieć komórkową może wystąpić większe opóźnienie w sterowaniu urządzeniami.
  • Podczas przyznawania uprawnień w wersji aplikacji Google Home na iOS przyciski Więcej informacji i Wstecz mogą nie reagować.
    • Obejście: przytrzymaj link Więcej informacji, aby otworzyć go w przeglądarce systemowej, lub kliknij przycisk zamykania w lewym górnym rogu, aby zamknąć widok.
  • Cofnięcie uprawnień podczas otwartej aplikacji Google Home spowoduje jej zamknięcie.
  • Podstawowy odtwarzacz wideo może nie działać w aplikacji przykładowej.
  • Termostaty obsługiwane przez połączenie Cloud-to-Cloud mogą nie działać.
  • Sterowanie typami urządzeń Fan obsługiwanymi przez Cloud-to-Cloud może nie działać w przykładowej aplikacji.
  • Sterowanie urządzeniami typu Window Covering obsługiwanymi przez Cloud-to-Cloud może nie działać.
  • Wersja GHA na iOS może ulec awarii podczas zmiany sieci z lokalnej na Wi-Fi lub przełączania się między aplikacjami.

Rozwiązane znane problemy

  • Nadawanie i zmienianie nazw urządzeń nie jest obsługiwane.
  • W przypadku uruchamiania pierwsze urządzenie Matter w strukturze musi zostać uruchomione za pomocą aplikacji Google Home na iOS. Interfejsy Home API nie mogą obecnie tworzyć nowej struktury, a jedynie dodawać urządzenia do istniejącej struktury utworzonej przed 2023 r. Problem ten nie dotyczy struktur utworzonych po 2023 r.