דחייה של כף היד בסטיילוס

סמל של דירוג כוכבים

סטיילוס יכול להיות כלי פרודוקטיבי ויצירתי במיוחד. אבל כשמשתמשים מציירים, כותבים או מבצעים פעולות באפליקציה באמצעות סטיילוס, לפעמים הם נוגעים במסך עם כף היד. אירוע המגע יכול להיות מדווח לאפליקציה לפני שהמערכת מזהה את האירוע ומבטלת אותו כנגיעה מקרית בכף היד.

שיטות מומלצות

האפליקציה צריכה לזהות אירועי מגע לא רלוונטיים ולהתעלם מהם. ב-Jetpack Compose, אפשר לגשת ל-MotionEvent הבסיסי של Android מ-PointerEvent. בודקים את MotionEvent עבור ACTION_CANCEL, שמציין שצריך להפסיק את התנועה ויכול להיות שצריך לבטל אותה. ב-Android 13 (רמת API ‏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 ב-Android מגרסה 13 (רמת API‏ 33) ואילך.

צעדים

בודקים את האובייקטים מסוג MotionEvent שנשלחו לאפליקציה. משתמשים בממשקי ה-API של MotionEvent כדי לקבוע את מאפייני האירוע:

  • אירועים של מצביע יחיד – בודקים אם יש ACTION_CANCEL, שמציין שהתנועה צריכה להיפסק. ב-Android מגרסה 13 ואילך, צריך לבדוק גם את FLAG_CANCELED כדי לוודא שהנגיעה הייתה לא מכוונת.
  • אירועים עם כמה מצביעים – ב-Android מגרסה 13 ואילך, צריך לבדוק את 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, שמציין אירוע של מצביע יחיד בכל רמות ה-API. ב-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. ביטול התנועה

אחרי שמזהים נגיעה בכף היד, אפשר לבטל את ההשפעות של התנועה על המסך.

האפליקציה צריכה לשמור היסטוריה של פעולות המשתמשים כדי שיהיה אפשר לבטל קלט לא מכוון, כמו נגיעות בכף היד. דוגמה לכך מופיעה בקטע הטמעה של אפליקציית ציור בסיסית ב-Codelab בנושא שיפור התמיכה בסטיילוס באפליקציית Android.

תוצאות

האפליקציה יכולה עכשיו לזהות ולדחות נגיעות בכף היד באירועים עם כמה מצביעים ב-Android 13 וברמות API גבוהות יותר, ובאירועים עם מצביע אחד בכל רמות ה-API.

מקורות מידע נוספים

למידע נוסף, קראו את המאמרים הבאים: