Home APIs Android SDK 版本資訊

2025-10-23

  Home API 公開 Beta 版 1.5.1 發布  

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

最低版本

  • Google Play 服務：25.41.30
  • Google Hub 韌體最低版本：
    • Cast：3.76.495998
    • Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_5_1
  • Google Home 應用程式：適用於任何版本
  • androidx.core 程式庫：適用於任何版本
  • Matter 版本： 1.4.1.0

新功能

  • Structure API
    • 透過 Hub 啟用 API，您可以透過程式輔助方式探索及啟用 Google Home Hub。請參閱「Android 上的 Hub 啟用 API」。
  • Android 範例應用程式
    • 支援的門鈴裝置類型：
      • OnOff
      • 直播
      • 雙向談話
    • Hub Activation API：啟用 Hub

已修正的已知問題

  • 範例應用程式未在「Device」(裝置) 檢視畫面中正確顯示裝置狀態。

2025-09-26

  Home API 公開 Beta 版 1.5.0  

這個版本支援攝影機裝置、修正錯誤，並提升 Home API Android SDK Beta 版的品質。

最低版本

  • Google Play 服務：25.37.31
  • Google Hub 韌體最低版本：
    • Cast：3.76.492738
    • Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_5
  • Google Home 應用程式：適用於任何版本
  • androidx.core 程式庫：適用於任何版本
  • Matter 版本： 1.4.1.0

新功能

  • Automation API
    • 啟動條件、限制條件和動作現在接受 Matter 結構體做為參數。
  • Device API
    • 已新增 攝影機裝置類型。下列攝影機功能也適用於門鈴裝置類型：
      • 攝影機直播。
      • 攝影機對講。
      • 攝影機開始和停止錄影。
  • Android 範例應用程式
    • 支援攝影機裝置類型：
      • 攝影機直播。
      • 攝影機對講。
      • 攝影機開始和停止錄影。
      • 受限制的裝置類型權限。
    • 多位管理員可委派裝置 (共用委派裝置)。
    • 預先定義的OnOff自動化動作。

已知問題

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

已修正的已知問題

  • 強制移除目前啟用的中樞裝置後，有五分鐘的時間無法控制部分裝置。五分鐘後，你就能再次控制裝置。
  • 使用者從預設顏色或色溫挑選器選取顏色後，擴展色光無法更新顏色。

2025-09-08

Android 專用範例應用程式 1.4.1 版已發布。

新功能

  • 建立、重新命名、更新和刪除房間。
  • 調試至第三方 Matter Fabric。

修正已知問題

  • 權限撤銷頁面連結現在可正常運作。

2025-08-29

  Home API 公開 Beta 版 1.4.1  

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

最低版本

  • Google Play 服務：25.33.32
  • Google 中樞裝置的最低韌體版本：
    • Cast：3.76.495998
    • Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_4_1
  • Google Home 應用程式：適用於任何版本
  • androidx.core 程式庫：適用於任何版本
  • Matter 版本： 1.4.0.0

新功能

已知問題

  • 強制移除目前啟用的中樞裝置後，有五分鐘的時間無法控制部分裝置。五分鐘後，你就能再次控制裝置。

已修正的已知問題

  • 使用者嘗試將恆溫器設為不支援的模式時，Android 範例應用程式會當機。

2025-07-31

  Home API 公開 Beta 版 1.4.0  

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

最低版本

  • Google Play 服務：25.28.34
  • Google 中樞裝置的最低韌體版本：
    • Cast：3.76.486931
    • 紫紅色：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_4_0
  • Google Home 應用程式：適用於任何版本
  • androidx.core 程式庫：適用於任何版本
  • Matter 版本： 1.4.0.0

新功能

  • Automation API

已知問題

  • 登出手機後再登入，Home API 應用程式就無法控制裝置。
    • 解決方法：關閉或將應用程式移至背景，然後等待至少 10 秒再重試。

