Home APIs Android SDK 版本資訊

2026-05-01

  Home API 公開 Beta 版 1.8.1  

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

最低版本

新功能

  • 溫度控制器特徵現在支援讀取/更新、開啟/關閉和計時器功能

已修正的已知問題

  • 調試 Matter 裝置可能會失敗。
  • Philips BLE 燈未顯示正確狀態。
  • 延遲導致網路不穩定，回應時間緩慢。

已知問題

  • 無法使用 Google TV Streamer (4K) 委派部分裝置。
  • 如果中樞裝置是 Nest Wifi Pro、Google Nest Hub 或 Google Nest Hub Max，Google Home 應用程式會將多件式裝置顯示為多個動態磚。

2026-04-10

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

範例應用程式

2026-04-09

  Home API 公開 Beta 版 1.8 發布  

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

最低版本

  • Google Play 服務：26.12.32
  • 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
  • Android SDK：home.android.sdk_GHP_1_8_0
  • Google Home 應用程式：支援任何版本
  • androidx.core 程式庫：可與任何版本搭配使用
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0 版

新功能

已修正的已知問題

  • 無法變更 Google Nest Learning Thermostat (第 4 代) 的溫度單位 (攝氏/華氏)。
  • 在 Google Home 網頁版行動版中，頂端圖示和返回按鈕會遭到標題遮蔽。使用者可能無法返回或查看重要使用者介面元素。
  • Android TV 中樞裝置可能會誤將 Matter 裝置回報為「離線」。

已知問題

  • 調試 Matter 裝置可能會失敗。

2026-03-13

  Home API 公開 Beta 版 1.7.1  

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

最低版本

  • Google Play 服務：
  • 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.250729.004
  • Android SDK：home.android.sdk_GHP_1_7_1
  • Google Home 應用程式：1.7.1
  • androidx.core 程式庫：可與任何版本搭配使用
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0 版

新功能

其他值得注意的變更

  • 已移除無中樞模式。

範例應用程式

已修正的已知問題

  • Nest Cam Indoor/Outdoor (電池版或有線版) 和 Nest Doorbell (電池版，第 2 代) 的「電池設定」中不會顯示「剩餘電量」選項。
  • 系統會忽略電鈴時間長度設定。
  • 即使裝置實際處於離線狀態，Philips BLE 燈仍會錯誤顯示為「連線」。

已知問題

  • 無法變更 Google Nest Learning Thermostat (第 4 代) 的溫度單位 (攝氏/華氏)。
  • 網路穩定性和裝置回應速度可能會受到影響。
  • 在 Google Home 網頁版行動版中，頂端圖示和返回按鈕會遭到標題遮蔽。使用者可能無法返回或查看重要使用者介面元素。
  • 在聯合模式 OOBE 後，中樞裝置可能會停留在「正在連線...」狀態。
  • 調試 Matter 裝置可能會失敗。
  • Android TV 中樞裝置可能會誤將 Matter 裝置回報為離線。
  • 「目前的攝影機裝置軟體版本」可能不會顯示正確的軟體版本。
  • 溫度控制器使用者介面滑桿顯示超出範圍的溫度。
  • 設定鈴聲時間後，裝置不會在指定時間內發出鈴聲。

2026-02-13

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

範例應用程式

2026-02-09

  Home API 公開 Beta 版 1.7  

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

最低版本

  • Google Play 服務：26.02.34
  • 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
  • Android SDK：home.android.sdk_GHP_1_7
  • Google Home 應用程式：1.7
  • androidx.core 程式庫：可與任何版本搭配使用
  • Matter 版本：1.4.1.0
  • Matter 版本：實驗性支援 1.5.0 版

新功能

其他值得注意的變更

已修正的已知問題

  • History API 一律會傳回 nextPageToken，導致無限迴圈。
  • 嘗試登入新帳戶時，發生「使用者取消權限流程」錯誤。

