Google 的 Google Home 開發人員計畫可讓裝置製造商將智慧住宅裝置連結至 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 專屬的操作說明。
建構方式
如要建構支援 Matter 且可整合 Google Home 生態系統的裝置,您必須使用 Matter 相容的開發板和 Matter SDK。
最簡單的入門方式,就是參閱我們的程式碼研究室。建議您至少完成下列其中一個程式碼研究室:
排解 Matter 整合錯誤
Updated 2025年2月12日
瞭解如何排解 Monitoring 指標和 Google Cloud 記錄檔。
Matter 虛擬裝置
Updated 2024年12月20日
這個獨立桌面應用程式提供 Matter 虛擬裝置的視覺狀態和控制項。
Google Home UI Automator
Updated 2024年3月6日
透過 Google Home 應用程式自動執行調試作業。
ZCL 進階平台 (ZAP)
Updated 2023年9月1日
ZCL 進階平台 (ZAP) 是一種 node.js 範本引擎,是以 Matter 叢集為基礎。
Android Studio 專用的 Google Home 外掛程式
Updated 2023年6月1日
這個外掛程式可讓您使用「Google 助理模擬器」、「Cloud Logging」以及其他工具來簡化智慧型住宅開發流程。
VS Code 適用的 Google Home 擴充功能
Updated 2022年5月31日
使用 Google Home 擴充功能,即可使用 Google 助理模擬器、Cloud Logging 和其他工具來簡化智慧型住宅開發流程。
Matter 適用的 Cloud Monitoring
Updated 2022年2月1日
監控智慧住宅動作的使用情形。
Matter 適用的 Cloud Logging
Updated 2022年2月1日
瞭解 Google Cloud 提供的 Matter 記錄分析功能。
接著,請查看支援的裝置清單,確認你打算整合的裝置是否受 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 的裝置。此裝置應為 Google Home 生態系統支援的 Matter 裝置類型之一,可能為:
- 您自有產品,且支援 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 | ||
Texas Instruments | CC2652R7 LaunchPad 開發套件 |
供應商 ID
根據預設,您可以使用 CSA 分配的 VID 進行測試。請選取下列其中一個:0xFFF1
、0xFFF2
、0xFFF3
、0xFFF4
。
如要使用正式版 VID,讓整合功能通過認證並推出,您必須先讓 Google 驗證該 VID,確保該 VID 是由 CSA 核發給您。
這個 VID 應在裝置的韌體中實作。
Matter 裝置只能在特定供應商 ID 和裝置類型情境下,在 Google Home 生態系統中配對。
- 測試 VID 無法用於消費性裝置。
- 您的製作 VID 必須由 Connectivity Standards Alliance (Alliance) 核發。您必須先讓 Google 驗證您是否為該 VID 的擁有者,才能在 Google Home Developer Console 中使用該 ID。完成後,您就能為該 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 |
|