การปฏิเสธฝ่ามือที่ใช้สไตลัส

ไอคอนการให้ดาว 5 ดวง

สไตลัสเป็นเครื่องมือที่ช่วยให้ทำงานและสร้างสรรค์ได้อย่างมีประสิทธิภาพเป็นพิเศษ แต่เมื่อผู้ใช้วาด เขียน หรือโต้ตอบกับแอปโดยใช้สไตลัส บางครั้งผู้ใช้จะสัมผัสหน้าจอด้วยฝ่ามือ ระบบอาจรายงานการโต้ตอบแบบสัมผัสไปยังแอปของคุณก่อนที่ระบบจะจดจำและปิดเหตุการณ์ดังกล่าวเนื่องจากเป็นการสัมผัสด้วยฝ่ามือโดยไม่ตั้งใจ

แนวทางปฏิบัติแนะนำ

แอปของคุณต้องระบุการโต้ตอบแบบสัมผัสที่ไม่เกี่ยวข้องและละเว้นการโต้ตอบเหล่านั้น ใน Jetpack Compose คุณสามารถเข้าถึง MotionEvent ของ Android ที่สำคัญได้จาก PointerEvent ตรวจสอบ MotionEvent เพื่อหา ACTION_CANCEL ซึ่งบ่งชี้ว่าควรหยุดท่าทางสัมผัสและอาจต้องย้อนกลับ ใน Android 13 (ระดับ API 33) ขึ้นไป ให้ตรวจสอบแฟล็ก FLAG_CANCELED ในเหตุการณ์ ACTION_CANCEL และ ACTION_POINTER_UP ซึ่งเป็นสัญญาณที่ชัดเจนว่าการแตะไม่ได้เกิดจากความตั้งใจ เช่น การแตะด้วยฝ่ามือ

ส่วนผสม

  • Modifier.pointerInput(): ตัวแก้ไข Compose ที่ใช้ประมวลผลอินพุตเคอร์เซอร์
  • PointerEvent: แสดงถึงเหตุการณ์ตัวชี้ใน Compose ซึ่งมีการเปลี่ยนแปลงอย่างน้อย 1 รายการ
  • PointerEvent.motionEvent: พร็อพเพอร์ตี้ส่วนขยายที่ให้สิทธิ์เข้าถึง MotionEvent ของ Android ที่เกี่ยวข้อง (เป็นค่า Null ได้)
  • 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 เพื่อประมวลผลอินพุตเคอร์เซอร์ใน Composable ภายในขอบเขตอินพุตเคอร์เซอร์ ให้ใช้ 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 ทุกระดับ

แหล่งข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมได้ที่หัวข้อต่อไปนี้