Google Home Sample App for Matter używa Google Home Mobile SDK do utworzenia aplikacji na Androida podobnej do Google Home app (GHA). Ta przykładowa aplikacja oferuje te funkcje:
- Przekazuj fizyczne i wirtualne urządzenia Matter do lokalnej sieci szkieletowej Androida
- Przekaż urządzenia fizyczne i wirtualne do tkaniny deweloperskiej
- Steruj urządzeniami w środowisku programistycznym, np. włączaćm światło
- Funkcje wielu administratorów pozwalają na udostępnianie urządzeń w środowisku programistycznym innym aplikacjom, a także na uwzględnianie urządzeń w fabryce aplikacji udostępnianych z innych aplikacji
- Programy narzędziowe
Z tego przewodnika dowiesz się, jak zainstalować plik APK Sample App for Matter oraz jak używać go do prowizji, kontrolowania i udostępniania urządzeń Matter.
Jeśli chcesz pobrać kod źródłowy, dowiedzieć się, jak zintegrować Mobile SDK i dostosowywać ekrany w Android Studio, skorzystaj z naszych ćwiczeń z programowania w Sample App for Matter.
Przejdź do ćwiczeń z programowania Sample App for Matter
Wymagania wstępne
- urządzenie z Androidem O (8.1, poziom interfejsu API 27) lub nowszym dostępne do testowania. Aby mieć pewność, że Twoje urządzenie ma najnowszą wersję Matter, zapoznaj się z przewodnikiem Weryfikowanie modułów i usług Matter.
- Utwórz urządzenie Matter z możliwościami włączania i wyłączania. Ta przykładowa aplikacja działa z urządzeniem wirtualnym i ESP32.
- Matter Virtual Device (MVD). Aby zminimalizować problemy ze środowiskiem, zdecydowanie zalecamy zacząć od MVD. Jeśli natrafisz na problemy, o wiele łatwiej będzie Ci sprawdzić, czy przykładowa aplikacja jest używana w ramach MVD.
- Utwórz urządzenie wirtualne Matter za pomocą aplikacji
rootnode_dimmablelight_bCwGYSDpoe. Podczas tworzenia integracji Matter w Google Home Developer Console użyj0xFFF1jako identyfikatora dostawcy i0x8000jako identyfikatora produktu. - Zbuduj urządzenie Espressif za pomocą
all-clusters-app. Podczas tworzenia integracji Matter w Developer Console użyj0xFFF1jako identyfikatora dostawcy, a0x8001jako identyfikatora produktu.
Nie potrzebujesz centrum, np. Google Nest Hub (2nd gen), aby uruchamiać i kontrolować urządzenia za pomocą Sample App for Matter.
Zainstaluj
Otwórz sekcję Wersje w repozytorium Sample App for Matter na GitHubie. W najnowszej wersji w sekcji Zasoby znajdź plik APK o nazwie
GHSAFM-version-default-debug.apk. Nie zaznaczaj elementutargetcommissioner.Zainstaluj Android Debug Bridge (adb):
Podłącz urządzenie z Androidem przez USB i włącz Przenoszenie plików, a następnie zainstaluj plik APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Urządzenia objęte prowizją
Przy pierwszym uruchomieniu przykładowej aplikacji pojawi się okno z linkiem do ćwiczenia z programowania na platformie Sample App for Matter. Jeśli wybierzesz Nie pokazuj tego komunikatu ponownie, w każdej chwili możesz przywrócić to okno, zmieniając ustawienia w sekcji Administracja w aplikacji.
W następnych krokach dodasz urządzenie Matter do lokalnej tkaniny systemu Android oraz tkaninę programistyczną, która jest dostępna tylko w przykładowej aplikacji.
Czym są tkaniny Matter?
Tkanina Matter to wspólna domena zaufania urządzeń w sieci domowej, która umożliwia im komunikację ze sobą.
Urządzenia mogą mieć co najmniej jedną tkaninę odpowiadającą platformie, aplikacji lub grupie urządzeń wchodzących ze sobą w interakcję. Materiały materiałowe mają unikalny identyfikator, a urządzenia mają ten sam zestaw danych logowania i urząd certyfikacji (CA). Te dane logowania są przypisywane podczas uruchamiania Matter.
Aby uruchomić urządzenie Matter, wykonaj te czynności:
Kliknij przycisk Dodaj urządzenie, aby rozpocząć proces wprowadzania na rynek.
Następnie element sterujący jest przenoszony do usługi Google Play services, która jest uruchamiana z połączenia do interfejsu Mobile SDK. Aby potwierdzić własność urządzenia, zeskanuj kod QR lub kliknij Użyj kodu parowania.
Po zakończeniu zlecania wpisz nazwę urządzenia i kliknij Gotowe.
Urządzenie jest teraz połączone zarówno z lokalną tkaniną, jak i środowiskiem programistycznym Androida.
Wszystkie prace związane z uruchamianiem i powiązane z nimi ekrany są obsługiwane przez Play services podczas uruchamiania urządzeń. Zapewnia to spójną obsługę i eliminuje konieczność obsługi poufnych uprawnień, takich jak dane logowania do Wi-Fi czy Thread.
Sterowanie urządzeniami
Programowanie tworzy dane logowania do sterowania urządzeniami Matter bezpośrednio z przykładowej aplikacji.
Na ekranie głównym możesz włączyć lub wyłączyć urządzenie. Kliknij urządzenie, by wyświetlić jego szczegóły.
Udostępnianie urządzeń
W specyfikacji Matter udostępnianie urządzenia jest określane jako proces z wieloma administratorami. Po zleceniu korzystania z przykładowej aplikacji za pomocą urządzenia możesz je łatwo udostępniać innym ekosystemom.
Aby udostępniać urządzenie Matter innym ekosystemom, musisz mieć zainstalowaną inną platformę na urządzeniu z Androidem. Ta platforma zewnętrzna staje się docelowym komisarzem ds. komisji. Utworzyliśmy kolejną instancję przykładowej aplikacji, której możesz użyć jako docelowego komisarza.
Otwórz sekcję Wersje w repozytorium Sample App for Matter na GitHubie. W najnowszej wersji w sekcji Zasoby znajdź plik APK o nazwie
GHSAFM-version-targetcommissioner-debug.apk. Nie zaznaczaj elementudefault.Zainstaluj docelowy komisarz.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkNa ekranie głównym kliknij urządzenie, aby wyświetlić informacje o nim. Kliknij Udostępnij.
Przykładowa aplikacja wywołuje interfejs Mobile SDK Share API i ponownie przenoszona jest do Play services.
Pojawi się arkusz udostępniania, w którym możesz wybrać aplikację lub platformę, z którą chcesz sparować urządzenie. Na tym ekranie możesz udostępniać urządzenie na dwa sposoby:
- Ręcznie za pomocą kodu konfiguracji do udostępnienia docelowej aplikacji komisji
- w lokalnej aplikacji na Androida zarejestrowanej jako komisarz ds. Matter.
Docelowa aplikacja komisji jest oznaczona etykietą GHSAFM-TC. Kliknij to wystąpienie przykładowej aplikacji, aby udostępnić swoje urządzenie.
Następnie aplikacja zewnętrzna (docelowy komisarz) wprowadza do użytku urządzenie we własnej tkaninie.
Ustawienia
Na ekranie głównym kliknij ikonę ustawień . Tutaj możesz zaktualizować preferencje użytkownika, uzyskać pomoc i dowiedzieć się więcej o aplikacji.
Powiadomienie na pół strony
Na ekranie Ustawienia możesz wyłączyć proaktywne powiadomienia o wykrywaniu urządzeń Matter, które można zlecić klientowi.
Jeśli Twoja aplikacja zapewnia własny proces wykrywania lub uruchamiania Matter, możesz pominąć te powiadomienia, aby uniknąć przerw w działaniu. Więcej informacji znajdziesz w artykule Pomijanie powiadomień o odkrywaniu podlegających prowizji.
Narzędzia dla deweloperów
Na ekranie Ustawienia masz też dostęp do Narzędzi dla deweloperów.
Aby sprawdzić zawartość repozytoriów DataStore dotyczących urządzenia i użytkownika w Logcat, wykonaj te czynności:
Kliknij Rejestruj zawartość repozytoriów.
Kliknij OK w oknie dialogowym, a potem zaznacz Logcat.
Opinie i pomoc
Aby przesłać nam uwagi lub opinie na temat tego, jak możemy ulepszyć środowisko programistyczne Sample App for Matter, wypełnij formularz opinii.
Jeśli masz problemy z Sample App for Matter, spróbuj wykonać te czynności, aby zweryfikować swoje środowisko:
Jeśli masz pytania dotyczące korzystania z przykładowej aplikacji lub widzisz błąd w kodzie, możesz zgłosić problemy za pomocą narzędzia Issue Tracker, które znajduje się w repozytorium GitHub:
Jeśli chcesz uzyskać od Google oficjalne wskazówki dotyczące pytań technicznych, odwiedź forum dla deweloperów inteligentnego domu:
Aby uzyskać pomoc techniczną od społeczności, użyj tagu google-smart-home na stronie Stack Overflow: