Program Google Home Developer umożliwia producentom urządzeń łączenie inteligentnych urządzeń domowych z ekosystemem Google Home. Rozszerzamy ścieżkę realizacji lokalnej akcji inteligentnego domu o możliwość dodawania urządzeń obsługujących Matter, aby można było je skonfigurować za pomocą Google Home app (GHA) i sterować nimi za pomocą Google Assistant, GHA lub inteligentnych ekranów, 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 pamiętaj o tych kwestiach:
- Zalecamy, aby konto używane do programowania miało tylko 1 połączone centrum z włączoną funkcją Matter, które będzie służyć do testowania. Jeśli podczas testowania podłączysz jednocześnie kilka koncentratorów z obsługą Matter lub podłączysz je do tej samej struktury, może to spowodować nieprzewidywalne działanie.
- Wszystkie procedury zakładają użycie komputera z systemem Linux z Ubuntu 20.04 do tworzenia i flashowania próbek Matter, które zostały przetestowane przez Google. Komputery z systemem macOS są obsługiwane, ale zalecamy korzystanie z systemu Linux. W razie potrzeby w procedurach podano instrukcje dotyczące komputerów Mac.
Sposób tworzenia
Aby utworzyć urządzenie obsługujące standard Matter, które integruje się z ekosystemem Google Home, musisz użyć płytki deweloperskiej zgodnej ze standardem Matter i pakietu Matter SDK.
Najłatwiej zacząć od naszych ćwiczeń w Codelabs. Zalecamy wykonanie co najmniej jednego z tych ćwiczeń:
Następnie sprawdź na 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 aplikacji – od utworzenia projektu do jego uruchomienia.
Obsługiwane urządzenia Lista kontrolna dla deweloperów
Definicje
W tej dokumentacji używamy tych terminów:
- Router graniczny
- Centrum, które implementuje router graniczny Thread do zwykłych obciążeń dla urządzeń obsługujących Thread.
- Centrum
- Obsługiwane urządzenie Google Nest, takie jak Google Nest Hub (2nd gen). Aby sterować urządzeniami z włączoną usługą Matter na innych platformach, takich jak Assistant, GHA i inteligentne ekrany, potrzebujesz koncentratora.
- Urządzenie z włączoną usługą Matter
- Urządzenie lub płytka deweloperska z zainstalowaną 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 standard Matter z ekosystemem Google Home, deweloper musi mieć:
- urządzenie Google Hub z obsługą Thread, które będzie działać jako border router dla urządzeń obsługujących Thread oraz jako lokalna ścieżka realizacji do kierowania intencji inteligentnego domu;
- Urządzenie mobilne (telefon testowy) spełniające minimalne wymagania:
- Android O (8.1, poziom API 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 z włączoną usługą Matter. Urządzenie powinno być jednym z Matter typów urządzeń obsługiwanych w ekosystemie Google Home, takich jak:
- Własny produkt z oprogramowaniem układowym obsługującym Matter.
- Jedno z tych urządzeń z Matter, które będzie używane 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 | ||
| EFR32MG Zigbee and Thread Starter Kit | |||
| Telink | TLSR9528 | Przewodnik dla programistów Telink Matter | |
| Texas Instruments | Zestaw deweloperski CC2652R7 LaunchPad |
Identyfikator dostawcy
Domyślnie do celów testowych możesz użyć jednego z identyfikatorów VID przydzielonych przez Alliance. Wybierz jedną z tych opcji: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Aby używać produkcyjnego identyfikatora VID i móc certyfikować oraz uruchomić integrację, musisz najpierw poprosić Google o zweryfikowanie, czy identyfikator został Ci wydany przez Alliance.
Ten identyfikator VID powinien być zaimplementowany w oprogramowaniu układowym urządzenia.
Urządzenie Matter można sparować w ekosystemie Google Home tylko w przypadku niektórych identyfikatorów dostawcy i typów urządzeń.
- Testowego identyfikatora VID nie można używać na urządzeniu konsumenckim.
- Produkcyjny identyfikator VID musi być wydany przez: Connectivity Standards Alliance (Alliance). Zanim będziesz mieć możliwość użycia 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.
- W celach programistycznych i Field Trial projekt i integrację z odpowiednią kombinacją VID i PID należy utworzyć w Developer Console. 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 indywidualni mogą korzystać z Twojej usługi dopiero po jej certyfikacji przez Alliance.
Identyfikatory VID i PID mogą być używane tylko raz w ramach jednej integracji. Jeśli chcesz używać tego samego identyfikatora VID lub PID w integracji, musisz:
- Zmień identyfikator VID lub PID w integracji na inny.
- Usuń integrację za pomocą identyfikatora VID lub PID.
| Którzy użytkownicy mogą dodać urządzenie do ekosystemu Google Home? | |||
|---|---|---|---|
| Typ VID | Certyfikacja VID i stan integracji z konsolą | Produkcyjna
(użytkownicy indywidualni) |
Programowanie
(Programiści, Field Trial użytkowników) |
| Test | Brak integracji w Developer Console (nie można 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 Developer Console | ||
| Produkcja | Certyfikat w DCL Alliance, 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 klastra informacji podstawowych Matter. Identyfikator produktu zakodowany w oprogramowaniu układowym urządzenia musi być zgodny z identyfikatorem produktu integracji Matter w Konsoli Play.
Nieobsługiwane funkcje
Niektóre klastry Matter 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 wpływa to na przełączniki światła, znajdziesz w sekcji Przełączniki światła.