Home APIs iOS SDK 版本資訊

2025-12-22

  Home API 公開 Beta 版 1.6  

這個版本修正了錯誤，並提升了 Home API iOS SDK 的 Beta 版品質。

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
    • Matter 委派：iOS 17.6 以上版本
  • Google 中樞裝置的最低韌體版本：
    • 投放：
      • Nest Wifi Pro：3.75.479819
      • 所有其他支援 Google Cast 的中樞裝置：3.77.505721
    • Fuchsia：28.20250723.103.2100300
    • Google TV Streamer (4K)：UTTK.250729.004
  • iOS SDK：home_platform_ios_1.6.0
  • Google Home 應用程式最低版本：1.6
  • Matter 版本： 1.4.1.0

新功能

  • Automation API
    • 新增 實體篩選器支援功能，可讓自動化程序根據自動化程序中指定的條件，動態選取裝置。
    • 自動化動作啟動條件和限制條件新增支援「天氣」特徵。請參閱根據天氣啟動。
  • Device API
    • 支援更多攝影機和門鈴裝置功能
      • 新設定：
        • 開啟/關閉夜視模式。
        • 狀態 LED 亮度。
        • 攝影機可視區域。
        • 圖片方向。
        • 喚醒靈敏度。
        • 事件錄影時間上限。
        • 鈴聲。

        詳情請參閱 iOS 攝影機裝置指南。

  • Structure API
  • iOS 範例應用程式
    • 支援更多設定
      • 相機：
        • 開啟/關閉麥克風。
        • 開啟/關閉錄音功能。
        • 圖片方向。
        • 開啟/關閉夜視模式。
        • 攝影機喇叭音量。
        • 狀態 LED 亮度。
      • 門鈴：
        • 開啟/關閉麥克風。
        • 開啟/關閉錄音功能。
        • 圖片方向。
        • 開啟/關閉夜視模式。
        • 攝影機喇叭音量。
        • 狀態 LED 亮度。
        • 鈴聲。
    • 預設使用 Swift Package Manager 整合 SDK。

已修正的已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 透過 Cloud-to-Cloud 支援的風扇裝置類型可能無法在範例應用程式中控制。

2025-10-22

  Home API 公開 Beta 版 1.5.1 發布  

這個版本修正了錯誤，並提升了 Home API iOS SDK 的 Beta 版品質。

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
    • Matter 委派：iOS 17.6 以上版本
  • Google Hub 韌體最低版本：
    • Cast 版本：3.76.495998
    • Fuchsia 最低版本：27.20250422.103.3600
  • iOS SDK：home_platform_ios_1.5.1.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本： 1.4.1.0

新功能

  • Structure API
    • 透過中樞裝置啟用 API，以程式輔助方式探索及啟用 Google Home 中樞裝置。請參閱「iOS 上的中樞啟用 API」。

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 透過 Cloud-to-Cloud 支援的風扇裝置類型可能無法在範例應用程式中控制。
  • 使用 iOS Home API 委派 Matter over Thread 裝置時發生錯誤。
    • 解決方法：在同一部手機上，透過 iOS Google Home 應用程式新增 Thread 邊界路由器。

已修正的已知問題

  • 使用範例應用程式時，直播會無預警當機。

2025-09-26

  Home API 公開 Beta 版 1.5.0  

這個版本支援攝影機裝置、修正錯誤，並提升 Home API iOS SDK 的 Beta 版品質。

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
    • Matter 委派：iOS 17.6 以上版本
  • Google Hub 韌體最低版本：
    • Cast 版本：3.76.495998
    • Fuchsia 最低版本：27.20250422.103.3600
  • iOS SDK：home_platform_ios_1.5.0.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本： 1.4.1.0

