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:
- Połącz fizyczne i wirtualne urządzenia Matter z lokalnym materiałem z Androida
- Przekazuj fizyczne i wirtualne urządzenia do platformy programistycznej
- Steruj urządzeniami w ramach programowania, np. włącz światło
- Funkcje obsługi wielu administratorów pozwalają na udostępnianie urządzeń używanych w środowisku programistycznym z innymi aplikacjami i umożliwiają uwzględnianie ich w materiałach programistycznych udostępnianych w innych aplikacjach
- Narzędzia dla programistów
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.
Aby pobrać kod źródłowy, dowiedz się, jak zintegrować Mobile SDK i dostosować ekrany w Android Studio, wykonaj nasze ćwiczenia z programowania Sample App for Matter.
Przejdź do ćwiczeń z programowania Sample App for Matter
Wymagania wstępne
- Urządzenie z Androidem O (8.1, poziom 27) lub nowsze, które może być testowane. Aby mieć pewność, że Twoje urządzenie korzysta z najnowszej pomocy dotyczącej Matter, zapoznaj się z przewodnikiem Weryfikacja 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.
- Utwórz urządzenie wirtualne Matter za pomocą aplikacji
rootnode_dimmablelight_bCwGYSDpoe
. Podczas tworzenia integracji Matter w Google Home Developer Console użyj0xFFF1
jako identyfikatora dostawcy, a0x8000
jako identyfikatora produktu. - Utwórz urządzenie Espressif, używając
all-clusters-app
. Podczas tworzenia integracji Matter w Developer Console ustaw0xFFF1
jako identyfikator dostawcy, a0x8001
jako identyfikator produktu.
- Utwórz urządzenie wirtualne Matter za pomocą aplikacji
Nie musisz mieć koncentratora, na przykład Google Nest Hub (2nd gen), aby przesyłać i sterować urządzeniami za pomocą Sample App for Matter.
Zainstaluj
Przejdź do sekcji Wersje w repozytorium Sample App for Matter na GitHubie. Znajdź plik APK o nazwie
GHSAFM-1.4.1-default-debug.apk
. Nie wybierajtargetcommissioner
:Zainstaluj Android Debug Bridge (adb):
Połącz urządzenie z Androidem przez USB i włącz Przesyłanie plików, a następnie zainstaluj pakiet APK:
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
Urządzenia korzystające ze strategii Prowizje
Gdy po raz pierwszy uruchomisz przykładową aplikację, pojawi się okno z linkiem do laboratorium 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ępnym kroku dodasz urządzenie Matter do tkaniny z Androidem wraz z tkaniną programistyczną, która jest lokalna tylko dla przykładowej aplikacji.
Czym są tkaniny Matter?
tkanina Matter to wspólna domena zaufania między urządzeniami w sieci domowej, która umożliwia im komunikację ze sobą.
Urządzenia mogą mieć więcej niż jedną tkaninę odpowiadającą platformie, aplikacji lub grupie urządzeń. Tkaniny mają unikalny identyfikator, a urządzenia mają ten sam zestaw danych logowania i urząd certyfikacji (CA). Te dane logowania są przypisywane podczas uruchamiania usługi Matter.
Aby zamówić urządzenie z Matter, wykonaj te czynności:
Kliknij przycisk
Dodaj urządzenie, aby rozpocząć proces składania zamówienia.Następny element jest przenoszony do elementu Google Play services, który jest uruchamiany z wywołania do Mobile SDK. Aby udowodnić, że jesteś właścicielem, zeskanuj kod QR lub kliknij Użyj kodu parowania.
Po ukończeniu prowizji wpisz nazwę urządzenia, a następnie kliknij Gotowe.
Urządzenie jest teraz połączone zarówno z lokalnym materiałem na Androida, jak i tkaniną programistyczną.
Cała praca zlecająca i powiązane z nią ekrany są obsługiwane przez Play services podczas uruchamiania urządzeń. Dzięki temu korzystanie z aplikacji jest spójne i nie trzeba korzystać z uprawnień newralgicznych, takich jak dane logowania do Wi-Fi i wątku.
Sterowanie urządzeniami
Twórczyni tworzy dane logowania, aby sterować Matter urządzeniami bezpośrednio w przykładowej aplikacji.
Na ekranie głównym możesz włączyć lub wyłączyć urządzenie. Kliknij to, aby zobaczyć szczegóły.
Udostępnianie urządzeń
W specyfikacji Matter proces udostępniania urządzenia jest określany jako wieloadministratora. Gdy urządzenie zostanie wysłane 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 platforma zewnętrzna staje się docelowym komisarzem. Utworzyliśmy kolejną instancję przykładowej aplikacji, której możesz używać jako komisarza docelowego.
Przejdź do sekcji Wersje w repozytorium Sample App for Matter na GitHubie. Znajdź najnowszy plik APK o nazwie
GHSAFM-[version]-targetcommissioner
, na przykładGHSAFM-1.4.1-targetcommissioner-debug.apk
:Zainstaluj docelowy komisarz.
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
Na ekranie głównym kliknij urządzenie, aby wyświetlić informacje na jego temat. Kliknij Udostępnij.
Przykładowa aplikacja wywołuje interfejs Mobile SDK Share API, a po raz kolejny element sterujący jest przenoszony do Play services.
Pojawi się arkusz udostępniania, który umożliwia wybranie aplikacji lub platformy, z którą chcesz sparować urządzenie. Na tym ekranie możesz udostępnić urządzenie na dwa sposoby:
- ręcznie za pomocą kodu konfiguracji, który zostanie udostępniony aplikacji docelowej.
- W lokalnej aplikacji na Androida, która została zarejestrowana jako komisarz Matter
Aplikacja Commission Comster ma etykietę GHSAFM-TC. Kliknij to wystąpienie przykładowej aplikacji, by udostępnić swoje urządzenie.
Następnie aplikacja zewnętrzna (zarządca docelowy) uruchamia zlecenie urządzenia na własnej platformie.
Ustawienia
Na ekranie głównym kliknij ikonę ustawień
. Tutaj możesz zaktualizować preferencje użytkowników, uzyskać pomoc i dowiedzieć się więcej o aplikacji.Powiadomienie o połowie arkusza
Na ekranie Ustawienia możesz wyłączyć powiadomienia o procencjonowanym odkrywania na Matter urządzeniach.
Jeśli aplikacja zapewnia własny proces wykrywania lub uruchamiania Matter, możesz wyłączyć te powiadomienia, aby uniknąć przerw w działaniu. Więcej informacji znajdziesz w artykule Pomijanie powiadomień o prowizji za wykrywanie.
Narzędzia dla programistów
Na ekranie Ustawienia możesz też uzyskać dostęp do Narzędzi dla programistów.
Aby sprawdzić zawartość repozytoriów magazynu danych i preferencji użytkownika w Logcat, wykonaj te czynności:
Kliknij Zapisz treść repozytoriów.
Kliknij OK w oknie dialogowym, a następnie zaznacz Logcat.
Opinie i pomoc
Aby przesłać nam swoją opinię lub opinię na temat ulepszania usługi Sample App for Matter, wypełnij formularz.
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 zauważysz błąd kodu, możesz zgłosić problemy w narzędziu do śledzenia problemów w repozytorium GitHub:
Aby uzyskać od Google oficjalne wskazówki dotyczące kwestii technicznych, odwiedź Forum dla deweloperów dotyczące inteligentnych domów:
Aby uzyskać pomoc techniczną od społeczności, użyj tagu google-smart-home
na stronie Stack Overflow: