Home APIs iOS SDK 版本資訊

2026-10-22

  Home API 正式發布版 1.11.1  

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

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本。不支援 Xcode 27。
  • Matter 裝置設定：iOS 26.0 以上版本
  • Google Hub 韌體、Cast、Nest Wifi Pro：3.78.556638
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.79.558061
  • Google Hub 韌體、Fuchsia：31.20260429.103.8713700
  • Google Hub 韌體、Google TV Streamer (4K)：UTTK.260317.003
  • iOS SDK：GoogleHomeSDK-1.11.1.tar.gz
  • Google Home 應用程式：適用於任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0

新功能

其他重要異動

2026-09-23

  Home API 正式發布版 1.11  

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

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本。不支援 Xcode 27。
  • Matter 裝置設定：iOS 26.0 以上版本
  • Google Hub 韌體、Cast、Nest Wifi Pro：3.78.548779
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.79.550760
  • Google Hub 韌體、Fuchsia：31.20260429.103.8712702
  • Google Hub 韌體、Google TV Streamer (4K)：UTTK.260317.003
  • iOS SDK：home_platform_ios_1.11
  • Google Home 應用程式：適用於任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0

新功能

其他重要異動

2026-09-16

我們推出了兩個新的 MCP 伺服器。Home MCP 可讓個人代理安全地與智慧型住宅互動，Home Developer MCP 則可讓您慣用的代理搜尋及查詢 Home Developer Center 的說明文件和其他智慧型住宅資源。

新功能

2026-09-16

Home API iOS 範例應用程式已更新，適用於 Home API 1.10.1 版本。

範例應用程式

2026-08-28

  Home API 正式發布版 1.10.1  

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

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
  • Matter 裝置設定：iOS 26.0 以上版本
  • Google Hub 韌體、Cast、Nest Wifi Pro：3.78.548779
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.79.547681
  • Google Hub 韌體、Fuchsia：31.20260429.103.8712702
  • Google Hub 韌體、Google TV Streamer (4K)：UTTK.260317.003
  • iOS SDK：home_platform_ios_1.10_1
  • Google Home 應用程式：適用於任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0

新功能

其他重要異動

2026-08-07

Home API iOS 範例應用程式已更新，支援 Home API 1.10 版。

範例應用程式

2026-07-30

  Home API 正式發布版 1.10  

這個版本修正了一些錯誤，並將 Home API iOS SDK 升級至正式發布品質。

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
  • Matter 裝置設定：iOS 26.0 以上版本
  • Google Hub 韌體、Cast、Nest Wifi Pro：3.78.518349
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.78.540761
  • Google Hub 韌體 Fuchsia：30.20260121.103.1602904
  • Google Hub 韌體、Google TV Streamer (4K)：UTTK.260317.003
  • iOS SDK：home_platform_ios_1.10_0
  • Google Home 應用程式：適用於任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0

2026-07-09

Home.presentPermissionsUpdate() 方法已淘汰。 應用程式現在應透過 Home 執行個體上的 permissions 屬性與 UserScopedPermissionsController 互動。

近期異動內容

2026-07-08

iOS 版邊界路由器裝置指南現已推出。

新內容

2026-07-07

Home API iOS 範例應用程式已更新，支援 Home API 1.9.1 版。

範例應用程式

2026-06-26

  Home API 公開測試版 1.9.1  

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

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
  • Matter 裝置設定：iOS 26.0 以上版本
  • Google Hub 韌體、Cast、Nest Wifi Pro：3.78.518349
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.78.538123
  • Google Hub 韌體 Fuchsia：30.20260121.103.1602904
  • Google Hub 韌體、Google TV Streamer (4K)：UTTK.250729.004 (14748786)
  • iOS SDK：GoogleHomeSDK-1.9.1.tar.gz
  • Google Home 應用程式：適用於任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0

新功能

已修正的已知問題

  • 只有在透過 iOS 裝置建立住家結構，並與 Google Home、Google Nest Mini 或 Google Nest Audio 智慧音箱等 Cast OS 中樞裝置配對時，才支援裝置設定。

2026-06-09

Home API iOS 範例應用程式已更新，適用於 Home API 1.9.0 版本。

範例應用程式

2026-05-29

  Home API 公開測試版 1.9  

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

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
  • Matter 裝置設定：iOS 26.0 以上版本
  • Google Hub 韌體、Cast、Nest Wifi Pro：3.78.518349
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.78.526062
  • Google Hub 韌體 Fuchsia：30.20260121.103.1602904
  • Google Hub 韌體、Google TV Streamer (4K)：UTTK.250729.004 (14748786)
  • iOS SDK：home_platform_ios_1.8.0_0
  • Google Home 應用程式：適用於任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0

新功能

已知問題

  • 只有在透過 iOS 裝置建立住家結構，並與 Google Home、Google Nest Mini 或 Google Nest Audio 智慧音箱等 Cast OS 中樞裝置配對時，才支援裝置設定。

