Przekazywanie pakietu SDK Home Mobile SDK

Ta strona zawiera informacje o korzystaniu z wybranych funkcji interfejsu Commissioning API w Google Home Mobile SDK.

Wyłączanie powiadomień o wykryciu urządzeń, które można skonfigurować

Powiadomienie w formie półarkusza w Androidzie
Rysunek 1. Przykład powiadomienia w postaci półarkusza w Androidzie

Domyślnie Google Play services w Android używa powiadomień w postaci półarkusza, które zajmują dolną połowę ekranu urządzenia mobilnego , aby proaktywnie informować użytkowników o tym, że w pobliżu znajdują się urządzenia Matter, które można skonfigurować.

Aby zapobiec przerwom, gdy aplikacja jest na pierwszym planie, możesz wyłączyć te powiadomienia, wywołując suppressHalfSheetNotification() metodę w Mobile SDK. Więcej informacji znajdziesz w dokumentacji interfejsu API.

Wyłączenie włączone przez ten interfejs API wygasa, jeśli aplikacja jest na pierwszym planie przez ponad 15 minut. Aby ponownie włączyć wyłączenie po upływie limitu czasu, ponownie wywołaj metodę suppressHalfSheetNotification(). W przeciwnym razie zaczną się pojawiać powiadomienia w postaci półarkusza.

Implementację tego interfejsu API znajdziesz w Google Home Sample App for Matter. Więcej informacji znajdziesz w pliku HalfSheetSuppressionObserver.kt.

Wskazywanie obsługi konfiguracji Matter

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

Dodaj następujące intent-filter do deklaracji application w pliku AndroidManifest.xml:

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

Więcej informacji znajdziesz w manifeście naszej przykładowej aplikacji.

Selektor aplikacji

Selektor aplikacji

Podczas procesu konfiguracji aplikacja może się pojawić w selektorze aplikacji na 2 sposoby:

  1. Na ekranie Wybierz aplikację.
  2. Jeśli użytkownicy wybiorą Wybierz inną aplikację, aplikacja pojawi się na ekranie Inne zainstalowane aplikacje.

Sugerowane aplikacje

Selektor aplikacji wyświetla 2 sugerowane aplikacje.

  • Pierwsza to zawsze Google Home app (GHA).
  • Druga to preferowana aplikacja producenta urządzenia, jeśli jest zdefiniowana w Developer Console projekcie powiązanym z identyfikatorem VID lub PID urządzenia. Preferowana aplikacja producenta urządzenia do obsługi urządzenia

Aplikacje mogą się pojawić na ekranie Wybierz aplikację w 2 przypadkach:

  1. Zainstalowana – Play services sprawdzają, czy aplikacja obsługuje ACTION_COMMISSION_DEVICE filtr intencji. Jeśli filtr intencji jest nieobecny, użytkownik zostanie przekierowany do Sklepu Play, aby zaktualizować aplikację.
  2. Niezainstalowana – użytkownik zostanie przekierowany do Sklepu Play, aby zainstalować aplikację przed kontynuowaniem.