Przykładowa aplikacja Google Home do spraw

Przykładowa aplikacja Matter z Google Home

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

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

  1. 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 wybieraj targetcommissioner:

    Pobierz plik APK

  2. Zainstaluj Android Debug Bridge (adb):

    Zainstaluj adb

  3. 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?

Przykładowa aplikacja Matter z Google Home

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:

  1. Kliknij przycisk Dodaj urządzenie, aby rozpocząć proces składania zamówienia.

    Dodaj urządzenie

  2. 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.

    Zeskanuj kod QR

  3. 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.

Dodano urządzenie

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.

  1. Przejdź do sekcji Wersje w repozytorium Sample App for Matter na GitHubie. Znajdź najnowszy plik APK o nazwie GHSAFM-[version]-targetcommissioner, na przykład GHSAFM-1.4.1-targetcommissioner-debug.apk:

    Pobierz strategię komisarza docelowego

  2. Zainstaluj docelowy komisarz.

    $ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
    
  3. Na ekranie głównym kliknij urządzenie, aby wyświetlić informacje na jego temat. Kliknij Udostępnij.

    Udostępnij urządzenie

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:

  1. ręcznie za pomocą kodu konfiguracji, który zostanie udostępniony aplikacji docelowej.
  2. 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.

Ustawienia

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:

  1. Kliknij Zapisz treść repozytoriów.

  2. 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.

Prześlij nam swoją opinię

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: