De forma predeterminada, el sistema puentea o comparte las notificaciones de una app de Teléfono con cualquier reloj vinculado. Si compilas una app de reloj que también existe en un teléfono vinculado, es posible que los usuarios reciban notificaciones duplicadas: una que la app del teléfono genera y comparte en modo puente, y otra que genera la app de reloj. Wear OS incluye funciones que sirven para controlar cómo y cuándo se comparten las notificaciones en modo puente.
Cómo evitar notificaciones duplicadas
Cuando creas notificaciones desde una fuente externa, como Firebase Cloud Messaging, la app de Teléfono y la app de reloj pueden mostrar sus propias notificaciones en el reloj. Para evitar la duplicación, inhabilita de forma programática el modo puente en tu app de reloj.
Usa etiquetas de modo puente
Para compartir algunas de las notificaciones que crea la app de Teléfono con el reloj cuando se instala la app de reloj, configura etiquetas de modo puente.
Usa el método setBridgeTag(String) para establecer una etiqueta de modo puente en una notificación, como se indica en la siguiente muestra de código:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setBridgeTag("tagOne") ) .build()
Inhabilita el modo puente
Puedes inhabilitar el modo puente para algunas notificaciones o para todas ellas. Te recomendamos que lo hagas de manera selectiva.
Cómo inhabilitar el modo puente solo para algunas notificaciones
Puedes inhabilitar el modo puente de forma dinámica y, opcionalmente, permitir algunas notificaciones
según la etiqueta que tengan. Por ejemplo, para inhabilitar el modo puente para todas las notificaciones, excepto las etiquetadas como tagOne, tagTwo o tagThree, usa el objeto BridgingConfig, como se muestra en el siguiente ejemplo:
// 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() )
Cómo inhabilitar el modo puente para todas las notificaciones (no recomendado)
Para evitar el modo puente de todas las notificaciones de una app de Teléfono, usa la entrada <meta-data> en el archivo de manifiesto de la app de reloj, como se muestra en el siguiente ejemplo:
<!-- 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" />
Establece un ID de descarte para sincronizar notificaciones similares
Si evitas que se compartan notificaciones con la función de modo puente, el descarte de notificaciones no se sincronizará en todos los dispositivos del usuario.
Sin embargo, si se crean notificaciones similares en el teléfono y el reloj, es recomendable que ambas se descarten cuando el usuario descarte una de ellas.
Puedes establecer un ID único general en la clase
NotificationCompat.WearableExtender
para que, cuando un usuario descarte una notificación,
también se descarten otras con el mismo ID en relojes vinculados.
La clase NotificationCompat.WearableExtender tiene métodos que te permiten usar los IDs de descarte, como se muestra en el siguiente ejemplo:
Cuando el usuario descarta la notificación, también se descartan todas las que tengan el mismo ID de descarte en el reloj y el teléfono. Para recuperar un ID de cancelación, usa getDismissalId().
En el siguiente ejemplo, se especifica un ID único general para una notificación nueva, por lo que se sincroniza el descarte:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setDismissalId("abc123") ) .build()
Notificaciones solo locales
Para evitar las notificaciones duplicadas, también puedes usar setLocalOnly() para que las notificaciones sean locales en el teléfono.
Sin embargo, usa este método solo si la notificación debe aparecer únicamente en el dispositivo que la creó. Esto incluye no solo los dispositivos Wear OS, sino también otros wearables y cualquier otro dispositivo conectado. Una notificación solo local no se conecta, incluso si tu app no está instalada en el reloj.
Cuando compiles una app para Wear OS y una app de Teléfono que creen notificaciones, no uses este enfoque para evitar notificaciones duplicadas. En su lugar, usa las opciones de puente.
Por ejemplo, usa una notificación solo local cuando un usuario descargue un archivo en un teléfono y la notificación indique que se completó la descarga.
Cuándo no se comparten las notificaciones en modo puente
El sistema no comparte en modo puente los siguientes tipos de notificaciones:
- Notificaciones solo locales configuradas con
Notification.Builder.setLocalOnly(boolean) - Notificaciones recurrentes configuradas con
Notification.Builder.setOngoing(boolean)oNotification.FLAG_ONGOING_EVENT, excepto las novedades en tiempo real Aunque las novedades en tiempo real son notificaciones continuas, es posible que el sistema las vincule según la versión de Wear OS y el fabricante del dispositivo. - Notificaciones que no se pueden descartar configuradas con
Notification.FLAG_NO_CLEAR - Notificaciones en las que la app para wearables equivalente inhabilitó el modo puente de las notificaciones
Consideraciones sobre la implementación de las notificaciones conectadas
Lleva tiempo enviar o quitar notificaciones compartidas desde un dispositivo wearable. Cuando diseñes tus notificaciones, evita comportamientos imprevistos causados por esta latencia. Los siguientes lineamientos te ayudarán a asegurarte de que tus notificaciones compartidas funcionen con las notificaciones asíncronas:
- Si cancelas una notificación en el teléfono, la notificación correspondiente en el reloj podría tardar un tiempo en cancelarse. Durante este tiempo, el usuario podría enviar uno de los intents pendientes en esa notificación. Por este motivo, continúa recibiendo en la app los intents pendientes de las notificaciones que se cancelaron: cuando se cancelen las notificaciones, mantén válidos sus receptores de intent.
- No canceles ni vuelvas a activar una pila completa de notificaciones al mismo tiempo. Solo cambia o quita las notificaciones que realmente se hayan modificado. Esto evita la latencia durante la actualización del dispositivo wearable y reduce el impacto de la app en la duración de batería.
Consideraciones del diseño
Las notificaciones de Wear OS tienen sus propios lineamientos de diseño. Para obtener más información, consulta los lineamientos de diseño de Wear OS.