新功能

  • Device API
    • 已新增 攝影機裝置類型。門鈴也提供下列攝影機功能：
      • 攝影機直播
      • 攝影機對講
      • 攝影機開始和停止錄影
  • iOS 範例應用程式
    • 支援攝影機裝置類型：
      • 攝影機直播。
      • 攝影機對講。
      • 攝影機開始和停止錄影。
      • 受限制的裝置類型權限。
    • 支援啟用 Hub。

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 透過 Cloud-to-Cloud 支援的風扇裝置類型可能無法在範例應用程式中控制。
  • 使用 iOS Home API 委派 Matter over Thread 裝置時發生錯誤。
    • 解決方法：在同一部手機上，透過 iOS Google Home 應用程式新增 Thread 邊界路由器。

已修正的已知問題

  • 建立自動化動作時發生錯誤，且不明裝置類型錯誤地顯示為可選選項。

2025-08-28

  Home API 公開 Beta 版 1.4.1  

這個版本修正了錯誤，並提升了 Home API iOS SDK 的 Beta 版品質。

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
    • Matter 委派：iOS 17.6 以上版本
  • Google Hub 韌體最低版本：
    • Cast 版本：3.76.495998
    • Fuchsia 最低版本：27.20250422.103.3600
  • iOS SDK：home_platform_ios_1.4.1.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本： 1.4.1.0

新功能

iOS 範例應用程式

  • 新增溫度控制器。

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 範例應用程式可能無法控制 Cloud-to-Cloud 支援的風扇裝置類型。
  • 使用 iOS Home API 委派 Matter over Thread 裝置時發生錯誤。
    • 解決方法：在同一部手機上，透過 iOS Google Home 應用程式新增 Thread 邊界路由器。

2025-07-30

  Home API 公開 Beta 版 1.4.0  

這個版本修正了錯誤，並提升了 Home API iOS SDK 的 Beta 版品質。

最低版本

新功能

  • Device API
    • 以程式輔助方式移除 Matter 裝置。請參閱「移除裝置」一文。

iOS 範例應用程式

  • 刪除僅支援 Matter 的裝置。

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 範例應用程式可能無法控制 Cloud-to-Cloud 支援的風扇裝置類型。
  • 使用 iOS Home API 委派 Matter over Thread 裝置時發生錯誤。
    • 解決方法：在同一部手機上，透過 iOS Google Home 應用程式新增 Thread 邊界路由器。

2025-07-08

在 Cast 韌體版本 3.76.479819 中，Nest Wifi Pro 現在可以做為 Home API 中樞裝置。

2025-06-26

  Home API 公開 Beta 版 1.3.2  

這個版本修正了錯誤，並提升了 Home API iOS SDK 的 Beta 版品質。

最低版本

  • iOS：iOS 16.4 以上版本、Xcode 15.3 以上版本
  • Google Hub 韌體最低版本：
    • Cast 版本：3.75.456944
    • Fuchsia 最低版本：24.20241009.103.1900601
  • iOS SDK：home_platform_ios_1.3.2.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本： 1.4.0.0

新功能

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 範例應用程式可能無法控制 Cloud-to-Cloud 支援的風扇裝置類型。
  • 使用 iOS Home API 委派 Matter over Thread 裝置時發生錯誤。
    • 解決方法：在同一部手機上，透過 iOS Google Home 應用程式新增 Thread 邊界路由器。

已修正的已知問題

  • 透過 Cloud-to-Cloud 支援的溫度控制器可能無法運作。

2025-06-05

  Home API 公開 Beta 版 1.3.1  

這個版本修正了錯誤，並提升了 Home API iOS SDK 的 Beta 版品質。

最低版本

  • 彙整至 connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS：iOS 16.4 以上版本、Xcode 15.3 以上版本
  • Google Hub 韌體最低版本：
    • Cast 版本：3.75.456944
    • Fuchsia 最低版本：24.20241009.103.1900601
  • iOS SDK：home_platform_ios_1.3.0.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本： 1.4.0.0

