Home APIs iOS SDK 版本資訊

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
    • 透過 Hub 啟用 API，您可以透過程式輔助方式探索及啟用 Google Home Hub。請參閱「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

  首頁 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
    • 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

  首頁 API 公開測試版 1.4.0  

此版本包含錯誤修復並提高了 Home API iOS SDK 的 beta 版品質。

最低版本

新功能

  • 設備 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 邊界路由器。

已修正的已知問題

  • iOS 版 GHA 在網路從本機網路切換到 Wi-Fi 或在應用程式之間切換時可能會崩潰。

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

新功能

  • 設備 API
  • Structure API
    • 支援更改 Room 名稱

已知問題

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

已修正的已知問題

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

2025-04-09

  iOS Home API 公開 Beta 版發布  

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

此版本包含錯誤修復，並提高了 Home API iOS SDK 的通用可用性 (GA) 品質。

最低版本

  • 彙整至 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
    • 注意: 暫不支援臨時事項設備類型和叢集。

已知問題

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

已修正的已知問題

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