التعامل مع النقرات في خلفيات شاشة الساعة

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

لتنفيذ خلفية شاشة ساعة تفاعلية، يجب أولاً إنشاء نمط خلفية شاشة الساعة، ثم تنفيذ التعامل بالإيماءات كما هو موضّح في هذا الدليل.

التعامل مع أحداث النقر

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

للتعامل مع إيماءات النقر، استخدِم setTapListener() لإضافة TapListener. يتم استدعاء المستمع عندما ينقر المستخدم على خلفية شاشة الساعة.

تتلقّى خلفية شاشة الساعة الأنواع التالية من أحداث اللمس:

  • TapType.DOWN: عندما يضع المستخدم إصبعه على الشاشة التي تعمل باللمس

  • TapType.UP: عندما يرفع المستخدم الإصبع عن الشاشة التي تعمل باللمس

  • TapType.CANCEL: عندما يرصد النظام أنّ المستخدم ينفّذ إيماءة أخرى غير النقر.

يتم التحقّق من حدث TapType.DOWN وحدث TapType.UP المتتالي باعتبارهما نقرة وفقًا للقيمة التي يعرضها android.view.ViewConfiguration.getScaledTouchSlop.

لا تفعِّل أي إجراء عندما تتلقّى خلفية شاشة الساعة حدث TapType.CANCEL، لأنّ النظام يعالج الإيماءة حاليًا.

لمزيد من المعلومات، يُرجى الاطّلاع على "onTapEvent".

يعرض نموذج تطبيق خلفية شاشة الساعة أفضل الممارسات لضبط خلفية شاشة الساعة.