Home APIs iOS SDK 版本資訊

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 版品質。

最低版本

新功能

  • 外部範例應用程式

已知問題

  • 從 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 應用程式中授予權限時，「瞭解詳情」和返回按鈕可能無法回應。
    • 解決方法：長按「瞭解詳情」連結，在系統瀏覽器中開啟，或輕觸左上角的關閉按鈕退出檢視畫面。
  • 基本影片播放器可能無法在範例應用程式中運作。
  • 透過雲端對雲端控制的窗簾裝置類型可能無法運作。
  • 如果是在 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
    • 注意：系統不支援臨時 Matter 裝置類型和叢集。

已知問題

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

已修正的已知問題

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