透過 Google 的居家開發人員計畫,裝置製造商可將智慧住宅裝置連結至 Google Home 生態系統。我們將擴充智慧型住家動作的本機執行路徑,讓您使用 Google Home app (GHA) 新增 Matter 裝置並進行設定,然後使用 Google Assistant、GHA 或智慧螢幕 (例如 Google Nest Hub (2nd gen)) 控制這些裝置。
這份文件說明如何開始建構及整合 Google Home 生態系統中支援 Matter 的平台。
免責事項
請注意,說明文件Matter中描述的程序有以下事項:
- 建議您用於開發的帳戶只連線一個已啟用Matter的中樞裝置,以進行測試。測試期間,如果同時連線多個支援 Matter 的中樞,或連線至相同結構,可能會導致無法預測的行為。
- 所有程序都假設使用執行 Ubuntu 20.04 的 Linux 電腦,建構及刷寫 Matter 範例,這些範例已由 Google 測試。雖然支援 macOS 電腦,但建議使用 Linux。程序中會視需要標示 Mac 專屬的操作說明。
如何建構
如要建構與 Google Home 生態系統整合的 Matter 裝置,您需要使用與 Matter 相容的開發板和 Matter SDK。
如要輕鬆入門,建議先完成我們的程式碼研究室。建議您至少完成下列其中一個程式碼研究室:
接著,請查看支援的裝置清單,確認您打算整合的裝置是否支援 Google Home 生態系統。接著詳閱開發人員檢查清單,瞭解從專案建立到發布的完整開發流程。
定義
本說明文件會使用下列字詞:
- 邊界路由器
- 中樞裝置,可為支援 Thread 的裝置實作一般用途的Thread邊界路由器。
- 中樞
- 支援的 Google Nest 裝置,例如 Google Nest Hub (2nd gen)。 如要透過其他介面 (例如 Assistant、GHA 和智慧螢幕) 控制支援 Matter 的裝置,必須使用中樞裝置。
- Matter 裝置
- 已刷入啟用Matter功能的版本或範例應用程式的裝置或開發板。
- 行動裝置
- 用於輔助配對的測試手機。目前這是 Android 手機。
必要條件
如要將支援 Matter 的裝置完整整合至 Google Home 生態系統,開發人員必須具備下列條件:
- 支援 Thread 的 Google 中樞裝置,可做為支援 Thread 裝置的邊界路由器,以及轉送智慧型住宅意圖的本機執行要求路徑。
- 符合最低需求的行動裝置 (測試手機):
- Android O (8.1,API 級別 27 以上版本)
- iOS (16.5 以上版本)
- BLE 功能
- 支援 Matter的裝置的供應商 ID (VID) 和產品 ID (PID)。
- 支援 Matter 的裝置。這部裝置應屬於 Matter Google Home 生態系統支援的裝置類型,可以是:
- 韌體已啟用 Matter 的自有產品。
- 下列其中一種Matter裝置,可用於端對端驗證:
供應商 | 平台 | Thread 支援服務 | 指南 |
---|---|---|---|
Bouffalo Lab | BL602 | ||
BL702 | |||
Espressif | ESP32 | OTA 測試 | |
Nordic Semiconductor | nRF52840 DK | OTA 測試 | |
NXP | IOTZTB-DK006 開發套件 | ||
Realtek | Ameba D 系列 | ||
Silicon Labs | EFR32MG24 開發套件 | ||
EFR32MG Zigbee 和 Thread 入門套件 | |||
Telink | TLSR9518 | ||
德州儀器 | CC2652R7 LaunchPad 開發套件 |
供應商 ID
根據預設,您可以使用 CSA 分配的其中一個 VID 進行測試。選取下列其中一個選項:0xFFF1
、0xFFF2
、0xFFF3
、0xFFF4
。
如要使用正式版 VID,以便認證及發布整合服務,您必須先請 Google 驗證該 VID,確保是由 CSA 核發給您。
這個 VID 應實作於裝置的韌體中。
在特定供應商 ID 和裝置類型情境中,Matter 裝置只能在 Google Home 生態系統中配對。
- 測試 VID 無法用於消費者裝置。
- 正式版 VID 必須由 Connectivity Standards Alliance (Alliance)核發。Google 會先驗證您是否為該 VID 的擁有者,您才能在 Google Home Developer Console 中使用該 VID。完成後,您就能為該 VID 建立整合。
- 為進行開發和 Field Trial,必須在 Developer Console 中建立專案,並整合相應的 VID 和 PID 組合。委派裝置的使用者必須是專案成員,或列在 Field Trial 使用者清單中。
- 消費者使用者必須等到產品通過 Alliance 認證,才能使用產品。
VID 和 PID 只能用於單一整合服務,且只能使用一次。如要在整合中沿用 VID 或 PID,請採取下列任一做法:
- 使用 VID 或 PID 將整合功能編輯為其他 VID 或 PID。
- 使用 VID 或 PID 刪除整合。
哪些類型使用者可將裝置委派至 Google Home 生態系統? | |||
---|---|---|---|
VID 類型 | VID 認證和控制台整合狀態 | 正式版
(消費者使用者) |
開發
(開發人員、Field Trial使用者) |
測試 | Developer Console 中沒有整合服務 (無法認證) | ||
測試 | 整合項目位於 Developer Console (無法通過認證) | ||
正式版 | 未通過認證,整合服務不存在於 Developer Console | ||
正式版 | 未通過認證,但整合項目已存在於 Developer Console | ||
正式版 | 已在 Alliance DCL 中通過認證,但整合服務不存在於 Developer Console | ||
正式版 | 通過 Alliance DCL 認證,且整合功能已存在於 Developer Console 中 |
產品 ID
系統會從「基本資訊叢集」Matter讀取裝置資訊。裝置韌體中編碼的產品 ID 必須與開發人員控制台中的 Matter 整合產品 ID 相符。
不支援的功能
部分Matter叢集尚未向使用者公開,但系統可能會使用這些叢集。在大多數情況下,這表示透過這些叢集公開的屬性不會向使用者顯示:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
¹ 請參閱「開啟/關閉燈具開關」,瞭解這項異動對開啟/關閉燈具開關的影響。