已修正的已知問題

  • 已停靠的吸塵器裝置不會註冊「已停靠」狀態。

2025-07-08

在 Cast 韌體版本 3.76.479819 中，Nest Wifi Pro 現在可以做為 Home API 中樞裝置。

2025-06-26

  Home API 公開 Beta 版 1.3.2  

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

最低版本

  • Google Play 服務：25.23.31
  • Google 中樞裝置的最低韌體版本：
    • 投放：
      • Google Home、Google Home Mini 和 Google Nest Mini：3.75.468362
      • Google Nest Audio：3.75.476451
    • Fuchsia：26.20250116.103.2900
  • Android SDK：home.android.sdk_1_3_2
  • Google Home 應用程式：適用於任何版本
  • androidx.core 程式庫：適用於任何版本
  • Matter 版本： 1.4.0.0

新功能

  • SDK 構件已分成兩個獨立構件：
    • Home API SDK 架構 (play-services-home-17.0.0.aar)
    • SDK 特徵和裝置類型 (play-services-home-types-17.0.0.aar)

    從這個版本開始，開發人員必須在專案的編譯時間和執行階段程式庫路徑中，加入這兩項構件。

Android 範例應用程式

  • 使用者可以取消連結並撤銷應用程式的權限。
  • 更新 SDK 構件，加入 play-services-home-17.0.0 和 play-services-home-types-17.0.0。

已知問題

  • 已停靠的吸塵器裝置不會註冊「已停靠」狀態。

2025-06-05

  Home API 公開 Beta 版 1.3.1  

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

最低版本

  • Google Play 服務：25.19.32
  • Google 中樞裝置的最低韌體版本：
    • Cast：3.75.468222
    • Fuchsia：26.20250116.103.2201
  • Android SDK：home.android.sdk_202505_EAP_1_3_1_RC06
  • Google Home 應用程式：適用於任何版本
  • androidx.core 程式庫：適用於任何版本
  • Matter 版本： 1.4.0.0

新功能

特徵

Android 範例應用程式

新增函式，可記錄結構、裝置、類型、特徵和自動化動作的狀態，方便進行偵錯。

已知問題

在 Android 範例應用程式中，有時需要多次輕觸「建立自動化動作」按鈕，才會觸發動作。

修正已知問題

  • 如果未在 Google Home 應用程式中設定住家位置，建立自動化動作時，Google Home 應用程式會發生 FailedPreconditionException 錯誤而當機 (如要瞭解如何設定住家位置，請參閱「變更 Google 住家地址」一文)。
  • 在 Android 範例應用程式中，先前會向使用者顯示 connectivityState PARTIALLY_ONLINE 裝置為離線狀態。此狀態現在會顯示為「線上」。

2025-05-12

  Home API 公開 Beta 版 1.3 發布  

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

最低版本

  • Google Play 服務：25.16.33
  • Google 中樞裝置的最低韌體版本：
    • Cast：3.75.468222
    • Fuchsia：26.20250116.103.2201
  • Android SDK：home.android.sdk_202504_EAP_1_3_RC00
  • Google Home 應用程式：適用於任何版本
  • androidx.core 程式庫：適用於任何版本
  • Matter 版本： 1.4.0.0

新功能

  • Automation API
    • 新增支援 週期性排程活動啟動條件，開發人員可使用 cron 運算式，根據時鐘時間、太陽時間和日曆條件，建立定期執行的自動化動作。
  • Device API
  • 結構 API

已知問題

如果未在 Google Home 應用程式中設定住家位置，建立自動化動作時，Google Home 應用程式會顯示 FailedPreconditionException 並當機 (請參閱「變更 Google 住家地址」一文，瞭解如何設定住家位置)。

  • 解決方法：嘗試建立自動化動作前，請先使用 Discovery API 確認住家地址是否存在。

修正已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 中樞裝置恢復原廠設定後，裝置可能會顯示為離線。

2025-04-09

  Home API 公開 Beta 版 1.2.1  

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

