開始使用 Matter

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。

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

完成後，請查看支援的裝置清單，確認 Google Home 生態系統支援您要整合的項目。然後詳閱開發人員檢查清單，瞭解從建立專案到發布專案之間的整個開發流程。

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

定義

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

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

先備知識

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

如要將支援 Matter 的裝置與 Google Home 生態系統完全整合，開發人員必須：

  1. 支援 Thread 的 Google 中樞，可做為支援 Thread 裝置的邊界路由器，以及做為轉送智慧型住宅意圖的本機執行要求路徑。
  2. 符合基本規格要求的行動裝置 (測試手機)：
    • Android O (8.1，API 級別 27 以上)
    • iOS (16.5 以上版本)
    • BLE 功能
  3. 已啟用 Matter 裝置的供應商 ID (VID) 和產品 ID (PID)。
  4. 支援 Matter 的裝置。這部裝置應為 Google Home 生態系統支援的 Matter 裝置類型之一，可能的類型如下：
    • 你擁有支援 Matter 韌體的產品。
    • 請在下列 Matter 裝置上，執行端對端驗證程序：
表格：Matter 晶片供應商提供的示例
供應商 平台 Thread 支援服務 指南
水牛實驗室 BL602
BL702
義式濃縮 ESP32 OTA 測試
北歐半導體 nRF52840 DK OTA 測試
NXP IOTZTB-DK006 開發套件
Realtek Ameba D 系列
Silicon Labs EFR32MG24 開發套件
EFR32MG Zigbee 和 Thread 入門套件
網頁連結 TLSR9518
德州樂器 CC2652R7 LaunchPad 開發套件

供應商 ID

根據預設，您可以使用 CSA 分配的其中一個 VID 進行測試。選取下列其中一個選項：0xFFF1、0xFFF2、0xFFF3、0xFFF4。

如要使用正式版 VID，以便通過認證及推出整合作業，您必須先完成 Google 驗證，確認 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 必須與 Play 管理中心中 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 請參閱開啟/關閉燈具開關，瞭解這對開啟/關閉燈具開關有何影響。

下一頁
開發人員檢查清單