Pierwsze kroki ze standardem Matter

Program dla deweloperów Google Home umożliwia producentom urządzeń łączenie ich inteligentnych urządzeń domowych z ekosystemem Google Home. Rozszerzamy lokalną ścieżkę realizacji za pomocą akcji domowych, umożliwiając dodawanie urządzeń z funkcją Matter do konfiguracji za pomocą Google Home app (GHA) i sterowanie nimi za pomocą Google Assistant, GHA lub inteligentnych wyświetlaczy, takich jak Google Nest Hub (2nd gen).

Ta dokumentacja opisuje, jak rozpocząć tworzenie i integrowanie platformy obsługiwanej przez Matter w ekosystemie Google Home.

Wyłączenia odpowiedzialności

W przypadku procedur opisanych w dokumentacji Matter:

• Zalecamy, aby na koncie używanym do programowania było połączone tylko 1 centrum z włączoną funkcją Matter na potrzeby testowania. Podczas testowania połączenie kilku koncentratorów z włączoną funkcją Matter połączonych w tym samym czasie lub połączonych z tą samą strukturą może powodować nieprzewidywalne działanie.
• Wszystkie procedury zakładają użycie maszyny z systemem Linux i Ubuntu 20.04 do kompilowania i programowania próbek Matter, które zostały przetestowane przez Google. Komputery z systemem macOS są obsługiwane, ale zalecamy korzystanie z Linuksa. W razie potrzeby w procedurach znajdują się instrukcje dotyczące Maca.

Jak tworzyć

Aby stworzyć urządzenie z funkcją Matter, które będzie integrować się z ekosystemem Google Home, musisz użyć płytki rozwojowej zgodnej z Matter i pakietu MatterSDK.

Najłatwiej zacząć od naszych ćwiczeń w Codelabs. Zalecamy wykonanie co najmniej jednego z tych laboratoriów programowania:

Następnie sprawdź na naszej liście obsługiwanych urządzeń, czy to, co planujesz zintegrować, jest obsługiwane w ekosystemie Google Home. Następnie zapoznaj się z listą kontrolną dla deweloperów, aby poznać cały proces tworzenia od utworzenia projektu do jego opublikowania.

Obsługiwane urządzenia Lista kontrolna dla programistów

Definicje

W tej dokumentacji używamy tych terminów:

Router graniczny

Hub, który implementuje ogólny Thread BorderRouter dla urządzeń z Thread.

Centrum

Obsługiwane urządzenie Google Nest, takie jak Google Nest Hub (2nd gen). Aby sterować urządzeniami z wsparciem Matter za pomocą innych urządzeń, takich jak Assistant, GHA i inteligentne ekrany, wymagane jest centrum.

Urządzenie obsługujące Matter

Urządzenie lub płytka rozwojowa z flashowanym obrazem kompilacji z obsługą Matter lub przykładową aplikacją.

Urządzenie mobilne

Testowy telefon, który pomaga w sparowaniu. Obecnie jest to telefon Android.

Wymagania wstępne

Aby w pełni zintegrować urządzenie z usługą Matter z ekosystemem Google Home, deweloper musi mieć:

1. Centrala Google z obsługą Thread, która będzie pełnić funkcję routera granicznego dla urządzeń obsługujących Thread oraz lokalną ścieżkę realizacji do kierowania intencji inteligentnego domu.
2. Urządzenie mobilne (telefon testowy) spełniające minimalne wymagania:
   • Android O (8.1, poziom interfejsu API 27 lub nowszy)
   • iOS (w wersji 16.5 lub nowszej)
   • Obsługa BLE
3. Identyfikator dostawcy (VID) i identyfikator produktu (PID) urządzenia z funkcją Matter.
4. urządzenie z obsługą Matter, To urządzenie powinno być jednym z Matter typów urządzeń obsługiwanych w ekosystemie Google Home. Może to być:
   • własny produkt z oprogramowaniem z obsługą Matter.
   • Jedno z tych urządzeń Matter do przeprowadzania kompleksowej weryfikacji:

Identyfikator dostawcy

Domyślnie możesz używać jednego z identyfikatorów VID przydzielonych przez CSA na potrzeby testowania. Wybierz jedną z tych opcji:0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Aby móc korzystać z VID w wersji produkcyjnej, a tym samym uzyskać certyfikat i wdrożyć integrację, musisz najpierw poprosić Google o jego weryfikację. W ten sposób upewnisz się, że certyfikat został wydany przez CSA.

Ten identyfikator VID powinien być zaimplementowany w oprogramowaniu urządzenia.

Urządzenie Matter można sparować w ekosystemie Google Home tylko w określonych scenariuszach identyfikatora dostawcy i typu urządzenia.

• Testowego identyfikatora VID nie można używać na urządzeniu konsumenta.
• Twój identyfikator VID musi zostać wydany przez Connectivity Standards Alliance (Alliance). Zanim będzie można użyć VID w Google Home Developer Console, Google musi zweryfikować, czy jesteś właścicielem tego identyfikatora. Gdy to zrobisz, będziesz mieć możliwość tworzenia integracji z tym VID.
• Na potrzeby rozwoju i Field Trial należy utworzyć projekt i integrację z odpowiednią kombinacją VID i PID w Developer Console. Użytkownik, który zleca użycie urządzenia, musi być członkiem projektu lub znajdować się na liście użytkowników Field Trial.
• Konsumenci mogą korzystać z Twojego produktu dopiero po uzyskaniu certyfikatu Alliance.

Identyfikatory VID i PID można użyć tylko raz w ramach jednej integracji. Jeśli chcesz użyć w integracji tego samego identyfikatora VID lub PID, musisz:

• Zmień integrację z użyciem VID lub PID na inny VID lub PID.
• Usuń integrację za pomocą identyfikatora VID lub PID.

Tabela: identyfikator dostawcy (VID) i typ urządzenia w scenariuszach parowania

		Które typy użytkowników mogą włączyć urządzenie do ekosystemu Google Home?
Typ VID	Stan certyfikacji VID i integracji z konsolą	Produkcyjna (użytkownicy indywidualni)	Na potrzeby rozwoju (użytkownicy Field Trial)
Test	Brak integracji w Developer Console (nie można uzyskać certyfikatu)
Test	Integracja jest dostępna w ramach Developer Console (nie można uzyskać certyfikatu)
Produkcja	Niecertyfikowana, integracja nie istnieje w Developer Console
Produkcja	Niecertyfikowana integracja dostępna w Developer Console
Produkcja	Certyfikat w Alliance DCL, integracja nie istnieje w Developer Console
Produkcja	Certyfikat w ramach Alliance DCL i istnienie integracji w Developer Console

Identyfikator produktu

Informacje o urządzeniu są odczytywane z Matter klastra informacji podstawowych. Identyfikator produktu zakodowany w oprogramowaniu urządzenia musi być zgodny z identyfikatorem produktu integracji Matter w Konsoli deweloperów.

Nieobsługiwane funkcje

Niektóre klastry Matter nie są jeszcze dostępne dla użytkowników, ale mogą być używane przez system. W większości przypadków oznacza to, że atrybuty udostępniane przez te klastry nie są widoczne dla użytkowników:

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.

¹ Aby dowiedzieć się, jak to wpływa na włączniki światła, zapoznaj się z artykułem Włączniki światła.