الإشعارات على Wear OS

تستخدم الإشعارات على الساعات واجهات برمجة التطبيقات نفسها ولها بنية الإشعارات نفسها على الهواتف.

يمكن أن تظهر الإشعارات على الساعة بطريقتين:

  1. ينشئ التطبيق المتوافق مع الأجهزة الجوّالة إشعارًا ويعمل النظام تلقائيًا على نقل هذا الإشعار إلى الساعة.
  2. ينشئ تطبيق قابل للارتداء إشعارًا.

في كلتا السيناريوهين، استخدِم الصفح NotificationCompat.Builder لإنشاء إشعارات. عند إنشاء إشعارات باستخدام فئة أداة الإنشاء، يتولّى النظام عرض الإشعارات بشكل صحيح. على سبيل المثال، عند إصدار إشعار من تطبيقك المتوافق مع الأجهزة الجوّالة، يظهر كل إشعار كبطاقة في "ساحة مشاركات الإشعارات".

راجِع المثال التالي للاطّلاع على كيفية عرض الإشعارات. بطاقات الإشعارات

الشكل 1. الإشعار نفسه الذي يظهر على الهاتف والساعة.

استخدِم إحدى الفئات الفرعية NotificationCompat.Style للحصول على أفضل النتائج.

ملاحظة: يؤدي استخدام RemoteViews إلى إزالة إشعارات التنسيقات المخصّصة، ولن يعرض الجهاز القابل للارتداء سوى النص والرموز.

الإشعارات المقترَحة للأجهزة القابلة للارتداء

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

يمكنك إنشاء إشعار قابل للتوسيع بالطريقة نفسها التي تستخدمها على الأجهزة الجوّالة، وذلك باستخدام أي من فئات NotificationCompat.Style الفرعية. على سبيل المثال، يظهر الإشعار العادي الذي يستخدم NotificationCompat.MessagingStyle على النحو التالي: إشعار قابل للتوسيع

الشكل 2. مثال على إشعار "MessagingStyle" على نظام التشغيل Wear OS

يظهر في الإشعار أنّه يتضمّن إجراءات متعددة مكدسة في أسفل الحالة الموسّعة.

للحصول على أمثلة عن NotificationCompat.BigPictureStyle وNotificationCompat.BigTextStyle وNotificationCompat.InboxStyle وNotificationCompat.MessagingStyle، يمكنك الاطّلاع على نموذج الإشعار على GitHub.

ملاحظة: إذا تضمّنت إشعاراتك إجراء "الرد"، مثل تطبيق مراسلة، يمكنك تحسين طريقة عمل الإشعار. على سبيل المثال، يمكنك تفعيل ردود الإدخال الصوتي مباشرةً من الردود النصية القابلة للارتداء أو الردود النصية المحددة مسبقًا باستخدام setChoices(). لمزيد من المعلومات، يُرجى الاطّلاع على إضافة زر الرد.

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

يتم تلقائيًا إرسال الإشعارات من تطبيق الهاتف المقترن إلى أي ساعات مقترنة. وهذا خيار رائع إذا لم يكن لديك تطبيق قابل للارتداء مثبّت.

في المقابل، إذا أنشأت تطبيق ساعة مستقلاً وتطبيقًا آخر للهاتف المصاحب، ستنشئ التطبيقات إشعارات مكرّرة.

يوفّر نظام التشغيل Wear OS طريقة لإيقاف الإشعارات المكرَّرة من خلال واجهات برمجة التطبيقات Bridge API. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على خيارات وضع حدود للإشعارات.

إضافة ميزات خاصة بالأجهزة القابلة للارتداء إلى إشعار

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

  1. إنشاء نسخة افتراضية من WearableExtender، مع ضبط الخيارات الخاصة بالأجهزة القابلة للارتداء للإشعار.
  2. أنشِئ مثيلاً للسمة NotificationCompat.Builder، مع ضبط السمات المطلوبة لإشعارك كما هو موضّح سابقًا في هذا الدليل.
  3. عليك الاتصال بـ extend() على الإشعار واجتياز WearableExtender. يؤدي هذا إلى تطبيق خيارات الأجهزة القابلة للارتداء على الإشعار.
  4. يمكنك الاتصال بـ build() لإنشاء الإشعار.

ملاحظة: إذا كنت تستخدم NotificationManager لإطار العمل، لن تعمل بعض الميزات من NotificationCompat.WearableExtender، لذا احرص على استخدام NotificationCompat.

يمكنك مزامنة عمليات إغلاق الإشعارات أو إلغائها على أجهزة المستخدم. لمزامنة عملية إغلاق، استخدِم طريقة setDismissalId(). بالنسبة إلى كل إشعار، أدخِل معرّفًا فريدًا عالميًا كسلسلة عند طلب setDismissalId(). عند إغلاق الإشعار، يتم إغلاق جميع الإشعارات الأخرى التي تحمل رقم تعريف الإغلاق نفسه على الساعة وعلى الهاتف المقترن. لاسترداد رقم تعريف الرفض، استخدِم getDismissalId().

تحديد إجراءات الأجهزة القابلة للارتداء فقط

إذا أردت توفير إجراءات مختلفة على الساعة والهاتف، استخدِم WearableExtender.addAction(). بعد إضافة إجراء بهذه الطريقة، لن يعرض الجهاز القابل للارتداء أي إجراءات أخرى تمت إضافتها باستخدام NotificationCompat.Builder.addAction(). تظهر الإجراءات التي تمت إضافتها باستخدام WearableExtender.addAction() على الجهاز القابل للارتداء فقط، وليس على الهاتف.