已知問題

  • Nest Cam Indoor/Outdoor (電池版或有線版) 和 Nest Doorbell (電池版，第 2 代) 的「電池設定」中不會顯示「剩餘電量」選項。
  • 系統會忽略電鈴時間長度設定。
  • 即使裝置實際處於離線狀態，Philips BLE 燈仍會錯誤顯示為「連線」。解決方法：請勿只依賴智慧住宅裝置類型 (SHDT) 的線上狀態。請改用 Target Device State Service (TDSS) 對應表，適用於具有 LOCAL_SYNC 來源的裝置。

2025-12-22

  Home API 公開 Beta 版 1.6  

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

最低版本

  • Google Play 服務：25.47.30
  • 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
  • Android SDK：home.android.sdk_GHP_1_6
  • Google Home 應用程式：1.6
  • androidx.core 程式庫：可與任何版本搭配使用
  • Matter 版本：1.4.1.0

新功能

其他值得注意的變更

  • Android 範例應用程式新增攝影機設定、預先定義的自動化動作、風扇和音箱支援。

已知問題

  • 長時間使用後，裝置控制項會停止運作。解決方法：重新啟動中樞裝置。
  • Matter 裝置調試作業可能會失敗。
  • 在 Android 範例應用程式中嘗試新增帳戶時，系統會顯示「User cancelled Permission flow」錯誤訊息。解決方法：透過 Android 裝置設定新增 Google 帳戶。
  • 使用 Android Home API SDK 委派的 Walmart onn 有線安全攝影機無法透過 Google Home 應用程式直播。
  • 透過 Home API 應用程式委派的攝影機，無法透過 Google Home 應用程式啟動即時串流工作階段。

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
  • Google Hub 韌體，Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_5_1
  • Google Home 應用程式：支援任何版本
  • androidx.core 程式庫：可與任何版本搭配使用
  • Matter 版本：1.4.1.0

新功能

其他值得注意的變更

  • Android 範例應用程式新增 Doorbell 裝置類型支援 (OnOff、Livestream、Two-way talk) 和 Hub Activation API 實作項目。

已修正的已知問題

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

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
  • Google Hub 韌體，Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_5
  • Google Home 應用程式：支援任何版本
  • androidx.core 程式庫：可與任何版本搭配使用
  • Matter 版本：1.4.1.0

新功能

其他值得注意的變更

  • Android 範例應用程式新增支援相機、多位管理員委派作業，以及預先定義的OnOff自動化功能。

已修正的已知問題

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

已知問題

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

2025-08-29

  Home API 公開 Beta 版 1.4.1  

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

最低版本

  • Google Play 服務：25.33.32
  • Google Hub 韌體版本、Cast：3.76.495998
  • Google Hub 韌體，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 Hub 韌體版本、Cast：3.76.486931
  • Google Hub 韌體，Fuchsia：27.20250422.103.3600
  • Android SDK：home.android.sdk_1_4_0
  • Google Home 應用程式：支援任何版本
  • androidx.core 程式庫：可與任何版本搭配使用
  • Matter 版本：1.4.0.0

新功能

其他值得注意的變更

  • Android 範例應用程式會刪除僅支援 Matter 的裝置、重新命名裝置，並取代已淘汰的 API 呼叫。

已修正的已知問題

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

已知問題

  • 登出手機後再登入，Home API 應用程式就無法控制裝置。解決方法：關閉應用程式並等待至少 10 秒。

2025-06-26

  Home API 公開 Beta 版 1.3.2 發布  

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

最低版本

  • Google Play 服務：25.23.31
  • Google Hub 韌體、Google Cast、Google Home、Google Home Mini 和 Google Nest Mini：3.75.468362
  • Google Hub 韌體、Google Cast、Google Nest Audio：3.75.476451
  • Google Hub 韌體，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 範例應用程式新增功能：使用者可以從應用程式中斷連線並撤銷權限。
  • 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 Hub 韌體版本、Cast：3.75.468222
  • Google Hub 韌體，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 範例應用程式中，有時需要多次輕觸「建立自動化動作」按鈕，才能觸發動作。

