Przykładowa aplikacja Google Home do spraw

Przykładowa aplikacja Google Home dla 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:

  • Zamawianie fizycznych i wirtualnych urządzeń Matter w ramach usługi Local Android fabric
  • Przekazuj urządzenia fizyczne i wirtualne do tkaniny programistycznej
  • sterować urządzeniami w Twoim środowisku deweloperskim, na przykład włączać światło;
  • Funkcje dotyczące wielu administratorów umożliwiają udostępnianie urządzeń w sieć rozwojową innym aplikacjom oraz uwzględnianie w tej sieci urządzeń udostępnionych przez inne aplikacje.
  • Narzędzia dla programistów
.

W tym przewodniku opisano, jak zainstalować plik APK Sample App for Matter i jak go używać do konfigurowania, kontrolowania i udostępniania urządzeń Matter.

Aby pobrać kod źródłowy, dowiedz się, jak zintegrować Mobile SDK i dostosuj ekrany w Android Studio, wypróbuj Ćwiczenie z programowania: 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ę Releases (Publikacje) w repozytorium GitHub Sample App for Matter. Najnowszą wersję znajdziesz w sekcji Zasoby. plik APK o nazwie GHSAFM-version-default-debug.apk Nie wybieraj opcji targetcommissioner.

  2. Zainstaluj Android Debug Bridge (adb):

    Zainstaluj adb

  3. Podłącz urządzenie z Androidem do komputera za pomocą kabla USB i włącz Przekazywanie plików, a następnie zainstaluj plik 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ą tkaniny 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ą unikalny identyfikator, a urządzenia mają ten sam zestaw danych uwierzytelniających 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 urządzenie, aby rozpocząć proces uruchamiania.

    Dodaj urządzenie

  2. Następnie kontrola zostaje przekazana aplikacji Google Play services, która jest uruchamiana z poziomu wywołania aplikacji 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 czynności związane z uruchomieniem i powiązane z nimi ekrany są obsługiwane przez 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 uzyskać dostęp do jego szczegółów.

Urządzenie zostało dodane

Udostępnianie urządzeń

Udostępnianie urządzenia jest w specyfikacji Matter określane jako proces wieloadministracyjny. Po zainstalowaniu na urządzeniu przykładowej aplikacji możesz ją łatwo udostępnić innym systemom.

Aby udostępniać urządzenie Matter innym systemom, musisz mieć na urządzeniu z Androidem zainstalowaną inną platformę. Ta zewnętrzna platforma staje się docelowym zleceniodawcą. Utworzyliśmy kolejne instancji przykładowej aplikacji, której możesz używać jako komisarza docelowego.

  1. Otwórz sekcję Wersje. w Sample App for Matter GitHubie z repozytorium. 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.

Wyświetli się panel 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:

  1. Ręcznie za pomocą kodu konfiguracji udostępnianego docelowej aplikacji komisarza
  2. za pomocą lokalnej aplikacji na Androida zarejestrowanej jako komisarz Matter

Aplikacja komisarza ds. kierowania ma etykietę GHSAFM-TC. Kliknij tę instancję przykładowej aplikacji, 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 w połowie ekranu

Na ekranie Ustawienia możesz wyłączyć proaktywne powiadomienia o możliwości zarobku dotyczące urządzeń Matter.

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.

Aby sprawdzić zawartość repozytoriów DataStore preferencji urządzenia i użytkownika w Logcat, wykonaj te czynności:

  1. Kliknij Zapisz zawartość repozytorium.

  2. Kliknij OK w oknie dialogowym, 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 znajdziesz błąd w kodzie, możesz przesłać zgłoszenie w systemie śledzenia błędów w repozytorium GitHub:

Aby uzyskać oficjalne wskazówki od Google w kwestiach technicznych, użyj inteligentnego domu Forum dla programistów:

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