開發人員預覽版
Google 的 Home 開發人員計劃可讓裝置製造商將智慧型住宅裝置與 Google Home 生態系統連結。我們擴充了 Smart Home Actions 本地執行路徑,其中包括新增在 Matter 上在 Android 上使用 Google Home app (GHA) 設定的裝置,並使用 Google Assistant、GHA 或 Google Nest Hub (2nd gen) 等智慧螢幕來控制這些裝置。
這份文件說明如何在 Google Home 生態系統中建構及整合Matter支援的平台。
免責事項
關於本「Matter」開發人員預覽版中所述的程序,請注意下列事項:
- 用於開發的帳戶應只連結一個啟用 Matter 的中樞來進行測試。在多個測試中,如果同時啟用多個 Matter 或連結相同的結構,可能會導致無法預測的行為。
- 所有程序都假定使用執行 Ubuntu 20.04 的 Linux 機器來建構和重新整理 Matter 範例,這些樣本已通過 Google 測試。雖然系統支援 MacOS 電腦,但建議使用 Linux。您可以視需要在程序中呼叫 Mac 專用的操作說明。
- 僅支援 GHA 的 Android 版本。
定義
本說明文件使用下列字詞:
- 邊界路由器
- 集線器為 Thread 啟用裝置實作一般 Thread 邊界路由器。
- 中樞
- 支援的 Google Nest 裝置,例如 Google Nest Hub (2nd gen)。需要透過 Hub、透過 Assistant、GHA 和智慧螢幕等其他介面控制支援 Matter 的裝置。
- Matter 部裝置
- 在透過 Matter 啟用的建構或範例應用程式中刷新的裝置或開發板。
- 行動裝置
- 用來協助配對的測試手機。目前這是 Android 手機。
必要條件
必須將支援 Matter 的裝置與 Google Home 生態系統完整整合,開發人員必須有:
- 支援 Thread 的 Google 中心,做為支援 Thread 裝置的邊界路由器,做為轉送智慧住宅意圖的本機執行路徑。
- 符合基本需求的行動裝置 (測試手機):
- Android O (8.1,API 等級 27) 以上版本 (稍後支援 iOS 支援功能)
- BLE 功能
- 啟用 Matter 的供應商 ID (VID) 和產品 ID (PID)。
- Matter 裝置。此裝置應為 Google Home 生態系統目前支援的 Matter 裝置類型之一,可能原因如下:
- 您的專屬產品 (啟用 Matter 韌體)。
- 支援廠商平台的開發板,可做為支援 Matter 的裝置進行端對端驗證。系統支援下列平台:
廠商 | 平台 | 指南 | Thread 支援服務 |
---|---|---|---|
Bouffalo Lab | BL602 問卷調查 | 快速入門 | |
品牌提升 702 | 快速入門 | ||
濃縮咖啡 | ESP32 | 快速入門
OTA 測試 |
|
北歐半導體 | nRF52840 丹麥克朗 | 快速入門
OTA 測試 |
|
特許 | IOTZTB-DK006 開發套件 | 快速入門 | |
Realtek | Ameba D 系列 | 快速入門 | |
Silicon Labs | EFR32MG Zigbee 和 Thread Starter Kit | 快速入門 | |
EFR32MG24 Dev Kit | 快速入門 | ||
連結 | TLSR9518 | 快速入門 |
供應商 ID
根據預設,您可以使用 CSA 分配的其中一個 VID 進行測試。選擇下列其中一個選項:0xFFF1
、0xFFF2
、0xFFF3
、0xFFF4
。
您必須先通過 Google 驗證,才能使用整合產品 VID 進行整合及推出整合,以確保 CSA 已核發給您。
請在裝置的韌體中實作此 VID。
在特定供應商 ID 和裝置類型情境中,Matter 裝置只能與 Google Home 生態系統配對。
- 無法在消費者的裝置上使用測試 VID。
- 針對生產環境 (消費性) 裝置進行配對,該裝置必須通過 CSA DCL 認證。
- 基於開發和現場試用的目的,裝置必須在 Google Home Developer Console 中註冊。
哪些類型的使用者可以將裝置送入 Google Home 生態系統? | |||
---|---|---|---|
VID 類型 | VID 認證和註冊狀態 | 正式版
(消費者使用者) |
開發
(開發人員、實測使用者) |
Test | 未報名 (未通過認證) | 無 | 無 |
Test | 已註冊 Developer Console (無法取得認證) | 無 | |
實際工作環境 | 未經認證,尚未註冊 | 無 | |
實際工作環境 | 未經認證,已於Developer Console註冊 | ||
實際工作環境 | 通過 CSA DCL 認證,未註冊 | 無 | |
實際工作環境 | 通過 CSA DCL 認證,並向 Developer Console 註冊 |
產品 ID
使用 Matter 描述元叢集 (而非產品 ID) 讀取裝置相關資訊。在開發期間,您可以根據公司編號配置指派任何產品 ID,只要該 ID 與您 Matter 整合的產品 ID 相符 (如有指定的話)。
不支援的功能
部分 Matter 叢集尚未向使用者顯示,但系統可能會供叢集使用。在大多數情況下,這表示使用者無法看到透過這些叢集公開的屬性:
叢集類型 | 叢集 |
---|---|
Core |
|
應用程式 |
|