Per impostazione predefinita, il sistema condivide, o condivide, le notifiche di un'app Telefono con tutti gli smartwatch accoppiati. Se crei un'app dell'orologio e la tua app esiste anche su uno smartphone accoppiato, gli utenti potrebbero ricevere notifiche duplicate: una che l'app Telefono genera e condivide, e una che l'app dell'orologio genera. Wear OS include funzionalità per controllare come e quando vengono trasferite le notifiche.
Evita le notifiche duplicate
Quando crei notifiche da una fonte esterna, ad esempio da Firebase Cloud Messaging, l'app Telefono e l'app dell'orologio possono mostrare ciascuna le proprie notifiche sullo smartwatch. Per evitare duplicazioni, disattiva il bridging in modo programmatico nell'app dell'orologio.
Utilizza i tag bridge
Per trasferire alcune delle notifiche create dall'app Telefono all'app dell'orologio quando l'app dell'orologio è installata, imposta i tag di trasferimento.
Imposta un tag bridge su una notifica utilizzando il metodo
setBridgeTag(String),
come mostrato nell'esempio di codice seguente:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setBridgeTag("tagOne") ) .build()
Disattiva il bridging
Puoi disattivare il bridging per alcune notifiche o per tutte. Ti consigliamo di disattivare il bridging in modo selettivo.
Disattiva il bridging solo per alcune notifiche
Puoi disattivare dinamicamente il bridging e, facoltativamente, consentire il passaggio di alcune notifiche in base al loro tag. Ad esempio, per disattivare il bridging per tutte le notifiche, ad eccezione di quelle taggate come tagOne, tagTwo o tagThree, utilizza l'oggetto BridgingConfig come mostrato nell'esempio seguente:
// 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() )
Disattiva il bridging per tutte le notifiche (opzione non consigliata)
Per impedire la condivisione di tutte le notifiche da un'app Telefono, utilizza la voce <meta-data> nel file manifest dell'app dell'orologio, come mostrato nell'esempio seguente:
<!-- 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" />
Imposta un ID di chiusura per sincronizzare notifiche simili
Quando impedisci la modalità bridge con la funzionalità della modalità bridge, le chiusure delle notifiche non vengono sincronizzate tra i dispositivi di un utente.
Tuttavia, se vengono create notifiche simili sia sullo smartphone che sullo smartwatch, vuoi che entrambe le notifiche vengano ignorate quando l'utente ne ignora una.
In
NotificationCompat.WearableExtender,
puoi impostare un ID univoco globale in modo che, quando un utente chiude una notifica,
vengano chiuse anche le altre notifiche con lo stesso ID sugli smartwatch accoppiati.
La classe NotificationCompat.WearableExtender include metodi che ti consentono di utilizzare gli ID di chiusura, come mostrato nell'esempio seguente:
Quando l'utente chiude la notifica, tutte le altre notifiche con lo stesso ID di chiusura vengono chiuse sullo smartwatch e sullo smartphone. Per recuperare un ID di chiusura, utilizza getDismissalId().
Nell'esempio seguente, viene specificato un ID univoco globale per una nuova notifica, in modo che le chiusure vengano sincronizzate:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setDismissalId("abc123") ) .build()
Notifiche solo locali
Per evitare notifiche duplicate, puoi anche utilizzare setLocalOnly() per
rendere le notifiche locali sullo smartphone.
Tuttavia, utilizza questo metodo solo se la notifica deve essere visualizzata solo sul dispositivo che l'ha creata. Sono inclusi non solo i dispositivi Wear OS, ma anche altri dispositivi indossabili e qualsiasi altro dispositivo connesso. Una notifica solo locale non viene trasferita, anche se l'app non è installata sullo smartwatch.
Quando crei un'app per Wear OS e un'app Telefono che generano entrambe notifiche, non utilizzare questo approccio per evitare notifiche duplicate. Utilizza invece le opzioni di bridging.
Ad esempio, utilizza una notifica solo locale quando un utente scarica un file su uno smartphone e la notifica indica che il download è stato completato.
Quando le notifiche non vengono trasferite
Il sistema non trasferisce i seguenti tipi di notifiche:
- Notifiche solo locali impostate utilizzando
Notification.Builder.setLocalOnly(boolean). - Notifiche in corso impostate utilizzando
Notification.Builder.setOngoing(boolean)oNotification.FLAG_ONGOING_EVENT, ad eccezione degli aggiornamenti in tempo reale. Sebbene gli aggiornamenti in tempo reale siano notifiche in corso, il sistema potrebbe comunque collegarli a seconda della versione di Wear OS e del produttore del dispositivo. - Notifiche non cancellabili impostate utilizzando
Notification.FLAG_NO_CLEAR. - Notifiche in cui l'app per dispositivi indossabili corrispondente ha disattivato il bridging delle notifiche.
Considerazioni sull'implementazione per le notifiche con bridge
L'invio o la rimozione delle notifiche con bridge da un dispositivo indossabile richiede tempo. Quando progetti le notifiche, evita comportamenti imprevisti causati da questa latenza. Le seguenti linee guida ti aiutano a garantire che le notifiche con bridge funzionino con le notifiche asincrone:
- Se annulli una notifica sullo smartphone, potrebbe essere necessario un po' di tempo per annullare la notifica corrispondente sullo smartwatch. Durante questo periodo, l'utente potrebbe inviare uno dei pending intent relativi alla notifica. Per questo motivo, continua a ricevere pending intent nella tua app dalle notifiche che ha annullato: quando annulli le notifiche, mantieni validi i ricevitori dei pending intent di queste notifiche.
- Non annullare e riattivare un intero stack di notifiche contemporaneamente. Modifica o rimuovi solo le notifiche che sono state effettivamente modificate. In questo modo, eviti la latenza nell'aggiornamento del dispositivo indossabile e riduci l'impatto dell'app sulla durata della batteria.
Note sul layout
Le notifiche di Wear OS hanno linee guida per la progettazione specifiche. Per ulteriori informazioni, consulta le linee guida per il design di Wear OS.