2025-05-12

  Home API 公開 Beta 版 1.3  

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

最低版本

  • Google Play 服務：25.16.33
  • Google Hub 韌體版本、Cast：3.75.468222
  • Google Hub 韌體，Fuchsia：26.20250116.103.2201
  • Android SDK：home.android.sdk_202504_EAP_1_3_RC00
  • Google Home 應用程式：支援任何版本
  • androidx.core 程式庫：可與任何版本搭配使用
  • Matter 版本：1.4.0.0

新功能

已修正的已知問題

  • 從 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 程式庫：1.10.0
  • Matter 版本： 1.4.0.0
1. 這個版本目前正在正式版中推出，並將於 2025 年 4 月 22 日前開放所有裝置使用。

新功能

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

已知問題

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

已修正的已知問題

  • 如果在初始化之前或初始化完成前呼叫 Discovery API，系統會擲回 HomeException，並顯示 code 14: UNKNOWN 和「No route found.」訊息。
  • 在包含多個結構和多位使用者的環境中，切換結構和使用者可能會導致系統未傳回任何裝置。

2025-03-14

  Home API 公開 Beta 版 1.2.0  

這個版本修正了錯誤，並提升 Home API 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
    • 注意：系統不支援臨時 Matter 裝置類型和叢集。

新功能

  • Automation API：
    • 自動化條件支援日期範圍和部分日期。請參閱「使用日期範圍」。
    • 在先前的版本中，Discovery API 應傳回 BitmapConstraint，但卻針對部分點陣圖欄位傳回 NumberSetConstraint。這些欄位現在會如預期傳回 BitmapConstraint。這項限制僅適用於 LevelControl 特徵指令中的 optionsMask 和 optionsOverride 位元對應。

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲可能會增加。
  • 中樞裝置恢復原廠設定後，裝置可能會顯示為離線。
  • 如果在初始化之前或初始化完成前呼叫 Discovery API，系統會擲回 HomeException，並顯示 code 14: UNKNOWN 和「No route found.」訊息。
    • 解決方法：只有在實際需要自動化候選人時，才呼叫 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 的結構中：
    • Matter 裝置可能會在 Google Home 應用程式中顯示為離線。
    • Google 助理無法控制 Matter 裝置。
    • 智慧螢幕無法控制 Matter 裝置，也無法顯示任何 Matter 裝置的狀態。
  • 部分裝置可能無法隨時反映準確狀態，且應用程式回報的狀態可能與 Google 應用程式 (例如 Google Home 應用程式) 回報的狀態不同。這通常是因為裝置未向 Google 回報狀態。
    • 解決方法：使用 Google 應用程式檢查狀態，即可解決不符問題。

2025-01-14

更新了 Home API 的初始化指南。

我們已明確指出應將 Home 執行個體初始化為內容單例模式。確保應用程式提供更流暢的使用者體驗，並避免無效工作階段發生錯誤。

2025-01-07

  Home API 公開 Beta 版發布  

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

這個版本修正了錯誤，並提升了 Android 版 Home API 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 的結構中：
    • Matter 裝置可能會在 Google Home 應用程式 (GHA) 中顯示為離線。
    • Google 助理無法控制 Matter 裝置。
    • 智慧螢幕無法控制 Matter 裝置，也無法顯示任何 Matter 裝置的狀態。
  • 對於部分裝置，應用程式可能無法一律反映準確狀態，且應用程式回報的狀態可能與 Google 應用程式 (例如 Google Home 應用程式 (GHA)) 回報的狀態不同。這通常是因為裝置未向 Google 回報狀態。
    • 解決方法：使用 Google 應用程式檢查狀態，即可解決不符問題。

已修正的已知問題

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