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 zacząć tworzyć i integrować platformę obsługującąMatter w ekosystemie Google Home.
Wyłączenia odpowiedzialności
W przypadku procedur opisanych w Matterdokumentacji pamiętaj o tych kwestiach:
- Zalecamy, aby konto używane do programowania miało połączony tylko jeden hub z obsługą Matter na potrzeby testowania. Wiele włączonych koncentratorówMatter podłączonych w tym samym czasie lub podłączonych 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 kompilowania i flashowania Matter próbek, które zostały przetestowane przez Google. Komputery z systemem macOS są obsługiwane, ale zalecamy korzystanie z systemu Linux. W procedurach w razie potrzeby podajemy instrukcje dotyczące komputerów Mac.
Sposób tworzenia
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 chcesz 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 jej 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 router graniczny dla urządzeń z Thread.
- Centrum
- Obsługiwane urządzenie Google Nest, np. Google Nest Hub (2nd gen). Do sterowania urządzeniami z Matter na innych platformach, takich jak Assistant, GHA i inteligentne wyświetlacze, wymagany jest hub.
- Urządzenie obsługujące Matter
- Urządzenie lub płytka deweloperska z wgraną wersją lub aplikacją przykładową z włączoną funkcją 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 standard Matter z ekosystemem Google Home, deweloper musi mieć:
- Centrala Google z obsługą Thread, która będzie pełnić funkcję border router dla urządzeń obsługujących Thread i lokalną ścieżkę 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)
- Możliwości BLE
- Identyfikator dostawcy (VID) i identyfikator produktu (PID) urządzenia z Matter.
- urządzenie obsługujące Matter; Urządzenie powinno być jednym z
typów urządzeń obsługiwanych w
ekosystemie Google Home. Może to być:
- Matter
- własny produkt z oprogramowaniem układowym obsługującym Matter;
- Jedno z tych urządzeń Matter 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 | EFR32MG24 Dev Kit | ||
| Zestaw startowy EFR32MG Zigbee i Thread | |||
| Telink | TLSR9528 | Przewodnik dla programistów dotyczący Telink Matter | |
| Texas Instruments | Zestaw deweloperski CC2652R7 LaunchPad |
Identyfikator dostawcy
Domyślnie możesz użyć jednego z identyfikatorów VID przydzielonych przez Alliance na potrzeby testowania. Wybierz jedną z tych opcji: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Aby używać identyfikatora VID w wersji produkcyjnej, który umożliwi certyfikację i wdrożenie integracji, musisz najpierw uzyskać jego weryfikację przez Google. Dzięki temu będziemy mieć pewność, że został on wydany przez Alliance.
Ten identyfikator VID powinien być zaimplementowany w oprogramowaniu urządzenia.
Matter Urządzenie można sparować w ekosystemie Google Home tylko w określonych scenariuszach dotyczących 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 sprawdzi, 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 w Developer Console musi zostać utworzony projekt i integracja z odpowiednią kombinacją VID i PID. Użytkownik, który uruchamia urządzenie, musi być członkiem projektu lub znajdować się na liście użytkowników Field Trial.
- Użytkownicy mogą korzystać z Twojego produktu dopiero po uzyskaniu certyfikatu od Alliance.
Identyfikator VID i PID można wykorzystać tylko raz w przypadku jednej integracji. Jeśli chcesz używać w integracji tego samego identyfikatora VID lub PID, 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ą | Produkcyjna
(użytkownicy indywidualni) |
Prace rozwojowe
(Deweloperzy, Field Trial użytkowników) |
| Test | Brak integracji w Developer Console (nie można jej certyfikować) | ||
| 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 usłudze Developer Console | ||
| Produkcja | Certyfikat w Alliance DCL, integracja nie istnieje w Developer Console | ||
| Produkcja | Certyfikat w 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 Matter integracji w Developer Console.
Nieobsługiwane funkcje
Niektóre Matter klastry nie są jeszcze widoczne 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:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Informacje o tym, jak to wpływa na włączniki/wyłączniki światła, znajdziesz w sekcji Włączniki/wyłączniki światła.