خيارات بمجموعة إعدادات الإشعارات

يرسل النظام تلقائيًا الإشعارات من تطبيق الهاتف إلى أي ساعات مقترنة أو يشاركها معها. إذا أنشأت تطبيقًا لساعة ذكية وكان هذا التطبيق متوفّرًا أيضًا على هاتف مقترن، قد يتلقّى المستخدمون إشعارات مكرّرة، أحدها ينشئه تطبيق الهاتف وينقله، والآخر ينشئه تطبيق الساعة الذكية. يتضمّن Wear OS ميزات للتحكّم في كيفية نقل الإشعارات ووقت نقلها.

تجنُّب الإشعارات المكرّرة

عند إنشاء إشعارات من مصدر خارجي، مثل مراسلة Firebase السحابية، يمكن لكل من تطبيق الهاتف وتطبيق الساعة الذكية عرض الإشعارات الخاصة بهما على الساعة. لتجنُّب التكرار، يمكنك إيقاف ميزة الربط برمجيًا في تطبيق الساعة الذكية.

استخدام علامات الربط

لربط بعض الإشعارات التي ينشئها تطبيق الهاتف بالساعة عند تثبيت تطبيق ساعة ذكية، اضبط علامات الربط.

يمكنك ضبط علامة ربط على إشعار باستخدام الإجراء 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().

In the following example, a globally unique ID is specified for a new notification, so dismissals are synced:

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

الإشعارات المحلية فقط

لتجنُّب الإشعارات المكرّرة، يمكنك أيضًا استخدام setLocalOnly() لجعل الإشعارات محلية على الهاتف.

ومع ذلك، لا تستخدِم هذه الطريقة إلا إذا كان يجب أن يظهر الإشعار فقط على الجهاز الذي أنشأه. ويشمل ذلك أجهزة Wear OS والأجهزة الأخرى القابلة للارتداء وأي أجهزة متصلة أخرى. لا يتم نقل الإشعارات المحلية فقط، حتى إذا لم يكن تطبيقك مثبّتًا على الساعة.

عند إنشاء تطبيق Wear OS وتطبيق هاتف يُنشئان إشعارات، لا تستخدِم هذا الأسلوب لتجنُّب تكرار الإشعارات. بدلاً من ذلك، استخدِم خيارات الربط.

على سبيل المثال، يمكنك استخدام إشعار محلي فقط عندما ينزّل مستخدم ملفًا على هاتف ويشير الإشعار إلى اكتمال عملية التنزيل.

عندما لا يتم ربط الإشعارات

لا يربط النظام بين أنواع الإشعارات التالية:

اعتبارات التنفيذ للإشعارات المتبادلة

يستغرق إرسال الإشعارات المجمّعة أو إزالتها من جهاز قابل للارتداء بعض الوقت. عند تصميم الإشعارات، تجنَّب السلوك غير المتوقّع الناتج عن وقت الاستجابة هذا. تساعد الإرشادات التالية في ضمان عمل الإشعارات المجمّعة مع الإشعارات غير المتزامنة:

  • إذا ألغيت إشعارًا على الهاتف، قد يستغرق إلغاء الإشعار المقابل على الساعة بعض الوقت. خلال هذه الفترة، قد يرسل المستخدم أحد الطلبات المؤجّلة في هذا الإشعار. لهذا السبب، يجب مواصلة تلقّي intent مؤجّلة في تطبيقك من الإشعارات التي تم إلغاؤها: عند إلغاء الإشعارات، يجب إبقاء مستقبِلات intent المؤجّلة لهذه الإشعارات صالحة.
  • لا تلغِ مجموعة كاملة من الإشعارات وتعيد تشغيلها في وقت واحد. يجب تعديل أو إزالة الإشعارات التي تم تعديلها فعليًا فقط. يؤدي ذلك إلى تجنُّب وقت الاستجابة عند تحديث الجهاز القابل للارتداء ويقلّل من تأثير تطبيقك في عمر البطارية.

اعتبارات التصميم

تتضمّن إشعارات Wear OS إرشادات تصميم خاصة بها. لمزيد من المعلومات، يُرجى الاطّلاع على إرشادات تصميم Wear OS.