Home APIs Android SDK 版本資訊

2026-10-22

  Home API 正式發布版 1.11.1  

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

最低版本

新功能

其他重要異動

已知問題

  • 攝影機重新啟動後，連線狀態可能會顯示為 PARTIAL_ONLINE，而非 ONLINE。除了 Matter 停用功能外，所有雲端攝影機功能都會繼續正常運作。

2026-09-23

  Home API 正式發布版 1.11  

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

最低版本

重要更新

新功能

其他重要異動

2026-09-16

我們推出了兩個新的 MCP 伺服器。Home MCP 可讓個人代理安全地與智慧型住宅互動，Home Developer MCP 則可讓您慣用的代理搜尋及查詢 Home Developer Center 的說明文件和其他智慧型住宅資源。

新功能

2026-09-16

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

範例應用程式

2026-08-28

  Home API 正式發布版 1.10.1  

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

最低版本

重要更新

新功能

其他重要異動

2026-08-07

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

範例應用程式

2026-08-03

  Home API 正式發布版 1.10  

這個版本修正了錯誤，並將 Home API Android SDK 升級至正式發布品質。

最低版本

2026-07-09

forceLaunch 旗標已淘汰。應用程式應改用 ForcePermissionFlow 列舉，指定同意聲明使用者介面行為。

近期異動內容

2026-07-08

Android 邊界路由器裝置指南現已推出。

新內容

2026-07-07

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

範例應用程式

2026-06-26

  Home API 公開測試版 1.9.1  

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

最低版本

新功能

已修正的已知問題

  • Google Nest Cam (室外型，有線版，第 2 代)、Google Nest Cam (室內型，有線版，第 3 代) 和 Doorbell (有線版，第 3 代) 裝置型號不支援快速配對功能。

2026-06-09

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

範例應用程式

2026-05-29

  Home API 公開測試版 1.9  

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

最低版本

新功能

已知問題

  • Google Nest Cam (室外型，有線版，第 2 代)、Google Nest Cam (室內型，有線版，第 3 代) 和 Doorbell (有線版，第 3 代) 裝置型號不支援快速配對功能。

2026-05-26

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

範例應用程式

2026-05-01

  Home API 公開測試版 1.8.1  

這個版本修正了錯誤，並提升 Home API Android 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 公開測試版 1.8  

這個版本修正了錯誤，並提升 Home API Android 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 中樞韌體、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 公開測試版 1.7.1  

這個版本修正了錯誤，並提升 Home API Android 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 中樞韌體、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 Hub 可能會誤報 Matter 裝置離線。
  • 「目前的攝影機裝置軟體版本」可能不會顯示正確的軟體版本。
  • 溫度控制器使用者介面滑桿顯示超出範圍的溫度。
  • 設定電鈴響鈴時間長度後，裝置不會在指定時間長度內響鈴。

2026-02-13

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

範例應用程式

2026-02-09

  Home API 公開測試版 1.7  

這個版本修正了錯誤，並提升 Home API Android 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 中樞韌體、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) 線上狀態。請改用目標裝置狀態服務 (TDSS) 地圖，找出來源為 LOCAL_SYNC 的裝置。

2025-12-22

  Home API 公開測試版 1.6  

這個版本修正了錯誤，並提升 Home API Android 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 中樞韌體、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 範例應用程式中嘗試新增帳戶時，系統顯示「使用者取消權限流程」錯誤。解決方法：透過 Android 裝置設定新增 Google 帳戶。
  • 使用 Android Home API SDK 連結的 Walmart onn 有線監視攝影機，無法透過 Google Home 應用程式直播。
  • 在 Home API 應用程式中設定的攝影機，無法透過 Google Home 應用程式啟動直播工作階段。

2025-10-23

  Home API 公開測試版 1.5.1  

這個版本修正了錯誤，並提升 Home API Android 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 範例應用程式新增門鈴裝置類型支援 (OnOff、Livestream、對講) 和 Hub Activation API 實作。

已修正的已知問題

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

2025-09-26

  Home API 公開測試版 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 切換至行動網路時，裝置控制延遲時間可能會增加。
  • 在範例應用程式中，可能無法控制由雲端對雲端支援的風扇裝置類型。

2025-08-29

  Home API 公開測試版 1.4.1  

這個版本修正了錯誤，並提升 Home API Android 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 公開測試版 1.4.0  

這個版本修正了錯誤，並提升 Home API Android 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 公開測試版 1.3.2  

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

最低版本

  • Google Play 服務：25.23.31
  • Google Hub 韌體、Cast、Google Home、Google Home Mini 和 Google Nest Mini：3.75.468362
  • Google Hub 韌體、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 公開測試版 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 公開測試版 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 公開測試版 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 日前提供給所有裝置。

新功能

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

已知問題

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

已修正的已知問題

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

2025-03-14

  Home API 公開測試版 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 裝置類型和叢集。

新功能

已知問題

  • 從 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 公開測試版 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 裝置類型和叢集。

新功能

  • Streaming API：
    • 提供事件串流，通知已新增、變更和移除的住家結構體、房間和裝置。
    • 請參閱「訂閱實體關係事件」。
  • Batching API (實驗功能)：

已知問題

  • 載入、建立及編輯自動化動作時，使用者可能需要等待較長時間。
  • 從「相機」應用程式啟動設定流程的使用者必須掃描 QR code 兩次，才能完成 Matter 啟用程序。
  • 如果住家結構包含超過 200 部裝置，Discovery API 可能不會傳回任何候選項目。

已修正的已知問題

  • 切換登入的 Google 帳戶可能會失敗，並導致錯誤。
  • Google TV 裝置可能不支援使用 MediaPlayback 特性的自動化動作。
  • 在僅含 Google 中樞的住家中：
    • Matter 裝置在 Google Home 應用程式中可能顯示為離線。
    • Google 助理無法控制 Matter 裝置。
    • 智慧螢幕無法控制 Matter 裝置，也無法顯示任何 Matter 裝置的狀態。
  • 在某些裝置上，應用程式不一定會反映準確的狀態，而且應用程式回報的狀態可能與 Google 應用程式 (例如 Google Home 應用程式) 回報的狀態不同。這通常是因為裝置未向 Google 回報狀態。
    • 解決方法：使用 Google 應用程式檢查狀態，即可解決不一致的問題。

2025-01-14

更新 Home API 初始化指南。

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

2025-01-07

  Home API 公開測試版  

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

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

已知問題

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

已修正的已知問題

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