Home APIs iOS SDK 版本資訊

2026-05-06

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

範例應用程式

2026-05-01

  Home API 公開 Beta 版 1.8.1  

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

最低版本

新功能

已修正的已知問題

  • 當 Sample App 進入背景和前景時，直播會中斷。
  • 如果使用者透過「我的帳戶」撤銷權限，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 公開 Beta 版 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 代) v4 的溫度單位 (攝氏/華氏)。
  • 在 Google Home 網頁版行動版中，頂端圖示和返回按鈕會遭到標題遮蔽。使用者可能無法返回或查看重要使用者介面元素。
  • 在同一個遙控器上切換使用者後，Google Home 應用程式裝置動態磚會離線。如果多使用者家庭共用同一個控制器，裝置可能會離線，直到重新啟動應用程式為止。

已知問題

  • 可能無法調試 Matter 裝置。

2026-03-13

  Home API 公開 Beta 版 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 Hub 韌體、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 代) v4 的溫度單位 (攝氏/華氏)。
  • 在 Google Home 網頁版行動版中，頂端圖示和返回按鈕會遭到標題遮蔽。使用者可能無法返回或查看重要使用者介面元素。
  • 在同一個遙控器上切換使用者後，Google Home 應用程式裝置動態磚會離線。如果多使用者家庭共用同一個控制器，裝置可能會離線，直到重新啟動應用程式為止。
  • 可能無法調試 Matter 裝置。

2026-02-13

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

範例應用程式

2026-02-09

  Home API 公開 Beta 版 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) 的線上狀態。請改用 Target Device State Service (TDSS) 對應表，適用於 LOCAL_SYNC 來源的裝置。

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

2025-07-30

  Home API 公開 Beta 版 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 GHA 新增 Thread 邊界路由器。

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
  • 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 GHA 新增 Thread 邊界路由器。

2025-06-05

  Home API 公開 Beta 版 1.3.1  

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

最低版本

其他值得注意的變更

已修正的已知問題

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

已知問題

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

2025-05-09

  Home API 公開 Beta 版 1.3  

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

最低版本

新功能

已修正的已知問題

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

已知問題

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

已修正的已知問題

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