Program Google Home dla deweloperów umożliwia producentom urządzeń na swoich inteligentnych urządzeniach domowych z ekosystemem Google Home. Rozszerzamy Lokalna ścieżka realizacji akcji Smart Home Actions z możliwością dodania Urządzenia, na których można włączyć Matter, do konfiguracji za pomocą Google Home app (GHA) i kontroluj je za pomocą Google Assistant, GHA lub inteligentnych ekranów, takich jak Google Nest Hub (2nd gen).
W tej dokumentacji opisano, jak rozpocząć tworzenie i integrowanie platforma obsługiwana przez Matter w ekosystemie Google Home.
Wyłączenia odpowiedzialności
Dotyczy procedur opisanych w dokumencie Matter dokumentacji, pamiętaj o tych kwestiach:
- Zalecamy, aby konto używane do programowania miało tylko jeden Podłączono centrum z włączoną obsługą Matter na potrzeby testów. Wiele koncentratory z włączoną obsługą Matter połączone lub jest podłączony do tego samego obiektu podczas testowania, nieprzewidywalne zachowanie.
- Wszystkie procedury zakładają użycie komputera z systemem Linux z systemem Ubuntu 20.04 tworzy i migam Matter przykładów, które zostały testowanych przez Google. Urządzenia z systemem macOS są obsługiwane, ale zalecamy korzystanie z systemu Linux. Typowe dla komputerów Mac są wymienione w procedurach.
Jak tworzyć
Aby utworzyć urządzenie z obsługą interfejsu Matter, które integruje się z ekosystemu Google Home, będziesz pracować z płytką deweloperską zgodną z Matter oraz z platformą Matter SDK.
Najłatwiej zacząć od ukończenia naszych ćwiczeń z programowania. Śr zalecamy wykonanie co najmniej jednego z tych ćwiczeń w Codelabs:
Następnie przejrzyj naszą listę obsługiwanych urządzeń, aby upewnić się, że plan integracji jest obsługiwany w ekosystemie Google Home. Następnie przeczytaj listę kontrolną dla programistów, aby poznać wszystkie potrzebne informacje. procesu programowania od momentu utworzenia projektu do jego uruchomienia.
Obsługiwane urządzenia Lista kontrolna dla programistów
Definicje
W tej dokumentacji używane są następujące terminy:
- Router graniczny
- Centrum stosujące uniwersalne obramowanie Thread Router dla urządzeń, które obsługują Thread.
- Centrum
- Obsługiwane urządzenie z systemem Google Nest, takie jak Google Nest Hub (2nd gen) Do sterowania urządzeniami z funkcją Matter wymagane jest centrum na innych platformach, takich jak Assistant, GHA i inteligentnych ekranów.
- Urządzenie z obsługą Matter
- Urządzenie lub płytę deweloperską z zainstalowaną aplikacją Kompilacja lub przykładowa aplikacja z obsługą Matter.
- Urządzenie mobilne
- Telefon testowy użyty do sparowania. Obecnie jest to Telefon Android.
Wymagania wstępne
Aby w pełni zintegrować urządzenie z obsługą Matter ekosystemu Google Home, deweloper musi mieć:
- Centrum Google z obsługą Thread jako router graniczny w przypadku urządzeń obsługujących Thread, a także jako router lokalny ścieżka realizacji na potrzeby kierowania intencji inteligentnego domu.
- Urządzenie mobilne (telefon testowy), które spełnia 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ądzenie z obsługą Matter.
- Urządzenie z obsługą Matter. Na tym urządzeniu powinno być:
Matter typów urządzeń obsługiwanych
ekosystemu Google Home, czyli:
- .
- Twój produkt z oprogramowaniem, które obsługuje Matter.
- Jedno z tych Matter urządzeń do użycia w: kompleksowa weryfikacja:
Dostawca | Platforma | Pomoc na poziomie: Thread | Przewodnik |
---|---|---|---|
Laboratorium Bouffalo | BL602 | ||
BL702 | |||
Espressif | ESP32 | Testy OTA | |
Półprzewodniki nordyckie | nRF52840 DK | Testy OTA | |
NXP | Opracowywanie przy użyciu IOTZTB-DK006 pakiet | ||
Realtek | Ameba serii D | ||
Laboratoria Krzemowe | Zestaw deweloperski EFR32MG24 | ||
EFR32MG Zigbee and Thread Zestaw startowy | |||
Telink | TLSR9518 | ||
Instrumenty teksańskie | Opracowanie rozwiązania CC2652R7 LaunchPad pakiet |
Identyfikator dostawcy
Domyślnie do testowania możesz używać jednego z identyfikatorów VID przydzielonych przez CSA
w celach informacyjnych. Wybierz jedną z tych opcji:
0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
.
Aby użyć produkcyjnego identyfikatora VID w celu uzyskania certyfikatu i wprowadzenia integracji, musisz najpierw zostały zweryfikowane przez Google w celu potwierdzenia, że zostały Ci wydane przez CSA.
Identyfikator VID powinien być zaimplementowany w oprogramowaniu sprzętowym urządzenia.
Urządzenie Matter można sparować tylko z Google Home w określonych scenariuszach związanych z identyfikatorem dostawcy i typem urządzenia.
- Testowego identyfikatora VID nie można używać na urządzeniu konsumenckim.
- Twój produkcyjny identyfikator VID musi być wydany przez Connectivity Standards Alliance (Alliance). Google zanim użyjesz tego identyfikatora VID w usłudze Google Home Developer Console, potwierdź, że jesteś jego właścicielem. Gdy to zrobisz, będziesz mieć możliwość tworzenia dla danego identyfikatora VID.
- Do celów programistycznych i do testów funkcjonalnych projekt oraz integracja odpowiednią kombinację VID i PID należy utworzyć w Developer Console. Uruchamiam usługę dla użytkownika urządzenie musi być członkiem projektu lub znajdować się na liście użytkowników w ramach testów funkcjonalnych.
- Użytkownicy mogą korzystać z Twojego produktu dopiero wtedy, gdy uzyska on certyfikat Alliance
Jakie typy użytkowników mogą zlecić z ekosystemem Google Home? | |||
---|---|---|---|
Typ VID | Stan certyfikacji VID i integracji konsoli | Produkcyjna
(użytkownicy indywidualni) |
Dla programistów
(programiści, użytkownicy korzystający z testów funkcjonalnych) |
Test | Brak integracji w: Developer Console (nie można uzyskać certyfikatu) | ||
Test | Integracja istnieje w: Developer Console (nie można ) | ||
Produkcja | Brak certyfikatu, integracja nie istnieje w: Developer Console | ||
Produkcja | Brak certyfikatu, ale integracja istnieje w: Developer Console | ||
Produkcja | Ma certyfikat DCL w Alliance. Integracja nie istnieją w Developer Console | ||
Produkcja | Ma certyfikat DCL w Alliance, istnieje możliwość integracji Developer Console |
Identyfikator produktu
Informacje o urządzeniu są odczytywane z Matter – klaster podstawowych informacji. Identyfikator produktu zakodowany w Oprogramowanie urządzenia musi być zgodne z identyfikatorem produktu w ramach integracji z Matter w Konsoli programisty.
Nieobsługiwane funkcje
Niektóre klastry Matter nie są jeszcze dostępne dla użytkowników których może używać system. W większości przypadków oznacza to, że atrybuty widoczne w tych klastrach nie są widoczne dla użytkowników:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
1 Patrz Włączniki światła do włączania i wyłączania światła aby dowiedzieć się, jak wpływa to na przełączniki światła.