Home APIs Android SDK 版本資訊

2025-03-14

  Home API 公開 Beta 版 1.2.0  

這個版本修正了錯誤，並提升了 Home API Android SDK 的一般可用性 (GA) 品質。

最低版本

  • Google Play 服務最低版本：25.06.32
  • Google 中樞裝置韌體最低版本：
    • Cast 版本：3.75.456944
    • Fuchsia 最低版本：24.20241009.103.1900601
  • Android SDK：home.android.sdk_202412_EAP_1_2_RC01
  • Google Home 應用程式最低版本：支援所有版本
  • androidx.core 程式庫最低版本：1.10.0
  • Matter 版本： 1.3.0.0
    • 注意：系統不支援暫時性 Matter 裝置類型和叢集。

新功能

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

已知問題

  • 從 Wi-Fi 切換至行動網路時，裝置控制延遲時間可能會增加。
  • 恢復原廠設定後，裝置可能會顯示為離線。
  • 如果 Discovery API 是在初始化前或初始化完成前呼叫，系統就會擲回含有 code 14: UNKNOWN 的 HomeException，並顯示「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 的一般可用性 (GA) 品質。

最低版本

  • Google Play 服務最低版本：25.02.32
  • Google 中樞裝置韌體最低版本：
    • 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 版發布  

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

這個版本修正了錯誤，並提升了 Home API Android SDK 的一般可用性 (GA) 品質，包括改善 Google Nest Audio 和 Google TV 裝置的支援功能。

最低版本

  • Google Play 服務最低版本：24.45.34
  • Google 中樞裝置韌體最低版本：
    • 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 帳戶可能會失敗，並導致錯誤。
    • 解決方法：重新執行權限流程或重新啟動應用程式。
  • Google TV 裝置可能無法支援使用 MediaPlayback 特徵的自動化動作。
  • 在僅包含 Google 中樞的結構中：
    • Matter 裝置在 Google Home 應用程式 (GHA) 中可能會顯示為離線。
    • Google 助理無法控制 Matter 裝置。
    • 智慧螢幕無法控制 Matter 裝置或顯示任何 Matter 裝置的狀態。
  • 對於某些裝置，應用程式不一定會反映正確的狀態，而且應用程式回報的狀態可能與 Google 應用程式 (例如 Google Home 應用程式) 回報的狀態不同。這通常是因為裝置未向 Google 回報狀態。
    • 解決方法：使用 Google 應用程式檢查狀態，即可解決不相符的問題。

已修正的已知問題

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