Home APIs iOS SDK 版本資訊

2026-04-09

  Home API 公開 Beta 版 1.8  

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

最低版本

  • Google 中樞裝置的最低韌體版本：
    • 投放：
      • Nest Wifi Pro：3.78.518349
      • 所有其他支援 Google Cast 的中樞裝置：3.78.526062
    • Fuchsia：29.20251023.103.2101601
    • 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，實驗性支援 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 中樞裝置的最低韌體版本：
    • 投放：
      • Nest Wifi Pro：3.78.518349
      • 所有其他支援 Cast 的中樞裝置：3.78.516526
    • Fuchsia：29.20251023.103.2201
    • 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，實驗性支援 1.5.0。

新功能

其他值得注意的變更

  • 簡化訂閱同意聲明流程。
  • Home APIs iOS 範例應用程式 1.7.1 版。詳情請參閱 GitHub 版本。

修正已知問題

  • 初始載入時，歷史記錄篩選器不會顯示當天和裝置的所有預期事件。
    • 解決方法：清除所有篩選條件，即可顯示所有事件。
  • 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 版。

如需完整版本資訊，請參閱 GitHub 版本。

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 中樞裝置的最低韌體版本：
    • 投放：
      • Nest Wifi Pro：3.76.508025
      • 所有其他支援 Cast 的中樞裝置：3.77.510748
    • Fuchsia：29.20251023.103.2100
    • Google TV Streamer (4K)：UTTK.250729.004
  • iOS SDK：home_platform_ios_1.7.0
  • Google Home 應用程式最低版本：1.7
  • Matter 版本： 1.4.1.0，實驗性支援 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 中樞裝置的最低韌體版本：
    • 投放：
      • Nest Wifi Pro：3.75.479819
      • 所有其他支援 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 GHA 新增 Thread 邊界路由器。

已修正的已知問題

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

2025-09-26

  Home API 公開 Beta 版 1.5.0 發布  

這個版本支援攝影機裝置、修正錯誤，並提升 Google 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 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
    • 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 版品質。

最低版本

新功能

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

iOS 範例應用程式

  • 刪除僅支援 Matter 的裝置。

已知問題

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

已修正的已知問題

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