Przekazywanie pakietu SDK Home Mobile SDK

Na tej stronie omawiamy korzystanie z wybranych funkcji interfejsu API do uruchamiania w: Google Home Mobile SDK.

Pomijaj powiadomienia o odkrywaniu, które można zlecać

Powiadomienie na pół strony Androida
Rysunek 1. Przykład powiadomienia na pół strony w Androidzie

Domyślnie Google Play services w systemie Android korzysta z powiadomień zakrywających dolną połowę ekranu urządzenia mobilnego, informując użytkowników, że w pobliżu znajdują się urządzenia Matter, których można użyć do zakupu.

Aby uniknąć przerw w działaniu aplikacji, gdy działa ona na pierwszym planie, możesz pominąć te powiadomienia, wywołując metodę suppressHalfSheetNotification() w metodzie Mobile SDK. Więcej informacji znajdziesz w dokumentacji interfejsu API.

Pomijanie włączone przez ten interfejs API przekracza limit czasu, jeśli aplikacja działa na pierwszym planie przez ponad 15 minut. Aby ponownie włączyć pomijanie po upływie limitu czasu, wywołaj ponownie funkcję suppressHalfSheetNotification(). W przeciwnym razie zaczną się pojawiać powiadomienia o półwymiarach.

Implementację tego interfejsu API można znaleźć tutaj: Google Home Sample App for Matter. Więcej informacji znajdziesz w sekcji HalfSheetSuppressionObserver.kt.

Wskaż pomoc dotyczącą uruchamiania Matter

Jeśli do prowizji używasz Mobile SDK, musisz dodać nazwę pakietu aplikacji w Google Home Developer Console, zaimplementować nasze interfejsy API Matter i wskazać, że aplikacja obsługuje realizację Matter, obsługując intencję ACTION_COMMISSION_DEVICE.

Dodaj intent-filter do deklaracji application w pliku AndroidManifest.xml:

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

Zapoznaj się z plikiem manifestu przykładowej aplikacji.

Selektor aplikacji

Selektor aplikacji

Aplikacja pojawia się w selektorze aplikacji podczas procesu uruchamiania na 2 sposoby:

  1. Na ekranie Wybierz aplikację.
  2. Jeśli użytkownicy wybiorą opcję Wybierz inną aplikację, będzie ona widoczna na ekranie Inne zainstalowane aplikacje.

Sugerowane aplikacje

W selektorze aplikacji pojawią się 2 sugerowane aplikacje.

  • Pierwszy z nich to zawsze Google Home app (GHA).
  • Drugi sposób dotyczy preferowanej aplikacji producenta urządzenia, jeśli jest ona zdefiniowana w projekcie Developer Console powiązanym z identyfikatorem VID lub PID urządzenia. Aplikacja zależna od twórcy urządzenia

Aplikacje znajdują się na ekranie Wybierz aplikację na dwa sposoby:

  1. Zainstalowano – Play services sprawdź, czy aplikacja obsługuje filtr intencji ACTION_COMMISSION_DEVICE. Jeśli nie ma filtra intencji, użytkownik jest kierowany do Sklepu Play, aby zaktualizować aplikację.
  2. Nie zainstalowano – zanim przejdziesz dalej, użytkownik zostanie przekierowany do Sklepu Play, aby zainstalować aplikację.