Sistem, varsayılan olarak bir telefon uygulamasından gelen bildirimleri eşlenen tüm saatlere köprüler veya paylaşır. Bir saat uygulaması geliştirirseniz ve uygulamanız eşlenen bir telefonda da mevcutsa kullanıcılar yinelenen bildirimler alabilir. Bu bildirimlerden biri telefon uygulamasının oluşturup köprülediği, diğeri ise saat uygulamasının oluşturduğu bildirimdir. Wear OS, bildirimlerin nasıl ve ne zaman köprüleneceğini kontrol eden özellikler içerir.
Yinelenen bildirimleri önleme
Firebase Cloud Messaging gibi harici bir kaynaktan bildirim oluşturduğunuzda telefon uygulamanız ve saat uygulamanız, saatte kendi bildirimlerini gösterebilir. Yinelenmeyi önlemek için saat uygulamanızda köprü oluşturmayı programatik olarak devre dışı bırakın.
Köprü etiketlerini kullanma
Saat uygulamanız yüklendiğinde telefon uygulamanızın oluşturduğu bildirimlerden bazılarını saate bağlamak için köprü etiketleri ayarlayın.
Aşağıdaki kod örneğinde gösterildiği gibi, setBridgeTag(String) yöntemini kullanarak bir bildirimde köprü etiketi ayarlayın:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setBridgeTag("tagOne") ) .build()
Köprü oluşturmayı devre dışı bırakma
Bazı bildirimler veya tüm bildirimler için köprü oluşturmayı devre dışı bırakabilirsiniz. Köprülemeyi seçerek devre dışı bırakmanızı öneririz.
Yalnızca bazı bildirimler için köprü oluşturmayı devre dışı bırakma
Köprü oluşturmayı dinamik olarak devre dışı bırakabilir ve isteğe bağlı olarak, etiketlerine göre bazı bildirimlere izin verebilirsiniz. Örneğin, tagOne, tagTwo veya tagThree olarak etiketlenenler dışındaki tüm bildirimler için köprü oluşturmayı devre dışı bırakmak istiyorsanız aşağıdaki örnekte gösterildiği gibi BridgingConfig nesnesini kullanın:
// 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() )
Tüm bildirimler için köprü oluşturmayı devre dışı bırak (önerilmez)
Bir telefon uygulamasındaki tüm bildirimlerin köprülenmesini önlemek için saat uygulamasının manifest dosyasında aşağıdaki örnekte gösterildiği gibi <meta-data> girişini kullanın:
<!-- 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" />
Benzer bildirimleri senkronize etmek için kapatma kimliği ayarlama
Köprü modu özelliğiyle köprü oluşturmayı engellediğinizde, bildirimlerin kapatılması kullanıcının cihazları arasında senkronize edilmez.
Ancak hem telefonda hem de saatte benzer bildirimler oluşturuluyorsa kullanıcı bildirimlerden birini kapattığında her iki bildirimin de kapatılmasını istersiniz.
NotificationCompat.WearableExtender'da,
global bir benzersiz kimlik ayarlayabilirsiniz. Böylece, kullanıcı bir bildirimi kapattığında
eşlenen saatlerde aynı kimliğe sahip diğer bildirimler de kapatılır.
NotificationCompat.WearableExtender sınıfında, aşağıdaki örnekte gösterildiği gibi kapatma kimliklerini kullanmanıza olanak tanıyan yöntemler bulunur:
Kullanıcı bildirimi kapattığında, aynı kapatma kimliğine sahip diğer tüm bildirimler saatte ve telefonda kapatılır. Reddetme kimliği almak için getDismissalId() yöntemini kullanın.
Aşağıdaki örnekte, yeni bir bildirim için genel olarak benzersiz bir kimlik belirtilmiştir. Bu sayede, kapatma işlemleri senkronize edilir:
val notification = NotificationCompat.Builder(context, channelId) // ... set other fields ... .extend( NotificationCompat.WearableExtender() .setDismissalId("abc123") ) .build()
Yalnızca yerel bildirimler
Yinelenen bildirimleri önlemek için setLocalOnly() kullanarak bildirimleri telefona özel hale de getirebilirsiniz.
Ancak bu yöntemi yalnızca bildirimin yalnızca bildirimi oluşturan cihazda görünmesi gerekiyorsa kullanın. Bu, yalnızca Wear OS cihazları değil, diğer giyilebilir cihazları ve diğer tüm bağlı cihazları da kapsar. Yalnızca yerel bildirimler, uygulamanız saatte yüklü olmasa bile köprü oluşturmaz.
Hem Wear OS hem de telefon uygulaması oluştururken her ikisi de bildirim oluşturuyorsa yinelenen bildirimleri önlemek için bu yaklaşımı kullanmayın. Bunun yerine köprü oluşturma seçeneklerini kullanın.
Örneğin, bir kullanıcı telefona dosya indirdiğinde ve bildirim, indirme işleminin tamamlandığını gösterdiğinde yalnızca yerel bildirim kullanın.
Bildirimler köprülenmediğinde
Sistem, aşağıdaki bildirim türlerini köprülemez:
Notification.Builder.setLocalOnly(boolean)kullanılarak ayarlanan yerel bildirimler.Notification.Builder.setOngoing(boolean)veyaNotification.FLAG_ONGOING_EVENTkullanılarak ayarlanan devam eden bildirimler (Canlı Haberler hariç). Canlı haberler devam eden bildirimler olsa da sistem, Wear OS sürümüne ve cihaz üreticisine bağlı olarak bunları köprüleyebilir.Notification.FLAG_NO_CLEARkullanılarak ayarlanan, temizlenemeyen bildirimler.- Karşılık gelen giyilebilir uygulamanın bildirim köprülemeyi devre dışı bıraktığı bildirimler.
Köprülü bildirimler için uygulama ile ilgili dikkat edilmesi gereken noktalar
Köprülü bildirimlerin giyilebilir bir cihaza gönderilmesi veya cihazdan kaldırılması zaman alır. Bildirimlerinizi tasarlarken bu gecikmenin neden olduğu beklenmedik davranışlardan kaçının. Aşağıdaki yönergeler, köprülü bildirimlerinizin eşzamansız bildirimlerle çalışmasını sağlamaya yardımcı olur:
- Telefonda bir bildirimi iptal ederseniz saatteki ilgili bildirimin iptal edilmesi biraz zaman alabilir. Bu süre zarfında kullanıcı, bildirimdeki beklemede olan intent'lerden birini gönderebilir. Bu nedenle, uygulamanızda iptal edilen bildirimlerden beklemede olan intent'leri almaya devam edin: Bildirimleri iptal ederken bu bildirimlerin beklemede olan intent alıcılarını geçerli tutun.
- Tüm bildirim yığınını aynı anda iptal edip yeniden tetiklemeyin. Yalnızca gerçekten değiştirilmiş olan bildirimleri değiştirin veya kaldırın. Bu sayede, giyilebilir cihazın güncellenmesindeki gecikme önlenir ve uygulamanızın pil ömrü üzerindeki etkisi azaltılır.
Tasarım konusunda dikkat edilmesi gerekenler
Wear OS bildirimlerinin kendi tasarım yönergeleri vardır. Daha fazla bilgi için Wear OS Tasarım Kuralları'na bakın.