Informacje o wersji pakietu SDK interfejsu Home API na iOS

2026-04-09

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

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

Wersje minimalne

  • Minimalne wersje oprogramowania hubów Google:
    • Przesyłaj:
      • Nest Wifi Pro: 3.78.518349
      • Wszystkie pozostałe urządzenia Cast: 3.78.526062
    • Fuchsia: 29.20251023.103.2101601
    • 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 każdą wersją
  • Wersja Matter:1.4.1.0 z eksperymentalną obsługą 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 w wersji mobilnej górna ikona i przycisk Wstecz są zasłonięte przez nagłówek. Użytkownicy mogą nie mieć możliwości powrotu ani wyświetlania 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 ulepszenia jakości wersji beta pakietu SDK 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
  • Minimalne wersje oprogramowania hubów Google:
    • Przesyłaj:
      • Nest Wifi Pro: 3.78.518349
      • Wszystkie inne urządzenia Cast: 3.78.516526
    • Fuchsia: 29.20251023.103.2201
    • 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 z eksperymentalną obsługą wersji 1.5.0.

Nowe funkcje

Inne ważne zmiany

  • Uproszczony proces uzyskiwania zgody na subskrypcje.
  • Home APIs iOS Sample App w wersji 1.7.1. Szczegółowe informacje znajdziesz w wersji na GitHubie.

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 Indoor/Outdoor (zasilanych baterią lub przewodowo) i dzwonków Nest Doorbell (na baterie, 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 mobilnej wersji przeglądarkowej Google Home górna ikona i przycisk Wstecz są zasłonięte przez nagłówek. Użytkownicy mogą nie mieć możliwości powrotu ani wyświetlania 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 1.7 interfejsów Home API.

Pełne informacje o wersji znajdziesz w wersji na GitHubie.

2026-02-09

  Home APIs Public Beta w wersji 1.7  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu SDK 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
  • 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
  • Pakiet SDK na iOS: home_platform_ios_1.7.0
  • Minimalna wersja aplikacji Google Home: 1.7
  • Wersja Matter:1.4.1.0 z eksperymentalną obsługą wersji 1.5.0.

Nowe funkcje

Inne ważne zmiany

Rozwiązane znane problemy

  • Interfejs History API zawsze zwraca wartość 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 wewnętrznych / zewnętrznych Nest Cam (zasilanych baterią lub przewodowo) i dzwonków Nest Doorbell (na baterie, 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ć wyświetlana 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.
  • Ś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 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 ulepszenia jakości wersji beta pakietu SDK 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
  • 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
  • iOS SDK: home_platform_ios_1.6.0
  • Minimalna wersja aplikacji Google Home: 1.6
  • Wersja Matter:1.4.1.0

Nowe funkcje

  • Automation API
    • Dodaliśmy obsługę filtrów encji, które umożliwiają automatyzacjom dynamiczne wybieranie urządzeń na podstawie kryteriów określonych w automatyzacji.
    • Dodaliśmy obsługę cechy Pogoda w poleceniach inicjujących i warunkach automatyzacji. Zobacz Starter na podstawie pogody.
  • Device API
    • Obsługa większej liczby funkcji kamer i dzwonków
      • 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 kamerą na iOS.

  • Structure API
  • Przykładowa aplikacja na iOS
    • Obsługa większej liczby ustawień
      • Aparat:
        • Włączanie i wyłączanie mikrofonu.
        • Włączanie i wyłączanie nagrywania dźwięku.
        • Orientacja obrazu.
        • Włączanie i wyłączanie noktowizora.
        • Głośność głośnika kamery.
        • Jasność diody stanu.
      • Dzwonek:
        • Włączanie i wyłączanie mikrofonu.
        • Włączanie i wyłączanie nagrywania dźwięku.
        • Orientacja obrazu.
        • Włączanie i wyłączanie noktowizora.
        • Głośność głośnika kamery.
        • Jasność diody stanu.
        • Dźwięki dzwonka.
    • Domyślnie integruje pakiet SDK za pomocą menedżera pakietów Swift.

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.
  • 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 ulepszenia jakości wersji beta pakietu SDK 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
  • Minimalne wersje oprogramowania hubów Google:
    • Wersja Cast: 3.76.495998
    • Minimalna wersja Fuchsi: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.1.zip
  • Minimalna wersja aplikacji Google Home: działa z każdą wersją
  • Wersja Matter:1.4.1.0

Nowe funkcje

  • Structure API
    • Interfejs Hub Activation API umożliwia automatyczne wykrywanie i aktywowanie urządzenia Google Home. Zobacz interfejs API aktywacji huba na iOS.

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

Rozwiązane znane problemy

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

26.09.2025 r.

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

Ta wersja wprowadza obsługę urządzeń z kamerą, 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
  • Minimalne wersje oprogramowania hubów Google:
    • Wersja Cast: 3.76.495998
    • Minimalna wersja Fuchsi: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.0.zip
  • Minimalna wersja aplikacji Google Home: działa z każdą wersją
  • Wersja Matter:1.4.1.0

Nowe funkcje

  • Device API
    • Dodanotyp urządzenia z kamerą. Dostępne są też te funkcje kamer:
      • Transmisja na żywo z kamery
      • Rozmowa dwukierunkowa przez kamerę
      • Rozpoczynanie i zatrzymywanie nagrywania kamerą
  • Przykładowa aplikacja na iOS
    • 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ń.
    • Obsługa aktywacji Hub.

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

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.

2025-08-28

  Home APIs Public Beta w wersji 1.4.1  

Ta wersja zawiera poprawki błędów i ulepszenia jakości wersji beta pakietu SDK 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
  • Minimalne wersje oprogramowania hubów Google:
    • Wersja Cast: 3.76.495998
    • Minimalna wersja Fuchsi: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.4.1.zip
  • Minimalna wersja aplikacji Google Home: działa z każdą wersją
  • Wersja Matter:1.4.1.0

Nowe funkcje

Przykładowa aplikacja na iOS

  • Dodano sterowanie termostatem.

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ł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 ulepszenia jakości wersji beta pakietu SDK Home API na iOS.

Wersje minimalne

Nowe funkcje

Przykładowa aplikacja na iOS

  • Usuń urządzenia obsługujące tylko Matter.

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ł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-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.2  

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

Wersje minimalne

  • 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
  • Pakiet SDK na iOS: home_platform_ios_1.3.2.zip
  • Minimalna wersja aplikacji Google Home: działa z każdą wersją
  • Wersja Matter:1.4.0.0

Nowe funkcje

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

Rozwiązane znane problemy

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

5.06.2025 r.

  Home APIs Public Beta w wersji 1.3.1  

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

Wersje minimalne

  • Wartość jest zaokrąglana do 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.3.0.zip
  • Minimalna wersja aplikacji Google Home: działa z każdą wersją
  • Wersja Matter:1.4.0.0

Nowe funkcje

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

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.

2025-05-09

  Home APIs Public Beta w wersji 1.3  

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

Wersje minimalne

  • Wartość jest zaokrąglana do 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.3.0.zip
  • Minimalna wersja aplikacji Google Home: działa z każdą wersją
  • Wersja Matter:1.4.0.0

Nowe funkcje

  • Device API
    • Pomoc dotycząca zmiany HomeDevice imienia i nazwiska
  • Structure API
    • Pomoc dotycząca zmiany nazwy Room

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

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.

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

  • Wartość jest zaokrąglana do 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ądzeniem.
  • 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 zmiana nazw urządzeń nie są 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 rokiem. Problem ten nie dotyczy struktur utworzonych po 2023 r.