يمكن أن يكون قلم الشاشة أداة إنتاجية وإبداعية بشكل استثنائي. ولكن عندما يرسم المستخدمون أو يكتبون أو يتفاعلون مع تطبيق باستخدام قلم الشاشة، فإنهم يلمسون الشاشة أحيانًا براحة أيديهم. يمكن إبلاغ تطبيقك بحدث اللمس قبل أن يتعرّف النظام على الحدث ويرفضه باعتباره لمسة غير مقصودة براحة اليد.
أفضل الممارسات
يجب أن يحدّد تطبيقك أحداث اللمس غير الضرورية ويتجاهلها. في 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: سمة الإضافة التي تتيح الوصول إلىMotionEventAndroid الأساسي (يمكن أن تكون فارغة).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 ومستويات واجهة برمجة التطبيقات الأعلى، وفي أحداث المؤشر الواحد على جميع مستويات واجهة برمجة التطبيقات.
مراجع إضافية
لمزيد من المعلومات، يُرجى الاطّلاع على ما يلي:
- ميزات Android 13 وواجهات برمجة التطبيقات: تحسين ميزة "تجاهُل لمس راحة اليد"
- أدلّة المطوّرين
- ميزات قلم الشاشة المتقدّمة
- قسم تجاهل لمس راحة اليد في مقالة توافق الإدخال على الشاشات الكبيرة
- درس تطبيقي حول الترميز: تحسين إمكانية استخدام قلم الشاشة في تطبيق Android