Przekazywanie pakietu SDK Home Mobile SDK

Na tej stronie opisujemy, jak korzystać z wybranych funkcji interfejsu API do uruchamiania w Google Home Mobile SDK.

Wyłączanie powiadomień o odkrywaniu treści, za które można otrzymać prowizję

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

Domyślnie Google Play services na Android używa powiadomień „halfsheet”, które zajmują dolną połowę ekranu urządzenia mobilnego, aby aktywnie informować użytkowników o tym, że w pobliżu znajdują się urządzenia Matter, za które można otrzymać prowizję.

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

Tłumienie włączone przez ten interfejs API ulega przekroczeniu limitu czasu, jeśli aplikacja działa na pierwszym planie dłużej niż 15 minut. Aby ponownie włączyć tłumienie po upływie limitu czasu, należy ponownie wywołać funkcję suppressHalfSheetNotification(). W przeciwnym razie zaczną pojawiać się powiadomienia w formacie halfsheet.

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

Wskazywanie obsługi procesu wprowadzania urządzenia Matter

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

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

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

Aby uzyskać informacje, zobacz manifest przykładowej aplikacji.

Selektor aplikacji

Selektor aplikacji

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

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

Sugerowane aplikacje

W selektorze aplikacji wyświetlają się 2 proponowane aplikacje.

  • Pierwszy jest zawsze Google Home app (GHA).
  • Drugi dotyczy preferowanej aplikacji producenta urządzenia, jeśli jest ona zdefiniowana w projekcie powiązanym z identyfikatorem VID lub PID urządzenia.Developer Console Preferowana aplikacja producenta urządzenia do obsługi urządzenia

Gdy aplikacje znajdują się na ekranie Wybierz aplikację, możliwe są 2 scenariusze.

  1. Zainstalowano – Play services sprawdź, czy aplikacja obsługuje filtr intencji ACTION_COMMISSION_DEVICE. Jeśli filtr intencji nie jest dostępny, użytkownik zostanie przekierowany do Sklepu Play, aby zaktualizować aplikację.
  2. Nie zainstalowano – użytkownik jest przekierowywany do Sklepu Play, aby zainstalować aplikację przed kontynuowaniem.