Domyślnie system udostępnia powiadomienia z aplikacji na telefonie wszystkim sparowanym zegarkom. Jeśli utworzysz aplikację na zegarek, która jest też zainstalowana na sparowanym telefonie, użytkownicy mogą otrzymywać powiadomienia podwójnie – jedno wygenerowane i przekazane przez aplikację na telefonie, a drugie wygenerowane przez aplikację na zegarku. Wear OS zawiera funkcje, które pozwalają kontrolować, jak i kiedy powiadomienia są przekazywane.
Unikanie podwójnych powiadomień
Gdy tworzysz powiadomienia ze źródła zewnętrznego, takiego jak Komunikacja w chmurze Firebase, aplikacja na telefon i aplikacja na zegarek mogą wyświetlać na zegarku własne powiadomienia. Aby uniknąć duplikowania, programowo wyłącz udostępnianie w aplikacji na zegarek.
Używanie tagów mostu
Aby przekazywać niektóre powiadomienia tworzone przez aplikację na telefonie do zegarka, gdy jest na nim zainstalowana aplikacja na zegarek, ustaw tagi mostka.
Ustaw tag mostu w powiadomieniu za pomocą metody setBridgeTag(String), jak pokazano w tym przykładowym kodzie:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setBridgeTag("tagOne") ) .build()
Wyłącz mostkowanie
Możesz wyłączyć mostkowanie niektórych lub wszystkich powiadomień. Zalecamy wybiórcze wyłączenie mostkowania.
Wyłączanie mostkowania tylko w przypadku niektórych powiadomień
Możesz dynamicznie wyłączyć mostkowanie i opcjonalnie zezwolić na niektóre powiadomienia na podstawie ich tagu. Aby na przykład wyłączyć mostkowanie wszystkich powiadomień z wyjątkiem tych oznaczonych tagiem tagOne, tagTwo lub tagThree, użyj obiektu BridgingConfig, jak pokazano w tym przykładzie:
// In this example, bridging is only enabled for tagOne, tagTwo and tagThree. BridgingManager.fromContext(context).setConfig( BridgingConfig.Builder(context, isBridgingEnabled = false) .addExcludedTags(listOf("tagOne", "tagTwo", "tagThree")) .build() )
Wyłącz mostkowanie wszystkich powiadomień (niezalecane)
Aby zapobiec udostępnianiu wszystkich powiadomień z aplikacji na telefonie, użyj wpisu <meta-data> w pliku manifestu aplikacji na zegarek, jak pokazano w tym przykładzie:
<!-- Beware, this can have unintended consequences before the user is signed-in --> <meta-data android:name="com.google.android.wearable.notificationBridgeMode" android:value="NO_BRIDGING" />
Ustawianie identyfikatora zamknięcia w celu synchronizowania podobnych powiadomień
Jeśli uniemożliwisz mostkowanie za pomocą funkcji trybu mostka, odrzucenia powiadomień nie będą synchronizowane na urządzeniach użytkownika.
Jeśli jednak podobne powiadomienia są tworzone zarówno na telefonie, jak i na zegarku, chcesz, aby oba powiadomienia zostały zamknięte, gdy użytkownik zamknie jedno z nich.
W NotificationCompat.WearableExtender możesz ustawić globalny unikalny identyfikator, dzięki któremu po odrzuceniu powiadomienia przez użytkownika inne powiadomienia z tym samym identyfikatorem na sparowanych zegarkach również zostaną odrzucone.
Klasa NotificationCompat.WearableExtender zawiera metody, które umożliwiają używanie identyfikatorów odrzucenia, jak pokazano w tym przykładzie:
Gdy użytkownik odrzuci powiadomienie, wszystkie inne powiadomienia z tym samym identyfikatorem odrzucenia zostaną odrzucone na zegarku i telefonie. Aby pobrać identyfikator odrzucenia, użyj getDismissalId().
W tym przykładzie dla nowego powiadomienia określono globalnie unikalny identyfikator, dzięki czemu zamknięcia są synchronizowane:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setDismissalId("abc123") ) .build()
Powiadomienia tylko lokalne
Aby uniknąć powielania powiadomień, możesz też użyć setLocalOnly(), aby powiadomienia były wyświetlane lokalnie na telefonie.
Używaj tej metody tylko wtedy, gdy powiadomienie musi pojawiać się wyłącznie na urządzeniu, na którym zostało utworzone. Dotyczy to nie tylko urządzeń z Wear OS, ale też innych urządzeń do noszenia i innych połączonych urządzeń. Powiadomienie tylko lokalne nie jest przekazywane, nawet jeśli aplikacja nie jest zainstalowana na zegarku.
Jeśli tworzysz aplikację na Wear OS i telefon, które generują powiadomienia, nie używaj tego podejścia, aby uniknąć duplikowania powiadomień. Zamiast tego użyj opcji mostkowania.
Na przykład użyj powiadomienia tylko lokalnego, gdy użytkownik pobierze plik na telefon, a powiadomienie będzie wskazywać, że pobieranie zostało zakończone.
Kiedy powiadomienia nie są przekazywane
System nie przekazuje tych typów powiadomień:
- Powiadomienia tylko lokalne ustawione za pomocą
Notification.Builder.setLocalOnly(boolean). - Bieżące powiadomienia ustawione za pomocą
Notification.Builder.setOngoing(boolean)lubNotification.FLAG_ONGOING_EVENT, z wyjątkiem aktualizacji na żywo. Chociaż aktualizacje na żywo są powiadomieniami ciągłymi, system może je nadal przekazywać w zależności od wersji Wear OS i producenta urządzenia. - Powiadomienia, których nie można usunąć, ustawione za pomocą
Notification.FLAG_NO_CLEAR. - Powiadomienia, w przypadku których odpowiednia aplikacja na urządzenie do noszenia ma wyłączone przekazywanie powiadomień.
Uwagi dotyczące wdrażania powiadomień mostkowanych
Przesłanie lub usunięcie powiadomień mostkowanych z urządzenia do noszenia może trochę potrwać. Podczas projektowania powiadomień unikaj nieoczekiwanego działania spowodowanego tym opóźnieniem. Aby powiadomienia mostkowane działały z powiadomieniami asynchronicznymi, postępuj zgodnie z tymi wskazówkami:
- Jeśli anulujesz powiadomienie na telefonie, może minąć trochę czasu, zanim odpowiednie powiadomienie zostanie anulowane na zegarku. W tym czasie użytkownik może wysłać jedną z intencji oczekujących w tym powiadomieniu. Z tego powodu nadal otrzymuj w aplikacji intencje oczekujące z anulowanych powiadomień: podczas anulowania powiadomień zachowaj ważność odbiorców intencji oczekujących tych powiadomień.
- Nie anuluj i nie uruchamiaj ponownie całego stosu powiadomień naraz. Zmieniaj lub usuwaj tylko te powiadomienia, które zostały faktycznie zmodyfikowane. Pozwala to uniknąć opóźnień w aktualizowaniu urządzenia do noszenia i zmniejsza wpływ aplikacji na czas pracy na baterii.
Uwagi dotyczące projektowania
Powiadomienia na Wear OS mają własne wytyczne dotyczące projektowania. Więcej informacji znajdziesz we wskazówkach dotyczących projektowania na Wear OS.