Program Google Home Developer umożliwia producentom urządzeń łączenie inteligentnych urządzeń domowych z ekosystemem Google Home. Rozszerzamy ścieżkę lokalnej realizacji działań związanych z inteligentnym domem o możliwość dodawania urządzeń z Matter do konfiguracji za pomocą Google Home app (GHA) i sterowania nimi za pomocą Google Assistant, GHA lub inteligentnych wyświetlaczy, takich jak Google Nest Hub (2nd gen).
Z tej dokumentacji dowiesz się, jak rozpocząć tworzenie i integrowanie platformy obsługującejMatter w ekosystemie Google Home.
Wyłączenia odpowiedzialności
W przypadku procedur opisanych w Matterdokumentacji pamiętaj o tych kwestiach:
- Zalecamy, aby na koncie używanym do programowania był połączony tylko jeden hub z włączoną funkcjąMatter, który służy do testowania. Wiele hubów z obsługą Matter podłączonych w tym samym czasie lub do tej samej konstrukcji podczas testowania może powodować nieprzewidywalne działanie.
- Wszystkie procedury zakładają użycie komputera z systemem Linux Ubuntu 20.04 do tworzenia i flashowania Matter próbek, które zostały przetestowane przez Google. Komputery z systemem macOS są obsługiwane, ale zalecamy używanie Linuksa. W procedurach w razie potrzeby podajemy instrukcje dotyczące komputerów Mac.
Jak tworzyć
Aby stworzyć urządzenie z Matter, które będzie zintegrowane z ekosystemem Google Home, musisz użyć płytki deweloperskiej zgodnej z Matter i pakietu Matter SDK.
Najłatwiej zacząć od naszych ćwiczeń w Codelabs. Zalecamy wykonanie co najmniej jednego z tych ćwiczeń:
Następnie sprawdź naszą listę obsługiwanych urządzeń, aby upewnić się, że urządzenie, które 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 aplikacji od utworzenia projektu do wprowadzenia go na rynek.
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ólnego przeznaczenia Thread router graniczny dla urządzeń obsługujących Thread.
- Hub
- Obsługiwane urządzenie Google Nest, np.Google Nest Hub (2nd gen). Do sterowania urządzeniami obsługującymi Matter za pośrednictwem innych powierzchni, takich jak Assistant, GHA i inteligentne wyświetlacze, wymagany jest koncentrator.
- Urządzenie obsługujące Matter
- Urządzenie lub płyta deweloperska, do której wgrano kompilację lub przykładową aplikację obsługującą Matter.
- Urządzenie mobilne
- Telefon testowy używany do pomocy przy parowaniu. Obecnie jest to telefon Android.
Wymagania wstępne
Aby w pełni zintegrować urządzenie obsługujące Matter z ekosystemem Google Home, deweloper musi mieć:
- Hub Google z obsługą Thread, który będzie pełnić funkcję routera granicznego dla urządzeń obsługujących Thread i lokalnej ścieżki realizacji do kierowania intencji inteligentnego domu.
- urządzenie mobilne (telefon testowy) spełniające minimalne wymagania:
- Android O (8.1, interfejs API na poziomie 27 lub nowszy)
- iOS (wersja 16.5 lub nowsza)
- Obsługa BLE
- Identyfikator dostawcy (VID) i identyfikator produktu (PID) urządzenia z Matter.
- urządzenie obsługujące Matter; Urządzenie powinno być jednym z Matter typów urządzeń obsługiwanych w ekosystemie Google Home i może być:
- własny produkt z oprogramowaniem układowym obsługującym Matter;
- Jedno z tych Matter urządzeń do weryfikacji kompleksowej:
| Dostawca | Platforma | Pomoc na poziomie: Thread | Przewodnik |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Testowanie OTA | |
| Nordic Semiconductor | nRF52840 DK | Testowanie OTA | |
| NXP | Zestaw deweloperski IOTZTB-DK006 | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | Zestaw deweloperski EFR32MG24 | ||
| Zestaw startowy EFR32MG Zigbee i Thread | |||
| Telink | TLSR9528 | Przewodnik dla programistów Telink Matter | |
| Texas Instruments | Zestaw deweloperski CC2652R7 LaunchPad |
Identyfikator dostawcy
Domyślnie możesz użyć jednego z identyfikatorów VID przydzielonych przez CSA do celów testowych. Wybierz jedną z tych opcji: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Aby używać identyfikatora VID środowiska produkcyjnego, który umożliwi certyfikację i uruchomienie integracji, musisz najpierw uzyskać jego weryfikację przez Google. Dzięki temu będziemy mieć pewność, że został on 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 konsumenckim.
- Identyfikator VID wersji produkcyjnej musi być wydany przez Connectivity Standards Alliance (Alliance). Zanim będzie można użyć identyfikatora VID w Google Home Developer Console, Google zweryfikuje, czy jesteś jego właścicielem. Gdy to zrobisz, będziesz mieć możliwość tworzenia integracji dla tego identyfikatora VID.
- Na potrzeby programowania i Field Trial należy utworzyć projekt i integrację z odpowiednią kombinacją VID i PID w Developer Console. Użytkownik, który uruchamia urządzenie, musi być członkiem projektu lub znajdować się na liście Field Trial użytkowników.
- Użytkownicy mogą korzystać z Twojego produktu dopiero po uzyskaniu certyfikatu Alliance.
Identyfikator VID i PID można wykorzystać tylko raz w przypadku jednej integracji. Jeśli chcesz użyć w integracji tego samego identyfikatora dostawcy lub produktu, musisz:
- Edytuj integrację, zmieniając identyfikator dostawcy lub produktu na inny.
- Usuń integrację za pomocą identyfikatora dostawcy lub produktu.
| Którzy użytkownicy mogą włączyć urządzenie do ekosystemu Google Home? | |||
|---|---|---|---|
| Typ VID | Stan certyfikacji VID i integracji z konsolą | Wersja produkcyjna
(klienci indywidualni) |
Tworzenie
(Deweloperzy, Field Trial użytkowników) |
| Test | Brak integracji w Developer Console (nie można uzyskać certyfikatu) | ||
| Test | Integracja istnieje w Developer Console (nie można jej certyfikować) | ||
| Produkcja | Brak certyfikatu, integracja nie istnieje w Developer Console | ||
| Produkcja | Brak certyfikatu, integracja istnieje w Developer Console | ||
| Produkcja | Certyfikat w Alliance DCL, integracja nie istnieje w AllianceDeveloper Console | ||
| Produkcja | Certyfikat w zakresie Alliance DCL i integracja w Developer Console | ||
Identyfikator produktu
Informacje o urządzeniu są odczytywane z Matterklastra informacji podstawowych. Identyfikator produktu zakodowany w oprogramowaniu urządzenia musi być zgodny z identyfikatorem produktu w integracji Matter w Konsoli dewelopera.
Nieobsługiwane funkcje
Niektóre klastry Matter nie są jeszcze udostępniane użytkownikom, 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:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Informacje o tym, jak to wpływa na włączniki światła, znajdziesz w sekcji Włączniki światła.