Google Home Sample App for Matter używa Google Home Mobile SDK do utworzenia aplikacji na Androida, która jest podobna do Google Home app (GHA). Ta przykładowa aplikacja oferuje te funkcje:
- Zlecaj wykonanie fizycznych i wirtualnych urządzeń Matter na potrzeby lokalnej tkaniny danych Androida
- Zlecanie wykonania urządzeń fizycznych i wirtualnych na potrzeby sieci deweloperskiej
- sterowanie urządzeniami w sieci Fabric, np. włączanie światła;
- Funkcje wielu administratorów umożliwiają udostępnianie urządzeń w sieci deweloperskiej innym aplikacjom i odwrotnie – pozwalają na uwzględnianie w sieci deweloperskiej urządzeń udostępnianych przez inne aplikacje.
- Narzędzia dla deweloperów
Z tego przewodnika dowiesz się, jak zainstalować plik APK Sample App for Matter i używać go do uruchamiania, kontrolowania 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 ćwiczenie Sample App for Matter.
Przejdź do ćwiczenia Sample App for Matter
Wymagania wstępne
- Urządzenie z Androidem O (8.1, interfejs API na poziomie 27) lub nowszym, które jest dostępne do testowania. Aby upewnić się, że urządzenie obsługuje najnowszą wersję Matter, zapoznaj się z przewodnikiem Weryfikowanie modułów i usług Matter.
- Utwórz urządzenie Matter z funkcją włączania i wyłączania. Ta przykładowa aplikacja działa z urządzeniem wirtualnym i ESP32.
- Urządzenie wirtualne Matter (MVD). Aby zminimalizować problemy ze środowiskiem, zdecydowanie zalecamy rozpoczęcie od MVD. Jeśli napotkasz problemy, znacznie łatwiej będzie je zbadać, gdy przykładowa aplikacja będzie używana z 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. - Tworzenie urządzenia Espressif za pomocą
all-clusters-app. Gdy utworzysz integrację Matter w Developer Console, użyj0xFFF1jako identyfikatora dostawcy i0x8001jako identyfikatora produktu.
Nie potrzebujesz koncentratora, takiego jak Google Nest Hub (2nd gen), aby uruchamiać urządzenia i sterować nimi za pomocą Sample App for Matter.
Zainstaluj
Otwórz sekcję Releases w repozytorium Sample App for Matter na GitHubie. W przypadku najnowszej wersji znajdź w sekcji Zasoby plik APK o nazwie
GHSAFM-version-default-debug.apk. Nie wybierajtargetcommissioner.Zainstaluj Android Debug Bridge (adb):
Podłącz urządzenie z Androidem przez USB i włącz Przesyłanie plików, a następnie zainstaluj plik APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Uruchamianie urządzeń
Gdy po raz pierwszy uruchomisz przykładową aplikację, zobaczysz okno z linkiem do Sample App for Matter codelab. Jeśli wybierzesz Nie pokazuj więcej tego komunikatu, możesz w każdej chwili przywrócić okno, aktualizując ustawienia w sekcji Administracja aplikacji.
W następnych 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?
Matter to udostępniona domena zaufania między urządzeniami w sieci domowej, która umożliwia im komunikację między sobą.
Urządzenia mogą mieć co najmniej 1 sieć, która odpowiada platformie, aplikacji lub grupie urządzeń, które ze sobą współdziałają. Sieci Fabric mają unikalny identyfikator, a urządzenia współdzielą 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:
Aby rozpocząć proces udostępniania, kliknij przycisk Dodaj urządzenie.
Następnie kontrola jest przekazywana do Google Play services, który jest uruchamiany przez wywołanie Mobile SDK. Aby potwierdzić posiadanie, zeskanuj kod QR lub kliknij Użyj kodu parowania.
Po zakończeniu dodawania wpisz nazwę urządzenia i kliknij Gotowe.
Urządzenie jest teraz połączone zarówno z lokalną platformą Androida, jak i platformą programistyczną.
Wszystkie zadania związane z uruchamianiem i powiązane ekrany są obsługiwane przez Play services podczas uruchamiania urządzeń. Zapewnia to spójne wrażenia użytkownika i eliminuje konieczność obsługi uprawnień newralgicznych, takich jak dane logowania do Wi-Fi i Thread.
Steruj urządzeniami
Środowisko programistyczne tworzy dane logowania, aby sterować 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, aby wyświetlić jego szczegóły.
Udostępnianie urządzeń
Udostępnianie urządzenia jest określane jako proces z wieloma administratorami w specyfikacji Matter. Po dodaniu urządzenia do przykładowej aplikacji możesz je łatwo udostępnić innym ekosystemom.
Aby udostępnić urządzenie Matter innym ekosystemom, musisz mieć zainstalowaną inną platformę na urządzeniu z Androidem. Ta platforma zewnętrzna stanie się docelowym komisarzem. Utworzyliśmy kolejną instancję przykładowej aplikacji, której możesz użyć jako docelowego komisarza.
Otwórz sekcję Releases w repozytorium Sample App for Matter na GitHubie. W przypadku najnowszej wersji znajdź w sekcji Zasoby plik APK o nazwie
GHSAFM-version-targetcommissioner-debug.apk. Nie wybierajdefault.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 kontrola zostaje przekazana do Play services.
Wyświetli się arkusz udostępniania, na 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 do obsługi standardu Matter;
- Za pomocą lokalnej aplikacji na Androida zarejestrowanej jako komisarz Matter
Docelowa aplikacja komisarza jest oznaczona jako GHSAFM-TC. Kliknij tę instancję przykładowej aplikacji, aby udostępnić urządzenie.
Następnie aplikacja zewnętrzna (docelowy komisarz) kończy proces uruchamiania urządzenia we własnej sieci.
Ustawienia
Na ekranie głównym kliknij ikonę ustawień . Tutaj możesz zaktualizować ustawienia użytkownika, uzyskać pomoc i dowiedzieć się więcej o aplikacji.
Powiadomienie na połowie ekranu
Na ekranie Ustawienia możesz wyłączyć proaktywne powiadomienia o wykryciu urządzeń Matter, które można dodać.
Jeśli Twoja aplikacja udostępnia własny proces wykrywania lub uruchamiania Matter, możesz wyłączyć te powiadomienia, aby uniknąć zakłóceń. Więcej informacji znajdziesz w artykule Pomijanie powiadomień o wykryciu prowizji.
Narzędzia dla deweloperów
Na ekranie Ustawienia możesz też uzyskać dostęp do narzędzi dla deweloperów.
Aby sprawdzić zawartość repozytoriów DataStore z ustawieniami urządzenia i preferencjami użytkownika w Logcat, wykonaj te czynności:
Kliknij Log repositories content (Zawartość repozytoriów logów).
Kliknij OK w oknie, a następnie sprawdź Logcat.
Opinie i pomoc
Jeśli chcesz przesłać swoje przemyślenia lub opinię na temat tego, jak możemy ulepszyć proces programowania w Sample App for Matter, wypełnij 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 pytań technicznych, skorzystaj z forum dla deweloperów inteligentnego domu:
Aby uzyskać pomoc techniczną od społeczności, użyj tagu google-smart-home na Stack Overflow: