Przekazywanie pakietu SDK Home Mobile SDK

Na tej stronie omawiamy wykorzystanie wybranych funkcji interfejsu API do uruchamiania w narzędziu Google Home Mobile SDK.

Blokuj powiadomienia o odkrywaniu na podstawie prowizji

Powiadomienie w Androidzie o połowie arkusza
Rysunek 1. Przykład powiadomienia Androida dotyczącego połowy planszy

Domyślnie funkcja Google Play services w systemie Android używa powiadomień „pół arkusza” zasłaniających dolną połowę ekranu urządzenia mobilnego, aby z wyprzedzeniem informować użytkowników o tym, że w pobliżu znajdują się urządzenia dostępne do uruchomienia (Matter).

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

Wyłączenie włączone przez ten interfejs API przekracza limit czasu, jeśli aplikacja znajduje się na pierwszym planie przez ponad 15 minut. Aby ponownie włączyć pomijanie po upływie limitu czasu, wywołaj ponownie suppressHalfSheetNotification(). W przeciwnym razie zaczną się pojawiać powiadomienia dotyczące połowy arkusza.

Implementację tego interfejsu API znajdziesz tutaj: Google Home Sample App for Matter. Więcej informacji znajdziesz na stronie HalfSheetSuppressionObserver.kt.

Wskazywanie możliwości uruchamiania obsługi standardu Matter

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

Do deklaracji application w pliku AndroidManifest.xml dodaj ten intent-filter:

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

Zobacz nasz przykładowy plik manifestu aplikacji.

Selektor aplikacji

Selektor aplikacji

Aplikacja może wyświetlać się w selektorze aplikacji podczas uruchamiania na 2 sposoby:

  1. Na ekranie Wybierz aplikację.
  2. Jeśli użytkownicy klikną opcję Wybierz inną aplikację, opcja ta pojawi się na ekranie Inne zainstalowane aplikacje.

Sugerowane aplikacje

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

  • Pierwsza to zawsze Google Home app (GHA).
  • Druga dotyczy preferowanej aplikacji producenta urządzenia, jeśli jest ona zdefiniowany w projekcie Developer Console powiązanym z identyfikatorem VID lub PID urządzenia. Preferowany przez producenta urządzenia aplikacja Prowizje

Aplikacje są widoczne na ekranie Wybierz aplikację w dwóch sytuacjach.

  1. Zainstalowane – Play services sprawdź, czy aplikacja obsługuje filtr intencji ACTION_COMMISSION_DEVICE. W przypadku braku filtra intencji użytkownik jest kierowany do Sklepu Play, aby zaktualizować aplikację.
  2. Nie zainstalowano – zanim użytkownik przejdzie dalej, zostanie przekierowany do Sklepu Play, gdzie może zainstalować aplikację.