Google Home Sample App for Matter używa Google Home Mobile SDK do tworzenia aplikacji na Androida podobnej do Google Home app (GHA). Ta przykładowa aplikacja oferuje te funkcje:
- Dodawanie fizycznych i wirtualnych urządzeń Matter Matter do lokalnej sieci Androida
- Dodawanie fizycznych i wirtualnych urządzeń do sieci deweloperskiej
- Sterowanie urządzeniami w sieci deweloperskiej, np. włączanie światła
- Funkcje multi-admin umożliwiają udostępnianie urządzeń w sieci deweloperskiej innym aplikacjom i odwrotnie – włączanie do sieci deweloperskiej urządzeń udostępnionych z innych aplikacji
- Narzędzia dla programistów
W tym przewodniku opisujemy, jak zainstalować plik APK Sample App for Matter i używać go do dodawania urządzeń Matter, sterowania nimi i udostępniania ich.
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.
Otwórz ćwiczenie 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 mieć pewność, że Twoje urządzenie obsługuje najnowszą wersję Matter , zapoznaj się z przewodnikiem Sprawdzanie Matter modułów i usług.
- Utwórz urządzenie Matter z funkcjami włączania i wyłączania. Ta przykładowa aplikacja działa z urządzeniem wirtualnym i ESP32.
- Wirtualne urządzenie Matter (MVD). Aby zminimalizować problemy ze środowiskiem, 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 tworzysz 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 tworzysz integrację w , użyj jako identyfikatora dostawcy i jako identyfikatora produktu.MatterDeveloper Console0xFFF10x8001
Aby dodawać urządzenia i sterować nimi za pomocą Sample App for Matter, nie potrzebujesz centrali, np. Google Nest Hub (2nd gen), do dodawania i sterowania urządzeniami.
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
Dodawanie 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ć jedną lub więcej sieci, które odpowiadają platformie, aplikacji lub grupie urządzeń współpracujących ze sobą. 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 dodawania urządzenia Matter.
Aby dodać urządzenie Matter:
Aby rozpocząć proces dodawania, 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 urządzenia, zeskanuj kod QR lub kliknij Użyj kodu parowania.
Po zakończeniu dodawania 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 dodawania urządzeń wszystkie czynności związane z dodawaniem i powiązane z nimi ekrany są obsługiwane przez Play services podczas dodawania 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 specyfikacji Matter określane jako proces multi-admin. Gdy urządzenie zostanie dodane do 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ę docelowym komisarzem. Utworzyliśmy inną instancję przykładowej aplikacji, której możesz używać jako docelowego komisarza.
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 docelowego komisarza.
$ 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 docelowego komisarza.
- Za pomocą lokalnej aplikacji na Androida, która została zarejestrowana jako Matter komisarz
Aplikacja docelowego komisarza jest oznaczona jako GHSAFM-TC. Aby udostępnić urządzenie, kliknij tę instancję przykładowej aplikacji.
Następnie aplikacja zewnętrzna (docelowy komisarz) kończy dodawanie urządzenia do własnej 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 dodać.
Jeśli Twoja aplikacja ma własny proces wykrywania Matter lub dodawania urządzeń, 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 dodać .
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 kwestii 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: