Standardmäßig werden Benachrichtigungen von einer Smartphone-App an alle gekoppelten Smartwatches weitergeleitet oder mit ihnen geteilt. Wenn du eine Smartwatch-App erstellst und deine App auch auf einem gekoppelten Smartphone vorhanden ist, erhalten Nutzer möglicherweise doppelte Benachrichtigungen – eine, die von der Smartphone-App generiert und weitergeleitet wird, und eine, die von der Smartwatch-App generiert wird. Wear OS bietet Funktionen, mit denen du festlegen kannst, wie und wann Benachrichtigungen weitergeleitet werden.
Doppelte Benachrichtigungen vermeiden
Wenn du Benachrichtigungen von einer externen Quelle wie Firebase Cloud Messaging erstellst, können deine Smartphone-App und deine Smartwatch-App jeweils eigene Benachrichtigungen auf der Smartwatch anzeigen. Um Duplikate zu vermeiden, deaktiviere die Brückenbenachrichtigungen in deiner Smartwatch-App programmatisch.
Bridge-Tags verwenden
Wenn du einige der Benachrichtigungen, die deine Smartphone-App erstellt, an die Smartwatch weiterleiten möchtest, wenn deine Smartwatch-App installiert ist, lege Bridge-Tags fest.
Mit der Methode setBridgeTag(String) können Sie ein Bridge-Tag für eine Benachrichtigung festlegen, wie im folgenden Codebeispiel gezeigt:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setBridgeTag("tagOne") ) .build()
Bridging deaktivieren
Du kannst die Weiterleitung für einige oder alle Benachrichtigungen deaktivieren. Wir empfehlen, die Überbrückung selektiv zu deaktivieren.
Bridging nur für bestimmte Benachrichtigungen deaktivieren
Sie können die Überbrückung dynamisch deaktivieren und optional einige Benachrichtigungen basierend auf ihrem Tag zulassen. Wenn Sie beispielsweise die Übertragung für alle Benachrichtigungen außer denen mit den Tags tagOne, tagTwo oder tagThree deaktivieren möchten, verwenden Sie das Objekt BridgingConfig, wie im folgenden Beispiel gezeigt:
// 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() )
Bridging für alle Benachrichtigungen deaktivieren (nicht empfohlen)
Wenn du die Weiterleitung aller Benachrichtigungen von einer Smartphone-App verhindern möchtest, verwende den Eintrag <meta-data> in der Manifestdatei der Smartwatch-App, wie im folgenden Beispiel gezeigt:
<!-- 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" />
ID für das Schließen festlegen, um ähnliche Benachrichtigungen zu synchronisieren
Wenn Sie die Überbrückung mit der Funktion „Bridge-Modus“ verhindern, werden geschlossene Benachrichtigungen nicht auf den Geräten eines Nutzers synchronisiert.
Wenn jedoch ähnliche Benachrichtigungen sowohl auf dem Smartphone als auch auf der Smartwatch erstellt werden, sollen beide Benachrichtigungen geschlossen werden, wenn der Nutzer eine davon schließt.
In der NotificationCompat.WearableExtender kannst du eine global eindeutige ID festlegen. Wenn ein Nutzer dann eine Benachrichtigung schließt, werden auch andere Benachrichtigungen mit derselben ID auf gekoppelten Smartwatches geschlossen.
Die Klasse NotificationCompat.WearableExtender enthält Methoden, mit denen Sie Ablehnungs-IDs verwenden können, wie im folgenden Beispiel gezeigt:
Wenn der Nutzer die Benachrichtigung schließt, werden alle anderen Benachrichtigungen mit derselben Schließ-ID auf der Smartwatch und auf dem Smartphone geschlossen. Verwenden Sie getDismissalId(), um eine Ablehnungs-ID abzurufen.
Im folgenden Beispiel wird eine global eindeutige ID für eine neue Benachrichtigung angegeben, damit das Schließen synchronisiert wird:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setDismissalId("abc123") ) .build()
Nur lokale Benachrichtigungen
Wenn Sie doppelte Benachrichtigungen vermeiden möchten, können Sie auch setLocalOnly() verwenden, um Benachrichtigungen lokal auf dem Smartphone zu speichern.
Verwende diese Methode jedoch nur, wenn die Benachrichtigung nur auf dem Gerät angezeigt werden soll, auf dem sie erstellt wurde. Dazu gehören nicht nur Wear OS-Geräte, sondern auch andere Wearables und alle anderen verbundenen Geräte. Eine rein lokale Benachrichtigung wird nicht weitergeleitet, auch wenn deine App nicht auf der Smartwatch installiert ist.
Wenn Sie eine Wear OS- und eine Smartphone-App entwickeln, die beide Benachrichtigungen erstellen, sollten Sie diesen Ansatz nicht verwenden, um doppelte Benachrichtigungen zu vermeiden. Verwenden Sie stattdessen die Überbrückungsoptionen.
Verwende beispielsweise eine lokale Benachrichtigung, wenn ein Nutzer eine Datei auf ein Smartphone herunterlädt und die Benachrichtigung angibt, dass der Download abgeschlossen ist.
Wenn Benachrichtigungen nicht weitergeleitet werden
Die folgenden Benachrichtigungstypen werden nicht weitergeleitet:
- Nur lokale Benachrichtigungen, die mit
Notification.Builder.setLocalOnly(boolean)festgelegt wurden. - Laufende Benachrichtigungen, die mit
Notification.Builder.setOngoing(boolean)oderNotification.FLAG_ONGOING_EVENTfestgelegt wurden, mit Ausnahme von Livemeldungen. Obwohl Livemeldungen laufende Benachrichtigungen sind, kann das System sie je nach Wear OS-Version und Gerätehersteller trotzdem überbrücken. - Nicht löschbare Benachrichtigungen, die mit
Notification.FLAG_NO_CLEARfestgelegt wurden. - Benachrichtigungen, bei denen die entsprechende Wearable-App die Benachrichtigungsweiterleitung deaktiviert hat.
Hinweise zur Implementierung von weitergeleiteten Benachrichtigungen
Es dauert einige Zeit, bis überbrückte Benachrichtigungen auf einem Wearable angezeigt oder von diesem entfernt werden. Vermeiden Sie beim Entwerfen Ihrer Benachrichtigungen unerwartetes Verhalten, das durch diese Latenz verursacht wird. Die folgenden Richtlinien helfen Ihnen, dafür zu sorgen, dass Ihre überbrückten Benachrichtigungen mit asynchronen Benachrichtigungen funktionieren:
- Wenn du eine Benachrichtigung auf dem Smartphone abbrichst, kann es einige Zeit dauern, bis die entsprechende Benachrichtigung auf der Smartwatch abgebrochen wird. In dieser Zeit kann der Nutzer einen der ausstehenden Intents für diese Benachrichtigung senden. Aus diesem Grund solltest du weiterhin Pending Intents in deiner App von Benachrichtigungen erhalten, die sie abgebrochen hat: Wenn du Benachrichtigungen abbrichst, müssen die Pending Intent-Empfänger dieser Benachrichtigungen gültig bleiben.
- Brechen Sie nicht alle Benachrichtigungen auf einmal ab, um sie dann alle gleichzeitig neu auszulösen. Ändern oder entfernen Sie nur die Benachrichtigungen, die tatsächlich geändert wurden. So wird die Latenz beim Aktualisieren des Wearables vermieden und die Auswirkungen der App auf die Akkulaufzeit werden reduziert.
Designaspekte
Für Wear OS-Benachrichtigungen gelten eigene Designrichtlinien. Weitere Informationen findest du in den Designrichtlinien für Wear OS.