Program Google Home dla deweloperów pozwala producentom urządzeń połączyć swoje inteligentne urządzenia domowe z ekosystemem Google Home. Rozwijamy lokalną ścieżkę realizacji akcji dotyczących inteligentnych akcji w domu o możliwość dodawania urządzeń obsługujących Matter do konfiguracji za pomocą Google Home app (GHA) i sterowania nimi za pomocą Google Assistant lub GHA albo inteligentnych ekranów takich jak Google Nest Hub (2nd gen).
Z tej dokumentacji dowiesz się, jak zacząć tworzyć i integrować platformę zgodną z 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 ma połączone tylko 1 centrum z włączoną obsługą Matter. Wiele centrów z włączoną obsługą Matter połączonych jednocześnie lub połączonych z tą samą strukturą podczas testowania może powodować nieprzewidywalne zachowanie.
- Wszystkie procedury zakładają użycie komputera z systemem Linux z systemem Ubuntu 20.04 do skompilowania i przeskanowania przykładów Matter, które zostały przetestowane przez Google. Mimo że komputery z systemem macOS są obsługiwane, zalecamy korzystanie z Linuksa. W razie potrzeby instrukcje dla komputerów Mac są opisane w odpowiednich procedurach.
Jak tworzyć
Aby utworzyć urządzenie obsługujące Matter, które integruje się z ekosystemem Google Home, musisz wykorzystać płytę programistyczną zgodną z Matter i pakiet SDK Matter.
Najłatwiej rozpocząć od wykonania naszych ćwiczeń z programowania. Zalecamy wykonanie co najmniej jednego z tych ćwiczeń z programowania:
Następnie przejrzyj listę obsługiwanych urządzeń, aby mieć pewność, że wszystko, co chcesz zintegrować, jest obsługiwane w ekosystemie Google Home. Następnie przeczytaj listę kontrolną dla programistów, aby zrozumieć cały proces programowania od jego utworzenia po uruchomienie.
Obsługiwane urządzenia Lista kontrolna dla programistów
Definicje
W tej dokumentacji używamy tych terminów:
- Router graniczny
- Centrum, które implementuje ogólny router graniczny Thread dla urządzeń obsługujących Thread.
- Centrum
- Obsługiwane urządzenie z systemem Google Nest, takie jak Google Nest Hub (2nd gen). Centrum jest wymagane do sterowania urządzeniami obsługującymi Matter za pomocą innych platform, takich jak Assistant, GHA i inteligentne ekrany.
- Urządzenie z obsługą Matter
- urządzenie lub płytka programistyczna z zainstalowaną kompilacją lub przykładową aplikacją z włączoną obsługą Matter.
- Urządzenie mobilne
- Telefon testowy używany do sparowania. 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ć:
- Centrum Google z obsługą Thread, które będzie pełnić zarówno funkcję routera granicznego dla urządzeń obsługujących Thread, jak i lokalną ścieżkę realizacji 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) dla urządzenia obsługującego Matter.
- Urządzenie obsługujące usługę Matter. Urządzenie powinno należeć do Matter typów urządzeń obsługiwanych obecnie w ekosystemie Google Home. Może to być:
- Twój produkt z oprogramowaniem z obsługą Matter.
- Płytka deweloperska obsługiwanej platformy dostawcy, która może służyć jako urządzenie obsługujące Matter na potrzeby kompleksowej weryfikacji. Obsługiwane są te platformy:
| Dostawca | Platforma | Przewodniki | Pomoc na poziomie: Thread |
|---|---|---|---|
| Laboratorium Bouffalo | BL602 | Krótkie wprowadzenie | |
| BL702 | Krótkie wprowadzenie | ||
| Espressif | ESP32 | Krótki przewodnik
Testy OTA |
|
| Półprzewodniki skandynawskie | nRF52840 DK | Krótki przewodnik
Testy OTA |
|
| NXP | Pakiet deweloperski IOTZTB-DK006 | Krótkie wprowadzenie | |
| Realtek | Seria Ameba D | Krótkie wprowadzenie | |
| Silicon Labs | Zestaw dla programistów EFR32MG24 | Krótkie wprowadzenie | |
| EFR32MG Zigbee i Thread Starter Kit | Krótkie wprowadzenie | ||
| Telink, | TLSR9518 | Krótkie wprowadzenie | |
| Instrumenty teksańskie | Zestaw CC2652R7 LaunchPad | Krótkie wprowadzenie |
Identyfikator dostawcy
Domyślnie do celów testowych możesz używać jednego z identyfikatorów VID przydzielonych przez CSA. Wybierz jedną z tych opcji: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Aby użyć produkcyjnego identyfikatora VID w celu uzyskania certyfikatu i uruchomienia integracji, musisz najpierw zweryfikować go przez Google, aby mieć pewność, że został Ci on przyznany przez CSA.
Identyfikator VID powinien być zaimplementowany w oprogramowaniu układowym urządzenia.
Urządzenie Matter można sparować w ekosystemie Google Home tylko w określonych przypadkach identyfikatora dostawcy i typów urządzeń.
- Testowego identyfikatora VID nie można używać na urządzeniu konsumenta.
- Twój produkcyjny identyfikator VID musi być wydany przez Connectivity Standards Alliance (Alliance). Google sprawdzi, czy jesteś właścicielem tego identyfikatora VID, zanim będzie można go użyć w Google Home Developer Console. Następnie możesz utworzyć integracje dla tego identyfikatora VID.
- Na potrzeby programowania i testów funkcjonalnych należy utworzyć w Developer Console projekt i integrację z odpowiednią kombinacją identyfikatorów VID i PID. Użytkownik, który zleca korzystanie z urządzenia, musi być uczestnikiem projektu lub wpisać się na listę użytkowników korzystających z testów praktycznych.
- Klienci indywidualni mogą używać Twojego produktu tylko wtedy, gdy uzyskał on certyfikat Alliance.
| Którzy użytkownicy mogą zamawiać urządzenia do ekosystemu Google Home? | |||
|---|---|---|---|
| Typ VID | Stan certyfikacji VID i integracji z konsolą | Produkcyjna
(Użytkownicy indywidualni) |
Dla programistów
(deweloperzy i użytkownicy testów funkcjonalnych) |
| Test | Brak integracji w: Developer Console (nie można uzyskać certyfikatu) | ||
| Test | Integracja znajduje się w regionie Developer Console (nie można uzyskać certyfikatu) | ||
| Produkcyjny | Brak certyfikatu, brak integracji w: Developer Console | ||
| Produkcyjny | Brak certyfikatu, integracja istnieje w: Developer Console | ||
| Produkcyjny | Certyfikowana na liście DCL Alliance, integracja nie występuje w: Developer Console | ||
| Produkcyjny | Certyfikat na liście DCL Alliance, a integracja znajduje się w: Developer Console | ||
Identyfikator produktu
Informacje o urządzeniu są odczytywane z klastra podstawowych informacji Matter. Identyfikator produktu zakodowany w oprogramowaniu układowym urządzenia musi być zgodny z identyfikatorem produktu integracji Matter w Konsoli programisty.
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 będą widoczne dla użytkowników:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
1. Informacje o tym, jak ta funkcja wpływa na przełączniki światła do włączania i wyłączania światła, znajdziesz w artykule na temat przełączników światła do włączania i wyłączania.