Google Home Sample App for Matter korzysta z Google Home Mobile SDK do tworzenia aplikacji na Androida podobnej do Google Home app (GHA). Ta przykładowa aplikacja oferuje te funkcje:
- Commission physical and virtual Matter devices to the Local Android fabric
- Commission physical and virtual devices to a development fabric
- Control devices on your development fabric, for example turning on a light
- Multi-admin features allow you to share devices on the development fabric with other apps, and conversely be able to include in the development fabric devices shared from other apps
- Developer Utilities
W tym przewodniku opisujemy, jak zainstalować plik APK Sample App for Matter i używać go do konfigurowania, sterowania i udostępniania urządzeń Matter.
Aby pobrać kod źródłowy, dowiedzieć się, jak zintegrować Mobile SDK, i dostosować ekrany w Android Studio, wypróbuj nasze Sample App for Matter ćwiczenie z programowania.
Przejdź do ćwiczenia z programowania Sample App for Matter
Wymagania wstępne
- Urządzenie z Androidem O (8.1, poziom interfejsu API 27) lub nowszym, które jest dostępne do testowania. Aby upewnić się, że Twoje urządzenie obsługuje najnowszą wersję Matter , zapoznaj się z przewodnikiem Matter Moduły i usługi.
- Utwórz urządzenie Matter z funkcjami 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 rozpoczęcie od MVD. Jeśli napotkasz problemy, łatwiej będzie je zbadać, jeśli przykładowa aplikacja będzie używana z MVD.
- Utwórz Matter wirtualne urządzenie
za pomocą aplikacji
rootnode_dimmablelight_bCwGYSDpoe. Gdy utworzysz Matter integrację w Google Home Developer Console, użyj0xFFF1jako identyfikatora dostawcy i0x8000jako identyfikatora produktu. - Utwórz urządzenie Espressif
za pomocą
all-clusters-app. Gdy utworzysz Matter integrację w Developer Console, użyj0xFFF1jako identyfikatora dostawcy i0x8001jako identyfikatora produktu.
Aby skonfigurować urządzenia i sterować nimi za pomocą Sample App for Matter, nie potrzebujesz centrali, np. Google Nest Hub (2nd gen), do konfiguracji .
Instalowanie
Otwórz sekcję Releases w repozytorium GitHub .Sample App for Matter W przypadku najnowszej wersji w sekcji Assets znajdź plik APK o nazwie
GHSAFM-version-default-debug.apk. Nie wybierajtargetcommissioner.Zainstaluj Android Debug Bridge (adb):
Podłącz urządzenie z Androidem za pomocą USB i włącz Przesyłanie plików, a następnie zainstaluj plik APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Konfigurowanie urządzeń
Gdy uruchomisz przykładową aplikację po raz pierwszy, pojawi się okno z linkiem do ćwiczenia z programowania Sample App for Matter. Jeśli wybierzesz Nie pokazuj tego komunikatu ponownie, możesz w każdej chwili przywrócić okno dialogowe aktualizując preferencje w sekcji Administracja aplikacji.
W kolejnych krokach dodasz urządzenie Matter do lokalnej sieci Androida oraz do sieci deweloperskiej, która jest lokalna tylko dla przykładowej aplikacji.
Czym są sieci Matter?
Sieć Matter to wspólna domena zaufania między urządzeniami w sieci domowej, która umożliwia im komunikowanie się ze sobą.
Urządzenia mogą mieć co najmniej 1 sieć odpowiadającą platformie, aplikacji lub grupie urządzeń, które ze sobą współpracują. Sieci mają unikalny identyfikator, a urządzenia korzystają z tego samego zestawu danych logowania i urzędu certyfikacji (CA). Te dane logowania są przypisywane podczas Matter konfigurowania.
Aby skonfigurować urządzenie Matter:
Aby rozpocząć proces konfigurowania, kliknij przycisk Dodaj urządzenie.
Następnie sterowanie jest przekazywane do Google Play services, które jest uruchamiane przez wywołanie Mobile SDK. Aby potwierdzić posiadanie, zeskanuj kod QR lub kliknij Użyj kodu parowania.
Po zakończeniu konfigurowania wpisz Nazwę urządzenia, a następnie kliknij Gotowe.
Twoje urządzenie jest teraz połączone zarówno z lokalną siecią Androida, jak i z siecią deweloperską.
Podczas konfigurowania urządzeń wszystkie czynności związane z konfigurowaniem i powiązane z nimi ekrany są obsługiwane przez Play services podczas konfigurowania urządzeń. Zapewnia to spójne wrażenia użytkownika i eliminuje konieczność obsługi poufnych uprawnień, np. danych logowania do Wi-Fi i Thread.
Sterowanie urządzeniami
Sieć deweloperska tworzy dane logowania, które umożliwiają sterowanie Matter urządzeniami bezpośrednio z przykładowej aplikacji.
Na ekranie głównym możesz włączyć On lub wyłączyć Off urządzenie. Kliknij urządzenie, aby uzyskać dostęp do jego szczegółów.
Udostępnianie urządzeń
Udostępnianie urządzenia jest w Matter specyfikacji określane jako proces wieloadministratorski. Gdy urządzenie zostanie skonfigurowane w przykładowej aplikacji, możesz je łatwo udostępnić innym ekosystemom.
Aby udostępnić urządzenie Matter innym ekosystemom, musisz mieć na urządzeniu z Androidem zainstalowaną inną platformę. Ta zewnętrzna platforma staje się komisarzem docelowym. Utworzyliśmy inną instancję przykładowej aplikacji, której możesz używać jako komisarza docelowego.
Otwórz sekcję Releases w repozytorium GitHub .Sample App for Matter W przypadku najnowszej wersji w sekcji Assets znajdź plik APK o nazwie
GHSAFM-version-targetcommissioner-debug.apk. Nie wybierajdefault.Zainstaluj komisarza docelowego.
$ 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 sterowanie jest przekazywane do Play services.
Wyświetla się arkusz udostępniania, który umożliwia wybranie aplikacji lub platformy, z którą chcesz sparować urządzenie. Ten ekran umożliwia udostępnianie urządzenia na 2 sposoby:
- Ręcznie za pomocą kodu konfiguracji, który ma być udostępniony aplikacji komisarza docelowego.
- Za pomocą lokalnej aplikacji na Androida, która została zarejestrowana jako Matter komisarz
Aplikacja komisarza docelowego jest oznaczona jako GHSAFM-TC. Aby udostępnić urządzenie, kliknij tę instancję przykładowej aplikacji.
Następnie aplikacja zewnętrzna (komisarz docelowy) kończy konfigurowanie urządzenia w swojej sieci.
Ustawienia
Na ekranie głównym kliknij ikonę ustawień . Możesz tam zaktualizować preferencje użytkownika, uzyskać pomoc i dowiedzieć się więcej o aplikacji.
Powiadomienie w dolnej części ekranu
Na ekranie Ustawienia możesz wyłączyć proaktywne powiadomienia o wykryciu urządzeń Matter, które można skonfigurować.
Jeśli Twoja aplikacja ma własny Matter proces wykrywania lub konfigurowania, możesz wyłączyć te powiadomienia, aby zapobiec przerwom. Więcej informacji znajdziesz w artykule Wyłączanie powiadomień o wykryciu urządzeń, które można skonfigurować.
Narzędzia dla programistów
Na ekranie Ustawienia możesz też otworzyć Narzędzia dla programistów.
Aby sprawdzić zawartość repozytoriów Device i User Preferences DataStore w Logcat, wykonaj te czynności:
Kliknij Log repositories content (Zawartość repozytoriów logów).
Kliknij OK w oknie dialogowym, a następnie sprawdź Logcat.
Opinie i pomoc
Aby przesłać swoje uwagi lub opinie na temat tego, jak możemy ulepszyć proces tworzenia aplikacji za pomocą Sample App for Matter, wypełnij nasz formularz opinii.
Jeśli masz problemy z Sample App for Matter, spróbuj wykonać te czynności, aby sprawdzić swoje środowisko:
- Sprawdzanie modułów i usług Matter
Jeśli masz pytania dotyczące korzystania z przykładowej aplikacji lub znajdziesz błąd w kodzie, możesz zgłosić problem w narzędziu Issue Tracker w repozytorium GitHub:
Aby uzyskać oficjalne wskazówki od Google dotyczące pytań technicznych, skorzystaj z forum dla programistów Smart Home:
Aby uzyskać pomoc techniczną od społeczności, użyj tagu google-smart-home na Stack Overflow: