Przykładowa aplikacja Google Home do spraw

Przykładowa aplikacja Google Home dla standardu Matter

W elemencie Google Home Sample App for Matter używany jest protokół Google Home Mobile SDK. aby stworzyć aplikację na Androida podobną do Google Home app (GHA) Ta przykładowa aplikacja udostępnia te funkcje:

  • Przekazuj fizyczne i wirtualne urządzenia Matter do Lokalna tkanina na Androida
  • Przekazuj urządzenia fizyczne i wirtualne do tkaniny programistycznej
  • Steruj urządzeniami w szkieletowej dla programistów, na przykład włącz niższe
  • Funkcje dla wielu administratorów umożliwiają udostępnianie urządzeń w środowisku programistycznym z innymi aplikacjami i odwrotnie, urządzenia z tkaniny współdzielone z innych aplikacji
  • Narzędzia dla programistów

Z tego przewodnika dowiesz się, jak zainstalować i korzystać z pakietu APK Sample App for Matter i udostępniać na niej Matter urządzeń, a następnie nimi sterować i udostępniać.

Aby pobrać kod źródłowy, dowiedzieć się, jak zintegrować Mobile SDK, i spersonalizować ekrany w Android Studio, skorzystaj z kursu Sample App for Matter.

Otwórz ćwiczenia z programowania dotyczące: Sample App for Matter

Wymagania wstępne

Nie potrzebujesz centrum, np. Google Nest Hub (2nd gen), do prowizji i sterować urządzeniami za pomocą Sample App for Matter.

Zainstaluj

  1. Otwórz sekcję Wersje. w Sample App for Matter usłudze GitHub z repozytorium. Najnowszą wersję znajdziesz w sekcji Zasoby. plik APK o nazwie GHSAFM-version-default-debug.apk Nie zaznaczaj targetcommissioner

  2. Zainstaluj Android Debug Bridge (adb):

    Zainstaluj adb

  3. Podłą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-version-default-debug.apk

Urządzenia korzystające ze strategii Prowizje

Przy pierwszym uruchomieniu przykładowej aplikacji zobaczysz okno link do Sample App for Matter ćwiczeń z programowania. Jeśli wybierzesz Nie pokazuj ponownie tego komunikatu, możesz przywrócić to okno. w dowolnym momencie, aktualizując ustawienia w sekcji Administracja.

W następnych krokach dodasz urządzenie Matter do Lokalna tkanina na Androida i tkanina programistyczna, która jest lokalna dla próbki tylko w aplikacji.

Czym są materiały Matter?

Przykładowa aplikacja Google Home dla Matter

Tkanina Matter to wspólna domena zaufania między urządzeniami w sieci domowej, która pozwala im komunikować się ze sobą.

Urządzenia mogą mieć co najmniej jedną tkaninę odpowiadającą platformie, aplikacji lub grupy urządzeń, które wchodzą ze sobą w interakcję. Tkaniny mają unikalne cechy identyfikator, a urządzenia korzystają z tego samego zestawu danych logowania i urzędu certyfikacji (CA). Te dane logowania są przypisywane w ciągu Matter uruchomienia.

Aby uruchomić urządzenie Matter, wykonaj te czynności:

  1. Kliknij przycisk Dodaj () Przycisk urządzenia do rozpoczęcia procesu uruchamiania.

    Dodaj urządzenie

  2. Następnie element sterujący jest przekazywany do aplikacji Google Play services, która została uruchomiona z połączenia z numerem Mobile SDK. Aby potwierdzić dowód posiadanie urządzenia, zeskanuj kod QR lub kliknij Użyj kodu parowania.

    Zeskanuj kod QR

  3. Po zakończeniu uruchamiania wpisz nazwę urządzenia i kliknij Gotowe.

Twoje urządzenie jest teraz połączone zarówno z lokalną tkaniną, jak i z włókiennicze.

Wszystkie prace związane z uruchomieniem i powiązane z nimi ekrany są obsługiwane Play services podczas uruchamiania urządzeń. Ten zapewnia spójne wrażenia użytkownika i eliminuje potrzebę obsługi kontrowersyjnych treści. uprawnienia, na przykład dane logowania do Wi-Fi i Thread.

Steruj urządzeniami

Tkanina programistyczna tworzy dane logowania do kontroli Matter urządzeń bezpośrednio z przykładowej aplikacji.

Na ekranie głównym możesz przełączyć urządzenie w pozycję włączenia lub wyłączenia. Kliknij urządzenie, aby wyświetlić jego szczegóły.

Dodano urządzenie

Udostępnianie urządzeń

Udostępnianie urządzenia jest określane jako proces przez wielu administratorów. Specyfikacja Matter. Po udostępnieniu aplikacji próbnej na urządzeniu możesz je łatwo udostępnić. z innymi ekosystemami.

Aby udostępnić urządzenie Matter innym ekosystemom, musisz mieć zainstalowaną inną platformę na urządzeniu z Androidem. Ten staje się docelowym komisarzem ds. usług. Utworzyliśmy kolejne instancji przykładowej aplikacji, której możesz używać jako komisarza docelowego.

  1. Otwórz sekcję Releases (Publikacje) w repozytorium GitHub Sample App for Matter. Najnowszą wersję znajdziesz w sekcji Zasoby. plik APK o nazwie GHSAFM-version-targetcommissioner-debug.apk Nie wybieraj opcji default.

  2. Zainstaluj docelowego komisarza.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. Na ekranie głównym kliknij urządzenie, aby wyświetlić informacje o nim. Dotknięcie Udostępnij.

    Udostępnij urządzenie

Przykładowa aplikacja wywołuje interfejs Mobile SDK Share API i po raz kolejny element sterujący zostanie przeniesiony na: Play services.

Pojawi się arkusz udostępniania, w którym możesz wybrać aplikację lub platformę które chcesz sparować z urządzeniem. Są na nim dwa sposoby udostępniania urządzenie:

  1. Ręcznie za pomocą kodu konfiguracji udostępnianego docelowej aplikacji komisarza
  2. Za pomocą lokalnej aplikacji na Androida, która została zarejestrowana jako Matter komisarz

Aplikacja komisarza ds. kierowania ma etykietę GHSAFM-TC. Kliknij to wystąpienie przykładową aplikację, aby udostępnić urządzenie.

Następnie aplikacja zewnętrzna (inwestycja docelowa) wykonuje uruchomienie we własnej tkaninie.

Ustawienia

Na ekranie głównym kliknij ustawienia Ikona aplikacji . Tutaj możesz: zaktualizować preferencje użytkownika, uzyskać pomoc i dowiedzieć się więcej o aplikacji.

Ustawienia

Powiadomienie dotyczące połowy arkusza

Na ekranie Ustawienia możesz wyłączyć proaktywne prowizje powiadomienia o odkrywaniu dotyczące Matter urządzeń.

Jeśli Twoja aplikacja udostępnia własne wykrywanie Matter lub możesz wyłączyć te powiadomienia, aby zapobiec . Zobacz Pomijanie wykrywania z prowizją powiadomienia .

Narzędzia dla programistów

Na ekranie Ustawienia znajdziesz też Narzędzia dla programistów.

Sprawdzanie zawartości repozytoriów DataStore dotyczących urządzenia i ustawień użytkownika w Logcat:

  1. Kliknij Zawartość repozytoriów logów.

  2. Kliknij OK w oknie, a następnie sprawdź Logcat.

Opinie i pomoc

Podziel się swoimi przemyśleniami i opiniami na temat tego, jak możemy ulepszyć jeśli chcesz poznać usługę Sample App for Matter, wypełnij nasz formularz opinii.

Prześlij nam swoją opinię

Jeśli masz problemy z kartą Sample App for Matter, spróbuj ukończyć instrukcje weryfikacji środowiska:

Jeśli masz pytania dotyczące korzystania z przykładowej aplikacji lub wykrycia błędu w kodzie, mogą przesyłać problemy do narzędzia Issue Tracker w repozytorium GitHub:

Aby uzyskać oficjalne wskazówki Google dotyczące pytań technicznych, skorzystaj z forum dla programistów urządzeń Smart Home:

Aby uzyskać pomoc techniczną od społeczności, użyj tagu google-smart-home na Stack Overflow: