Przekazywanie pakietu SDK Home Mobile SDK

Na tej stronie opisano korzystanie z wybranych funkcji interfejsu API do obsługi uruchamiania w Google Home Mobile SDK.

Pomijaj powiadomienia o odkrywaniu prowizji

Powiadomienie na połowie ekranu na Androidzie
Rysunek 1. Przykład powiadomienia na połowie ekranu na urządzeniu z Androidem

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

Aby uniknąć zakłóceń, 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.

Jeśli aplikacja jest na pierwszym planie przez ponad 15 minut, wyciszenie włączone przez ten interfejs API zostanie wyłączone. Aby ponownie włączyć pomijanie po upływie limitu czasu, wywołaj jeszcze raz suppressHalfSheetNotification(). W przeciwnym razie zaczną się pojawiać powiadomienia na połowie ekranu.

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

Wskazywanie obsługi udostępniania Matter

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

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

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

Jako przykładu możesz użyć pliku manifestu naszej 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ą opcję Wybierz inną aplikację, pojawi się ona na ekranie Inne zainstalowane aplikacje.

Sugerowane aplikacje

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

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

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

  1. Zainstalowana – Play services sprawdź, czy aplikacja obsługuje filtr intencji ACTION_COMMISSION_DEVICE. Jeśli brakuje filtra intencji, użytkownik zostanie przekierowany do Sklepu Play, aby zaktualizować aplikację.
  2. Nie zainstalowano – użytkownik zostanie przekierowany do Sklepu Play, aby zainstalować aplikację, zanim będzie mógł kontynuować.