新功能

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 透過 Cloud-to-Cloud 支援的溫度控制器可能無法運作。
  • 範例應用程式可能無法控制 Cloud-to-Cloud 支援的風扇裝置類型。
  • 使用 iOS Home API 委派 Matter over Thread 裝置時發生錯誤。
    • 解決方法：在同一部手機上，透過 iOS Google Home 應用程式新增 Thread 邊界路由器。

已修正的已知問題

  • 從本機變更為 Wi-Fi 網路，或在應用程式之間切換時，iOS 版 Google Home 應用程式可能會當機。

2025-05-09

  Home API 公開 Beta 版 1.3 發布  

這個版本修正了錯誤，並提升了 Home API iOS SDK 的 Beta 版品質。

最低版本

  • 彙整至 connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS：iOS 16.4 以上版本、Xcode 15.3 以上版本
  • Google Hub 韌體最低版本：
    • Cast 版本：3.75.456944
    • Fuchsia 最低版本：24.20241009.103.1900601
  • iOS SDK：home_platform_ios_1.3.0.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本： 1.4.0.0

新功能

  • Device API
  • Structure API
    • 支援變更 Room名稱

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 透過 Cloud-to-Cloud 支援的溫度控制器可能無法運作。
  • 範例應用程式可能無法控制 Cloud-to-Cloud 支援的風扇裝置類型。
  • 從本機變更為 Wi-Fi 網路，或在應用程式之間切換時，iOS 版 Google Home 應用程式可能會當機。

已修正的已知問題

  • 在 iOS 版 Google Home 應用程式中授予權限時，「瞭解詳情」和返回按鈕可能無法回應。
    • 解決方法：長按「瞭解詳情」連結，在系統瀏覽器中開啟，或輕觸左上角的關閉按鈕退出檢視畫面。
  • 基本影片播放器可能無法在範例應用程式中運作。
  • 透過 Cloud-to-Cloud 支援的窗簾裝置類型可能無法控制。
  • 如果 Google Home 應用程式處於開啟狀態，撤銷權限會導致應用程式當機。

2025-04-09

  iOS Home API 公開 Beta 版發布  

在公開開發人員 Beta 版期間，所有開發人員都可以開始建構及測試 iOS 應用程式。

這個版本修正了錯誤，並提升 Home API iOS SDK 正式發布版的品質。

最低版本

  • 彙整至 connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS：iOS 16.4 以上版本、Xcode 15.3 以上版本
  • Google Hub 韌體最低版本：
    • Cast 版本：3.75.456944
    • Fuchsia 最低版本：24.20241009.103.1900601
  • iOS SDK：home_platform_ios_1.0_1.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本： 1.4.0.0
    • 注意：系統不支援臨時 Matter 裝置類型和叢集。

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 在 iOS 版 Google Home 應用程式中授予權限時，「瞭解詳情」和返回按鈕可能無法回應。
    • 解決方法：長按「瞭解詳情」連結，在系統瀏覽器中開啟，或輕觸左上角的關閉按鈕退出檢視畫面。
  • 如果 Google Home 應用程式處於開啟狀態，撤銷權限會導致應用程式當機。
  • 基本影片播放器可能無法在範例應用程式中運作。
  • 透過 Cloud-to-Cloud 支援的溫度控制器可能無法運作。
  • 範例應用程式可能無法控制 Cloud-to-Cloud 支援的風扇裝置類型。
  • 透過 Cloud-to-Cloud 支援的窗簾裝置類型可能無法控制。
  • 從本機變更為 Wi-Fi 網路，或在應用程式之間切換時，iOS 版 Google Home 應用程式可能會當機。

已修正的已知問題

  • 不支援命名和重新命名裝置。
  • 如要完成委派程序，必須使用 iOS 版 Google Home 應用程式委派結構體中的第一個 Matter 裝置。目前 Home API 無法建立新的網狀架構，只能將裝置新增至 2023 年前建立的結構體現有網狀架構。2023 年後建立的結構不會受到這個問題影響。