2026-05-06

Home API iOS 範例應用程式已更新，支援 Home API 1.8.1 版。

範例應用程式

2026-05-01

  Home API 公開測試版 1.8.1  

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

最低版本

新功能

已修正的已知問題

  • 範例應用程式在背景和前景執行時，直播會中斷。
  • 如果使用者透過「我的帳戶」撤銷權限，Google Home 應用程式可能會異常終止。解決方法是重新啟動應用程式。
  • Philips BLE 燈具未顯示正確狀態。

已知問題

  • 無法使用 Google TV Streamer (4K) 登錄部分裝置。
  • 部分門鈴裝置的 IP 位址欄位未填入資料。
  • 如果中樞裝置是 Nest Wifi Pro、Google Nest Hub 或 Google Nest Hub Max，Google Home 應用程式會將多功能裝置顯示為多個圖塊。

2026-04-10

Home API iOS 範例應用程式已更新，支援 Home API 1.8 版。

範例應用程式

2026-04-09

  Home API 公開測試版 1.8  

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

最低版本

  • Google Hub 韌體、Cast、Nest Wifi Pro：3.78.518349
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.78.526062
  • Google Hub 韌體，Fuchsia：29.20251023.103.2101601
  • Google Hub 韌體、Google TV Streamer、4K：UTTK.250729.004
  • iOS SDK：home_platform_ios_1.8.0_0
  • Google Home 應用程式：適用於任何版本
  • androidx.core 程式庫：適用於任何版本
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0

新功能

已修正的已知問題

  • Nest Cam (室外型，有線版，第 2 代) 可能無法註冊。圖塊會保持灰色，系統會顯示錯誤訊息，且無法控制攝影機。
  • 無法變更 Google Nest Learning Thermostat (第 4 代) 第 4 版的溫度單位 (攝氏/華氏)。
  • 在行動版 Google Home 網頁版中，頂端圖示和返回按鈕會被標題遮住。使用者可能無法返回或查看重要使用者介面元素。
  • 在同一個控制器上切換使用者後，GHA 裝置圖塊會離線。如果多使用者家庭中的使用者共用同一個控制器，裝置可能會離線，直到重新啟動應用程式為止。

已知問題

  • 可能無法調試 Matter 裝置。

2026-03-13

  Home API 公開測試版 1.7.1  

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

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
  • Matter 裝置設定：iOS 17.6 以上版本
  • Google Hub 韌體、Cast、Nest Wifi Pro：3.78.518349
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.78.516526
  • Google Hub 韌體，Fuchsia：29.20251023.103.2201
  • Google 中樞韌體、Google TV Streamer (4K)：UTTK.260120.001
  • iOS SDK：home_platform_ios_1.7.1
  • Google Home 應用程式最低版本：1.7.1
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0

新功能

其他重要異動

  • 簡化訂閱同意聲明流程。

範例應用程式

已修正的已知問題

  • 初次載入時，記錄篩選功能不會顯示當天和裝置的所有預期事件。解決方法：清除所有篩選條件，即可顯示所有事件。
  • 如果是 Nest Cam Indoor/Outdoor (電池版或有線版) 和 Nest Doorbell (電池版，第 2 代)，電池設定中不會顯示「電池剩餘時間」選項。

已知問題

  • Nest Cam (室外型，有線版，第 2 代) 可能無法註冊。圖塊會保持灰色，系統會顯示錯誤訊息，且無法控制攝影機。
  • 無法變更 Google Nest Learning Thermostat (第 4 代) 第 4 版的溫度單位 (攝氏/華氏)。
  • 在行動版 Google Home 網頁版中，頂端圖示和返回按鈕會被標題遮住。使用者可能無法返回或查看重要使用者介面元素。
  • 在同一個控制器上切換使用者後，GHA 裝置圖塊會離線。如果多使用者家庭中的使用者共用同一個控制器，裝置可能會離線，直到重新啟動應用程式為止。
  • 可能無法調試 Matter 裝置。

2026-02-13

Home API iOS 範例應用程式已更新，適用於 Home API 1.7 版本。

範例應用程式

2026-02-09

  Home API 公開測試版 1.7  

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

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
  • Matter 裝置設定：iOS 17.6 以上版本
  • Google Hub 韌體、Cast、Nest Wifi Pro：3.76.508025
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.77.510748
  • Google Hub 韌體，Fuchsia：29.20251023.103.2100
  • Google Hub 韌體、Google TV Streamer、4K：UTTK.250729.004
  • iOS SDK：home_platform_ios_1.7.0
  • Google Home 應用程式最低版本：1.7
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0

新功能

其他重要異動

已修正的已知問題

  • History API 一律會傳回 nextPageToken，導致無限迴圈。
  • 「串流中斷」錯誤可能會中斷長時間的攝影機串流影像工作階段。
  • 執行 CommissionDeviceCommand 時，Matter 裝置調試失敗。

