گزینه‌های پل‌سازی برای اعلان‌ها

به‌طور پیش‌فرض، سیستم اعلان‌ها را از برنامه تلفن به هر ساعت جفت‌شده‌ای پل می‌زند یا هم‌رسانی می‌کند. اگر برنامه ساعت بسازید و برنامه‌تان در تلفن جفت‌شده نیز وجود داشته باشد، ممکن است کاربران اعلان‌های تکراری دریافت کنند—یکی که برنامه تلفن تولید و پل می‌کند و دیگری که برنامه ساعت تولید می‌کند. ‫Wear OS شامل ویژگی‌هایی برای کنترل نحوه و زمان پل زدن اعلان‌ها است.

اجتناب از اعلان‌های تکراری

وقتی اعلان‌ها را از منبعی خارجی، مثلاً از Firebase Cloud Messaging، ایجاد می‌کنید، برنامه تلفن و برنامه ساعت شما می‌توانند هرکدام اعلان‌های خودشان را در ساعت نمایش دهند. برای جلوگیری از تکرار، پل زدن را به‌صورت برنامه‌نویسی‌شده در برنامه ساعتتان غیرفعال کنید.

استفاده از برچسب‌های پل

برای پل زدن برخی‌از اعلان‌هایی که برنامه تلفن شما برای ساعت ایجاد می‌کند وقتی برنامه ساعت شما نصب شده است، برچسب‌های پل را تنظیم کنید.

بااستفاده از روش setBridgeTag(String) برچسب پل را روی اعلان تنظیم کنید، همان‌طور که در نمونه کد زیر نشان داده شده است:

val notification = NotificationCompat.Builder(context, channelId)
    // ... set other fields ...
    .extend(
        NotificationCompat.WearableExtender()
            .setBridgeTag("tagOne")
    )
    .build()

غیرفعال کردن پل زدن

می‌توانید پل‌سازی را برای برخی‌از اعلان‌ها یا همه اعلان‌ها غیرفعال کنید. توصیه می‌کنیم پل‌سازی را به‌صورت انتخابی غیرفعال کنید.

غیرفعال کردن پل‌سازی فقط برای برخی‌از اعلان‌ها

می‌توانید پل زدن را به‌طور پویا غیرفعال کنید و، به‌طور اختیاری، به برخی اعلان‌ها براساس برچسبشان اجازه عبور دهید. برای مثال، برای غیرفعال کردن پل‌زنی برای همه اعلان‌ها به‌جز آن‌هایی که با tagOne، tagTwo، یا tagThree برچسب‌گذاری شده‌اند، از شیء BridgingConfig استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است:

// 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()
)

غیرفعال کردن پل‌سازی برای همه اعلان‌ها (توصیه نمی‌شود)

برای جلوگیری از پل زدن همه اعلان‌ها از برنامه تلفن، از ورودی <meta-data> در فایل مانیفست برنامه ساعت استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است:

<!-- 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" />

تنظیم شناسه بستن برای همگام‌سازی اعلان‌های مشابه

وقتی بااستفاده از ویژگی حالت پل زدن از پل زدن جلوگیری می‌کنید، بستن اعلان‌ها در دستگاه‌های کاربر همگام‌سازی نمی‌شود.

بااین‌حال، اگر اعلان‌های مشابهی هم در تلفن و هم در ساعت ایجاد شود، می‌خواهید وقتی کاربر یکی از آن‌ها را می‌بندد، هر دو اعلان بسته شوند.

در NotificationCompat.WearableExtender، می‌توانید شناسه یکتای سراسری تنظیم کنید تا وقتی کاربر اعلانی را می‌بندد، دیگر اعلان‌های دارای همان شناسه در ساعت‌های جفت‌شده نیز بسته شوند.

کلاس NotificationCompat.WearableExtender روش‌هایی دارد که به شما امکان می‌دهد از شناسه‌های رد کردن استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است:

وقتی کاربر اعلان را می‌بندد، همه اعلان‌های دیگر با همان شناسه بستن در ساعت و تلفن بسته می‌شوند. برای بازیابی شناسه بستن، از getDismissalId() استفاده کنید.

در مثال زیر، شناسه یکتای جهانی برای اعلان جدیدی مشخص شده است، بنابراین بستن‌ها همگام‌سازی می‌شوند:

val notification = NotificationCompat.Builder(context, channelId)
    // ... set other fields ...
    .extend(
        NotificationCompat.WearableExtender()
            .setDismissalId("abc123")
    )
    .build()

اعلان‌های فقط محلی

برای جلوگیری از اعلان‌های تکراری، می‌توانید از setLocalOnly() نیز استفاده کنید تا اعلان‌ها را در تلفن محلی کنید.

بااین‌حال، فقط درصورتی از این روش استفاده کنید که اعلان باید فقط در دستگاهی که آن را ایجاد کرده است نشان داده شود. این شامل نه‌تنها دستگاه‌های Wear OS، بلکه سایر پوشیدنی‌ها و هر دستگاه متصل دیگری می‌شود. اعلان فقط محلی، حتی اگر برنامه‌تان در ساعت نصب نشده باشد، پل نمی‌زند.

هنگام ساختن برنامه Wear OS و تلفن که هر دو اعلان ایجاد می‌کنند، از این رویکرد برای جلوگیری از اعلان‌های تکراری استفاده نکنید. به‌جای آن، از گزینه‌های پل زدن استفاده کنید.

برای مثال، وقتی کاربر فایلی را در تلفن بارگیری می‌کند و اعلان نشان می‌دهد که بارگیری تکمیل شده است، از اعلان فقط محلی استفاده کنید.

وقتی اعلان‌ها پل‌سازی نشده باشند

سیستم انواع اعلان‌های زیر را پل نمی‌کند:

ملاحظات پیاده‌سازی برای اعلان‌های پل‌شده

ارسال یا برداشتن اعلان‌های پل‌شده از دستگاه پوشیدنی زمان می‌برد. هنگام طراحی اعلان‌ها، از رفتارهای غیرمنتظره ناشی از این تأخیر اجتناب کنید. رهنمودهای زیر کمک می‌کند مطمئن شوید اعلان‌های پل‌شده شما با اعلان‌های ناهمگام کار می‌کنند:

  • اگر اعلانی را در تلفن لغو کنید، ممکن است مدتی طول بکشد تا اعلان مربوطه در ساعت لغو شود. در این مدت، کاربر ممکن است یکی از قصدهای معوق را در آن اعلان ارسال کند. به همین دلیل، به دریافت قصد معوق در برنامه‌تان از اعلان‌هایی که لغو کرده است ادامه دهید: هنگام لغو اعلان‌ها، گیرندگان قصد معوق آن اعلان‌ها را معتبر نگه دارید.
  • کل پشته اعلان‌ها را به‌طور هم‌زمان لغو و دوباره راه‌اندازی نکنید. فقط اعلان‌هایی را که واقعاً اصلاح شده‌اند اصلاح یا حذف کنید. این کار از تأخیر در به‌روزرسانی دستگاه پوشیدنی جلوگیری می‌کند و تأثیر برنامه‌تان را بر عمر باتری کاهش می‌دهد.

ملاحظات طراحی

اعلان‌های Wear OS دستورالعمل‌های طراحی خاص خود را دارند. برای اطلاعات بیشتر، دستورالعمل‌های طراحی Wear OS را ببینید.