開始使用 Matter

Google 的 Home Developer 計畫可讓裝置製造商將智慧住宅裝置連結至 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。

最簡單的入門方式，就是完成程式碼研究室。三 建議至少執行下列其中一項程式碼研究室：

接著，請查看支援的裝置清單，確認你要整合的裝置是否受 Google Home 生態系統支援。接著，請詳閱開發人員檢查清單，瞭解從專案建立到發布，整個開發流程的所有細節。

支援的裝置 開發人員檢查清單

定義

這份說明文件使用以下字詞：

邊界路由器
為支援 Thread 的裝置實作通用 Thread 邊界路由器的中心。
中樞
支援的 Google Nest 裝置，例如 Google Nest Hub (2nd gen)。必須使用中樞裝置，才能透過中樞裝置控制 Matter 的裝置 其他途徑 (例如 Assistant)、 GHA和智慧螢幕。
已啟用「Matter」的裝置
已刷入支援 Matter 的版本或範例應用程式的裝置或開發板。
行動裝置
用於協助配對的測試手機。目前這是 Android 手機。

必要條件

推薦的 Matter 開發用 IDE 擴充功能

為了將支援 Matter 的裝置與 Google Home 生態系統中，開發人員必須符合以下規定：

  1. 支援 Thread 的 Google 中樞 可做為支援 Thread 裝置的邊界路由器，以及做為 轉送智慧型住宅意圖的執行要求路徑。
  2. 符合最低需求的行動裝置 (測試手機)：
    • Android O (8.1，API 級別 27 以上)
    • iOS (16.5 以上版本)
    • BLE 功能
  3. 應用程式的供應商 ID (VID) 和產品 ID (PID)， 支援 Matter 的裝置。
  4. 支援 Matter 的裝置。這部裝置應為以下兩者之一： Matter Google Home 生態系統，可能包括：
    • 你擁有支援 Matter 韌體的產品。
    • 下列 Matter 裝置之一，用於端對端驗證：
表格：Matter Silicon 供應商提供的範例
供應商 平台 Thread 支援服務 指南
水牛實驗室 BL602
BL702
Espressif ESP32 OTA 測試
北歐半導體 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，確保該 VID 是由 CSA 核發給您。

這個 VID 應在裝置的韌體中實作。

Matter 裝置只能在特定廠商 ID 和裝置類型情境下，在 Google Home 生態系統中配對。

  • 測試 VID 無法用於消費者裝置。
  • 您的製作 VID 必須由 Connectivity Standards Alliance (Alliance) 核發。Google 會 確認您是該 VID 的擁有者，才能在 Google Home Developer Console 中使用該 VID。完成後，您就能為該 VID 建立整合。
  • 為了進行開發和實地測試，您必須在 Developer Console 中建立專案，並整合相應的 VID 和 PID 組合。使用者執行佣金 裝置必須是專案成員或要加入清單 實測使用者比例
  • 消費者使用者只能在產品通過 Alliance 認證後才能使用。
表格：供應商 ID (VID) 和裝置類型 配對情境
哪些類型的使用者可以將裝置納入 Google Home 生態系統？
VID 類型 VID 認證和控制台整合狀態 正式版
(消費者使用者)		 開發
(開發人員、實際測試使用者)
測試 Developer Console 中未整合 (無法認證)
測試 Developer Console 中有整合項目 (不得為 認證)
正式版 未認證，Developer Console 中沒有整合功能
正式版 未通過認證，整合於 Developer Console
正式版 已在 Alliance DCL 中獲得認證，但整合項目並未出現在 Developer Console 中
正式版 已透過「Alliance」資料存取要求 (DCL) 認證及進行整合 在 Developer Console

產品 ID

裝置相關資訊會從以下位置讀取： Matter 基本資訊叢集。原始 ID 中編碼的 裝置的韌體必須與 Matter 整合的產品 ID 相符 。

不支援的功能

部分 Matter 叢集尚未向使用者公開，但系統可能會使用這些叢集。在多數情況下，這表示 使用者不會看到從這些叢集公開的安全漏洞：

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

1 請參閱開啟/關閉燈具開關 ，瞭解這項功能對開啟/關閉燈具開關有何影響。

下一頁
開發人員檢查清單