最低版本

  • Google Play 服務：25.09.33
  • Google 中樞裝置的最低韌體版本：
    • Cast：3.75.468222
    • Fuchsia：24.20241009.103.19006011
  • Android SDK：home.android.sdk_202503_EAP_1_2_1_RC02
  • Google Home 應用程式：適用於任何版本
  • androidx.core library：1.10.0
  • Matter 版本： 1.4.0.0
1. 這個版本目前正在正式版中推出，並將於 2025 年 4 月 22 日前開放所有裝置使用。

新功能

  • 提升從住家圖表載入物件時的效能。
  • Automation API
    • 新增 實體篩選器支援功能，可讓自動化程序根據自動化程序中指定的條件，動態選取裝置。
  • Device API

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 中樞裝置恢復原廠設定後，裝置可能會顯示為離線。

已修正的已知問題

  • 如果在初始化之前或初始化完成之前呼叫 Discovery API，則會拋出帶有 code 14: UNKNOWN 的 HomeException 異常，並顯示訊息「未找到路由」。
  • 在包含多個結構和多位使用者的環境中，切換結構和使用者可能會導致系統未傳回任何裝置。

2025-03-14

  首頁 API 公開測試版 1.2.0  

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

最低版本

  • Google Play 服務最低版本：25.06.32
  • Google Hub 韌體最低版本：
    • Cast 版本：3.75.456944
    • Fuchsia 最低版本：24.20241009.103.1900601
  • Android SDK：home.android.sdk_1_2_0_RC06
  • Google Home 應用程式最低版本：適用於任何版本
  • androidx.core 庫最低版本：1.10.0
  • Matter 版本：1.3.0.0
    • 注意: 暫不支援臨時事項設備類型和叢集。

新功能

  • 自動化 API：
    • 支援在自動化條件中使用日期範圍和部分日期。 請參閱 使用 between 中的日期。
    • 在先前的版本中，Discovery API 對某些位圖欄位傳回了 NumberSetConstraint，而它本應傳回 BitmapConstraint。這些欄位現在按預期傳回 BitmapConstraint。這僅限於 LevelControl 特徵指令中的 optionsMask 和 optionsOverride 位圖。

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 路由器恢復出廠設定後，設備可能會顯示為離線狀態。
  • 如果在初始化之前或初始化完成之前呼叫 Discovery API，則會拋出帶有 code 14: UNKNOWN 的 HomeException 異常，並顯示訊息「未找到路由」。
    • 解決方法：只有在實際需要自動化候選人時，才呼叫 Discovery API。請勿預先擷取及快取候選實體。請先檢查實體是否處於連線狀態，再對該實體呼叫 Discovery API 方法。
  • 在包含多個結構和多位使用者的環境中，切換結構和使用者可能會導致系統未傳回任何裝置。

已修正的已知問題

  • Home API 應用程式啟動後首次呼叫 HomeManager.structures() 時，即使存在一或多個結構體，也會收到零個結構體。這會造成錯誤印象，以為 Google 帳戶沒有相關聯的結構。
  • 載入、建立及編輯自動化動作時，使用者可能需要等待較長時間。
  • 如果使用者從「相機」應用程式啟動設定流程，必須掃描 QR code 兩次，才能完成 Matter 委派程序。
  • 如果結構包含超過 200 部裝置，Discovery API 可能只會傳回候選裝置。

2025-01-29

  Home API 公開 Beta 版 1.1.0  

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

最低版本

  • Google Play 服務最低版本：25.02.32
  • Google Hub 韌體最低版本：
    • Cast 版本：3.75.456944
    • Fuchsia 最低版本：24.20241009.103.1900500
  • Android SDK：home.android.sdk_202412_EAP_1_1_RC04
  • Google Home 應用程式最低版本：適用於任何版本
  • androidx.core 程式庫最低版本：1.10.0
  • Matter 版本： 1.3.0.0
    • 注意：系統不支援臨時 Matter 裝置類型和叢集。

