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:
- Uruchom fizyczne i wirtualne Matter urządzenia w ramach lokalnej struktury Androida
- Wdrażanie urządzeń fizycznych i wirtualnych w środowisku deweloperskim
- sterować urządzeniami w środowisku deweloperskim, np. włączać światło;
- Funkcje wielu administratorów umożliwiają udostępnianie urządzeń w środowisku deweloperskim innym aplikacjom i odwrotnie – włączanie do środowiska deweloperskiego urządzeń udostępnionych przez inne aplikacje.
- Narzędzia dla programistów
Z tego przewodnika dowiesz się, jak zainstalować plik APK Sample App for Matter i używać go do uruchamiania, 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, skorzystaj z naszego kursu Mobile SDK.Sample App for Matter
Otwórz Sample App for Matter codelab
Wymagania wstępne
- Urządzenie z Androidem O (8.1, interfejs API na poziomie 27) lub nowszym, które można wykorzystać do testowania. Aby upewnić się, że urządzenie ma najnowszą Matter wersję, zapoznaj się z przewodnikiem Weryfikowanie Matter modułów i usług.
- Zbuduj Matter urządzenie z funkcją 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, zdecydowanie zalecamy rozpoczęcie od MVD. Jeśli napotkasz problemy, łatwiej będzie je zbadać, jeśli aplikacja przykładowa będzie używana w odniesieniu do MVD.
- Utwórz Matterurządzenie wirtualne za pomocą aplikacji
rootnode_dimmablelight_bCwGYSDpoe. Gdy utworzysz Matterintegrację w Google Home Developer Console, użyj0xFFF1jako identyfikatora dostawcy i0x8000jako identyfikatora produktu. - Zbuduj urządzenie Espressif za pomocą
all-clusters-app. Gdy tworzysz Matterintegrację w Developer Console, użyj0xFFF1jako identyfikatora dostawcy i0x8001jako identyfikatora produktu.
Aby włączyć i sterować urządzeniami za pomocą Sample App for Matter, nie potrzebujesz centrali, np. Google Nest Hub (2nd gen).
Zainstaluj
Otwórz sekcję Wersje w repozytorium Sample App for Matter GitHub. Najnowszą wersję znajdziesz w sekcji Zasoby. Jest to 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 dialogowe z linkiem do Sample App for Mattercodelabu. Jeśli klikniesz Nie pokazuj więcej tego komunikatu, możesz w dowolnym momencie przywrócić okno dialogowe, aktualizując ustawienia w sekcji Administracja aplikacji.
W kolejnych krokach dodasz Matter urządzenie do lokalnej struktury Androida oraz strukturę deweloperską, która będzie lokalna tylko w przypadku aplikacji przykładowej.
Czym są tkaniny Matter?
MatterFabric to wspólna domena zaufania między urządzeniami w sieci domowej, która umożliwia im komunikację ze sobą.
Urządzenia mogą mieć co najmniej 1 strukturę 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 uruchamiania.
Aby uruchomić urządzenie Matter, wykonaj te czynności:
Aby rozpocząć proces uruchamiania, kliknij przycisk Dodaj urządzenie.
Następnie sterowanie jest przekazywane do aplikacji Google Play services, która jest uruchamiana w wyniku wywołania funkcji Mobile SDK. Aby potwierdzić własność, zeskanuj kod QR lub kliknij Użyj kodu parowania.
Po zakończeniu konfiguracji wpisz nazwę urządzenia i kliknij Gotowe.
Urządzenie jest teraz połączone zarówno z lokalną strukturą Androida, jak i ze strukturą deweloperską.
Cała praca związana z uruchamianiem i powiązane z nią ekrany są obsługiwane przez Play services podczas uruchamiania urządzeń. Zapewnia to spójne wrażenia użytkownika i eliminuje konieczność obsługi wrażliwych uprawnień, np. danych logowania do Wi-Fi i Thread.
Sterowanie urządzeniami
Platforma deweloperska tworzy dane logowania, które umożliwiają sterowanie Matterurządzeniami bezpośrednio z aplikacji przykładowej.
Na ekranie głównym możesz włączyć lub wyłączyć urządzenie. Kliknij urządzenie, aby uzyskać dostęp do jego szczegółów.
Udostępnianie urządzeń
Udostępnianie urządzenia jest w specyfikacjiMatter określane jako proces z wieloma administratorami. Gdy urządzenie zostanie przypisane do aplikacji przykładowej, możesz łatwo udostępnić je 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ę komisjonariuszem docelowym. Utworzyliśmy kolejną instancję przykładowej aplikacji, której możesz użyć jako docelowego podmiotu zlecającego.
Otwórz sekcję Wersje w repozytorium Sample App for Matter GitHub. Najnowszą wersję znajdziesz w sekcji Zasoby. Jest to 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świetli 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ępnić urządzenie na 2 sposoby:
- ręcznie za pomocą kodu konfiguracji, który należy udostępnić docelowej aplikacji komisarza;
- za pomocą lokalnej aplikacji na Androida, która została zarejestrowana jako Matterkomisarz.
Aplikacja komisarza docelowego jest oznaczona etykietą GHSAFM-TC. Kliknij tę instancję aplikacji przykładowej, aby udostępnić urządzenie.
Następnie aplikacja zewnętrzna (komisarz docelowy) kończy wdrażanie urządzenia w swojej sieci.
Ustawienia
Na ekranie głównym kliknij ikonę ustawień . Możesz tu zaktualizować ustawienia użytkownika, uzyskać pomoc i dowiedzieć się więcej o aplikacji.
Powiadomienie w formie półarkusza
Na ekranie Ustawienia możesz wyłączyć proaktywne powiadomienia o odkrywaniu urządzeń, za które przysługuje prowizja, w przypadku urządzeń Matter.
Jeśli Twoja aplikacja udostępnia własny proces Matterodkrywania lub zamawiania, możesz wyłączyć te powiadomienia, aby uniknąć przerw. Więcej informacji znajdziesz w sekcji Wyłączanie powiadomień o odkrywaniu treści, za które można otrzymać prowizję.
Narzędzia dla programistów
Na ekranie Ustawienia możesz też otworzyć Narzędzia dla programistów.
Aby sprawdzić zawartość repozytoriów Device and User Preferences DataStore w Logcat:
Kliknij Log repositories content (Rejestruj treści z repozytoriów).
Kliknij OK w oknie dialogowym, a potem zaznacz Logcat.
Opinie i pomoc
Aby przesłać swoje przemyślenia lub opinię na temat tego, jak możemy ulepszyć środowisko programistyczne Sample App for Matter, wypełnij nasz formularz opinii.
Jeśli masz problemy z Sample App for Matter, wykonaj te czynności, aby zweryfikować środowisko:
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 deweloperów inteligentnego domu:
Aby uzyskać pomoc techniczną od społeczności, użyj tagu google-smart-home na stronie Stack Overflow: