Bildirimler için köprü seçenekleri

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:

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.