Przekazywanie pakietu SDK Home Mobile SDK

Ta strona zawiera informacje o używaniu wybranych funkcji interfejsu API do inicjowania w interfejsie Google Home Mobile SDK.

Wyłączanie powiadomień o możliwości zarobku

Powiadomienie w karcie połówkowej na Androidzie
Rysunek 1. Przykład powiadomienia w układce połowy ekranu na Androidzie

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

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

Wyłączenie funkcji obsługiwane przez ten interfejs API wygasa, jeśli aplikacja jest na pierwszym planie przez ponad 15 minut. Aby ponownie włączyć pominięcie po upływie limitu czasu, ponownie wywołaj funkcję suppressHalfSheetNotification(), w przeciwnym razie zaczną się pojawiać powiadomienia na półpełnym ekranie.

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

Wspieranie tworzenia Matter

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

Dodaj do deklaracji application w pliku AndroidManifest.xml te wartości: intent-filter:

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

Przykładowy plik manifestu aplikacji

Selektor aplikacji

Selektor aplikacji

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

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

Sugerowane aplikacje

Selektor aplikacji wyświetla 2 polecane aplikacje.

  • Pierwszy jest zawsze Google Home app (GHA).
  • Drugi to preferowana aplikacja producenta urządzenia, jeśli jest zdefiniowana w projekcie Developer Console powiązanym z identyfikatorem VID lub PID urządzenia. Aplikacja preferowanego dostawcy urządzenia

Aplikacje na ekranie Wybierz aplikację mogą się tam znaleźć w 2 sytuacjach.

  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 zainstalowana – użytkownik jest przekierowywany do Sklepu Play, aby zainstalować aplikację, zanim będzie można kontynuować.