已知問題

  • 在初始載入時，記錄篩選功能不會顯示當天和裝置的所有預期事件。解決方法：清除所有篩選條件，即可顯示所有事件。
  • 如果是 Nest Cam Indoor / Outdoor (電池版或有線版) 和 Nest Doorbell (電池版，第 2 代)，電池設定中不會顯示「電池剩餘時間」選項。
  • 「目前的攝影機裝置軟體版本」可能不會顯示正確的軟體版本。
  • 系統會忽略鈴聲持續時間設定。
  • 關閉 Nest Doorbell (電池版，第 2 代) 攝影機後，畫面會凍結。
  • Nest Cam IQ 攝影機設定應只顯示三個鈴聲主題，但卻顯示更多。
  • Philips BLE 燈具在離線時，仍會錯誤顯示為「線上」。解決方法：請勿只依賴智慧住宅裝置類型 (SHDT) 線上狀態。請改用目標裝置狀態服務 (TDSS) 對應，適用於來源為 LOCAL_SYNC 的裝置。

2025-12-22

  Home API 公開測試版 1.6  

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

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
  • Matter 裝置設定：iOS 17.6 以上版本
  • Google Hub 韌體、Cast、Nest Wifi Pro：3.75.479819
  • Google Hub 韌體、Cast、所有其他 Cast 型 Hub：3.77.505721
  • Google Hub 韌體、Fuchsia：28.20250723.103.2100300
  • Google Hub 韌體、Google TV Streamer、4K：UTTK.250729.004
  • iOS SDK：home_platform_ios_1.6.0
  • Google Home 應用程式最低版本：1.6
  • Matter 版本：1.4.1.0

新功能

其他重要異動

  • iOS 範例應用程式新增更多攝影機和門鈴設定，並預設使用 Swift Package Manager 整合 SDK。

已修正的已知問題

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

2025-10-22

  Home API 公開測試版 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
  • Google Hub 韌體，Fuchsia：27.20250422.103.3600
  • iOS SDK：home_platform_ios_1.5.1.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本：1.4.1.0

新功能

已修正的已知問題

  • 使用範例應用程式時，直播會意外停止。

已知問題

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

2025-09-26

  Home API 公開測試版 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
  • Google Hub 韌體，Fuchsia：27.20250422.103.3600
  • iOS SDK：home_platform_ios_1.5.0.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本：1.4.1.0

新功能

其他重要異動

  • iOS 範例應用程式新增對攝影機裝置類型和中樞啟動的支援。

已修正的已知問題

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

已知問題

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

2025-08-28

  Home API 公開測試版 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
  • Google Hub 韌體，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 公開測試版 1.4.0  

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

最低版本

  • iOS：iOS 17.0 以上版本、Xcode 15.3 以上版本
  • Matter 裝置設定：iOS 17.6 以上版本
  • Google Hub 韌體、Cast：3.75.456944
  • Google Hub 韌體、Fuchsia：24.20241009.103.1900601
  • iOS SDK：home_platform_ios_1.4.0.zip
  • Google Home 應用程式最低版本：適用於任何版本
  • Matter 版本：1.4.0.0

新功能

其他重要異動

  • iOS 範例應用程式不再支援刪除僅限 Matter 的裝置。

已知問題

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

2025-06-26

  Home API 公開測試版 1.3.2  

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

最低版本

  • iOS：iOS 16.4 以上版本、Xcode 15.3 以上版本
  • Google Hub 韌體、Cast：3.75.456944
  • Google Hub 韌體、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 邊界路由器。

2025-06-05

  Home API 公開測試版 1.3.1  

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

最低版本

其他重要異動

已修正的已知問題

  • iOS 版 GHA 在網路從本機切換至 Wi-Fi 或切換應用程式時，可能會當機。

已知問題

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

2025-05-09

  Home API 公開測試版 1.3  

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

最低版本

新功能

已修正的已知問題

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

已知問題

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

2025-04-09

  iOS Home API 公開測試版  

在公開開發人員 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 應用程式開啟時撤銷權限，應用程式會當機。
  • Basic Video Player 可能無法在範例應用程式中運作。
  • 雲端對雲端支援的溫度控制器可能無法運作。
  • 在範例應用程式中，可能無法控制雲端對雲端支援的風扇裝置類型。
  • 雲端對雲端支援的窗簾裝置類型可能無法控制。
  • 在網路從本機變更為 Wi-Fi 或切換應用程式時，iOS 版 GHA 可能會異常終止。

已修正的已知問題

  • 不支援命名和重新命名裝置。
  • 如要進行委任，住家結構中的第一個 Matter 裝置必須使用 iOS 版 Google Home 應用程式進行委任。Home API 目前無法建立新的 Fabric，只能在 2023 年前建立的住家結構中，將裝置新增至現有的 Fabric。2023 年後建立的住家結構體不受這個問題影響。