رفض راحة اليد بقلم الشاشة

رمز تقييم بخمس نجوم

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

أفضل الممارسات

يجب أن يحدّد تطبيقك أحداث اللمس غير الضرورية ويتجاهلها. في Jetpack Compose، يمكنك الوصول إلى MotionEvent الأساسي في Android من PointerEvent. تحقَّق من MotionEvent بحثًا عن ACTION_CANCEL، ما يشير إلى أنّه يجب إيقاف الإيماءة وقد يلزم التراجع عنها. في الإصدار 13 من نظام التشغيل Android (المستوى 33 لواجهة برمجة التطبيقات) والإصدارات الأحدث، ابحث عن العلامة FLAG_CANCELED في الحدثَين ACTION_CANCEL وACTION_POINTER_UP، ما يوفّر إشارة قوية إلى أنّ اللمسة كانت غير مقصودة، مثل لمسة راحة اليد.

المكوّنات

  • Modifier.pointerInput(): معدِّل Compose المستخدَم لمعالجة إدخال المؤشر
  • ‫PointerEvent: يمثّل حدث مؤشر في Compose يحتوي على تغيير واحد أو أكثر.
  • PointerEvent.motionEvent: سمة الإضافة التي تتيح الوصول إلى MotionEvent Android الأساسي (يمكن أن تكون فارغة).
  • MotionEvent: يمثّل أحداث اللمس والحركة. يحتوي على المعلومات اللازمة لتحديد ما إذا كان يجب تجاهل حدث ما.
  • ‫ACTION_CANCEL: ثابت MotionEvent يشير إلى أنّه تم إلغاء إيماءة، ويجب إيقافها وقد يلزم التراجع عنها.
  • ACTION_POINTER_UP: MotionEvent ثابت يشير إلى أنّ مؤشرًا غير المؤشر الأول قد ارتفع (أي أنّه لم يعُد يلمس شاشة الجهاز).
  • FLAG_CANCELED: ثابت MotionEvent يشير إلى أنّ المؤشر الذي يرتفع للأعلى تسبّب في حدث لمس غير مقصود. تمت إضافتها إلى الحدثَين ACTION_POINTER_UP وACTION_CANCEL على الإصدار 13 من نظام التشغيل Android (المستوى 33 لواجهة برمجة التطبيقات) والإصدارات الأحدث.

الخطوات

افحص كائنات MotionEvent التي تم إرسالها إلى تطبيقك. استخدِم واجهات برمجة تطبيقات MotionEvent لتحديد خصائص الحدث:

  • أحداث المؤشر الواحد: تحقَّق من ACTION_CANCEL، ما يشير إلى ضرورة إيقاف الإيماءة. على نظام التشغيل Android 13 والإصدارات الأحدث، يمكنك أيضًا التحقّق من FLAG_CANCELED للتأكّد من أنّ اللمسة كانت غير مقصودة.
  • أحداث المؤشرات المتعددة: في الإصدار 13 من نظام التشغيل Android والإصدارات الأحدث، يمكنك التحقّق من ACTION_POINTER_UP وFLAG_CANCELED لتحديد اللمسات غير المقصودة.

يمكنك الاستجابة لهذه الأحداث عن طريق إيقاف الإيماءة والتراجع عن أي تغييرات مؤقتة.

1. الحصول على عناصر أحداث الحركة

استخدِم Modifier.pointerInput لمعالجة إدخال المؤشر في دالة مركّبة. ضمن نطاق إدخال المؤشر، استخدِم awaitPointerEventScope وawaitPointerEvent لتلقّي الأحداث واسترداد MotionEvent الأساسي في Android باستخدام السمة motionEvent:

import androidx.compose.ui.input.pointer.pointerInput
    Box(
        modifier = Modifier
            .fillMaxSize()
            .pointerInput(Unit) {
                awaitPointerEventScope {
                    while (true) {
                        val event = awaitPointerEvent()
                        val motionEvent = event.motionEvent
                        if (motionEvent != null) {
                            // Process motion event.
                        }
                    }
                }
            }
    )

2. تحديد إجراء الحدث والعلامات

تحقَّق من MotionEvent بحثًا عن ACTION_CANCEL، والذي يشير إلى حدث بمؤشر واحد على جميع مستويات واجهة برمجة التطبيقات. على Android 13 والإصدارات الأحدث، يُرجى التحقّق من ACTION_POINTER_UP لـ "FLAG_CANCELED":

import androidx.compose.ui.input.pointer.pointerInput
    Box(
        modifier = Modifier
            .fillMaxSize()
            .pointerInput(Unit) {
                awaitPointerEventScope {
                    while (true) {
                        val event = awaitPointerEvent()
                        val motionEvent = event.motionEvent ?: continue

                        when (motionEvent.actionMasked) {
                            MotionEvent.ACTION_CANCEL -> {
                                // Process canceled single-pointer motion event for all SDK versions.
                            }
                            MotionEvent.ACTION_POINTER_UP -> {
                                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU &&
                                    (motionEvent.flags and MotionEvent.FLAG_CANCELED) == MotionEvent.FLAG_CANCELED
                                ) {
                                    // Process canceled multi-pointer motion event for Android 13 and higher.
                                }
                            }
                        }
                    }
                }
            }
    )

3- التراجع عن الإيماءة

بعد تحديد لمسة راحة اليد، يمكنك التراجع عن تأثيرات الإيماءة التي تظهر على الشاشة.

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

النتائج

يمكن لتطبيقك الآن تحديد لمسات راحة اليد ورفضها في أحداث المؤشرات المتعددة على Android 13 ومستويات واجهة برمجة التطبيقات الأعلى، وفي أحداث المؤشر الواحد على جميع مستويات واجهة برمجة التطبيقات.

مراجع إضافية

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