新功能

  • 串流 API：
    • 提供事件串流，通知已新增、變更及移除的結構、房間和裝置。
    • 請參閱「訂閱實體關係事件」。
  • 批量處理 API（實驗性）：

已知問題

  • 用戶在載入、建立和編輯自動化流程時可能會遇到長時間的等待。
  • 如果使用者從「相機」應用程式啟動設定流程，必須掃描 QR code 兩次，才能完成 Matter 委派程序。
  • 在包含 200 多個裝置的結構中，Discovery API 可能不會傳回任何候選裝置。

已修正的已知問題

  • 切換已登入的 Google 帳號可能會失敗並導致錯誤。
  • 如果自動化動作使用 MediaPlayback 特徵，Google TV 裝置可能無法執行。
  • 在僅包含 Google hub 的結構中：
    • Google Home 應用程式可能會顯示 Matter 裝置離線。
    • Google Assistant 無法控制 Matter 裝置。
    • 智慧顯示器無法控制 Matter 設備，也無法顯示任何 Matter 設備的狀態。
  • 對於某些設備，應用程式可能無法始終準確反映設備狀態，且您的應用程式報告的狀態可能與 Google 應用程式（例如 Google Home 應用程式）報告的狀態不同。這通常是由於裝置未向 Google 報告狀態所致。
    • 解決方法：使用 Google 應用程式檢查狀態可以解決不符問題。

2025-01-14

更新了 Home API 初始化指南。

我們已經更明確地說明，Home 的 實例應該初始化為上下文單例。這可以確保您的應用程式擁有更流暢的使用者體驗，並避免因無效會話而導致的錯誤。

2025-01-07

  首頁 API 公開測試版  

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

此版本包含錯誤修復並增強了 Home APIs Android SDK 的 beta 版質量，包括改進了對 Google Nest Audio 和 Google TV 設備的支援。

最低版本

  • Google Play 服務最低版本：24.45.34
  • Google Hub 韌體最低版本：
    • Cast 版本：3.74.444798
    • Fuchsia 最低版本：22.20240805.103.161
  • Android SDK：home.android.sdk_202411_EAP_1_0_1_RC00
  • Google Home 應用程式 (GHA) 最低版本：適用於任何版本
  • androidx.core 程式庫最低版本：1.10.0
  • Matter 版本： 1.3.0.0
    • 注意：系統不支援臨時 Matter 裝置類型和叢集。

已知問題

  • 切換登入的 Google 帳戶可能會失敗並導致錯誤。
    • 解決方法：重新執行權限流程或重新啟動應用程式。
  • 如果自動化動作使用 MediaPlayback 特徵，Google TV 裝置可能無法執行。
  • 在只包含 Google Hub 的結構中：
    • Google Home 應用程式 (GHA) 可能會顯示 Matter 裝置離線。
    • Google 助理無法控制 Matter 裝置。
    • 智慧螢幕無法控制 Matter 裝置，也無法顯示任何 Matter 裝置的狀態。
  • 對於某些裝置，應用程式可能無法一律反映準確狀態，且應用程式回報的狀態可能與 Google 應用程式 (例如 Google Home 應用程式 (GHA)) 回報的狀態不同。這通常是因為裝置未向 Google 回報狀態。
    • 解決方法：使用 Google 應用程式查看狀態，即可解決不一致的問題。

已修正的已知問題

  • 如果在委派程序期間將應用程式縮到最小，委派作業可能會失敗。
  • 伺服器端問題可能會導致「Ok Google」啟動器無法在自動化動作中使用。
  • 如果使用執行 Fuchsia 的中樞，且結構中沒有任何 Matter 裝置，中樞閒置超過 3 小時後，委派第一個 Matter 裝置會導致該裝置離線。
  • 中樞裝置恢復原廠設定後，即使裝置顯示為連線狀態，對新委派裝置發出的指令仍可能會失敗。