Opcje mostków dla powiadomień

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ń:

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.